9. Braintree JSv3 User Interface
Click on “Menu,” scroll down to “Payment Settings” and click on the “Add/Remove Modules” tab. Find the “Braintree” module and click the “Install” button.
You’ll now see a “Braintree” tab, click on it.
Server Name - This is the api endpoint for the Braintree API. Production: api.braintreegateway.com, Sandbox: api.sandbox.braintreegateway.com
Merchant ID - This is your Merchant ID for Braintree. It can be found in your Braintree Account, under Settings (Gear icon) -> API
Merchant Account ID - This is an optional field. Braintree has the ability to create multiple Merchant Account IDs under the main Merchant ID. Each Merchant Account ID can be mapped to its own currency within Braintree. This will be the settlement currency used on the account. Note: While Braintee does support multiple Merchant Account IDs, Miva only supports a single at this time. A future update will add support for more than one Merchant Account ID.
To create a new Merchant Account ID in Braintree go to Settings -> Business -> Add New Merchant Account ID
Public Key / Private Key - These API keys are required connect to the Braintree API. They can be found under: Settings -> API. Note: After you hit the update button, the Private Key box will appear blank, even though the key was saved. This is intended behavior.
Automatically Submit Transactions for Settlement - If you check the Automatically Submit Transactions for Settlement box Miva will do both an authorization + Capture when the order is placed. If you don’t check it, it will only do authorization on purchase. In order to settle/capture payment, you will need to edit the order in the Miva admin and click the Capture button when the order payment is ready to be captured.
Kount Fraud Data Collection - Enable or Disable Kount. See Kount Details Below
3D Secure - Enable or Disable 3D Secure for Transactions. See 3D Details Below
PayPal Currency - Sets the currency for PayPal Checkout (if using this option with Braintree)
Once you install the module, you’ll see under the “Payment Method Rules” tab the four Braintree payment options (AE, Discover, MC, Visa).
During checkout, your customer will be prompted with this payment screen to enter their credit card number. This screen uses Braintree’s hosted iframe so the credit card data never flows through your Miva Store.
To view the order click on “Menu,” then “Order Processing,” click on the order and then click on the “Edit” or the pencil tool. Here you can see the payment information that was captured.
From this screen you can Authorize another payment.
You can also refund the order from this screen.
It's possible to also accept Paypal Checkout when using Braintree. To enable this, set the PayPal Currency from the settings drop down and ensure the "PayPal" payment method is enabled as a valid payment method.
If you would also like to display the PayPal Checkout button on the basket screen you will need to setup PayPal Checkout using the PayPal Commerce Platform INtegration. Setup instructions for PayPal Express Checkout can be found here.
Multiple Partial Refunds are supported. However, if the transaction hasn’t settled only the entire amount can be voided.
If you authorize only on initial purchase, it is recommended you also capture/settle the transaction within Miva. This ensures Miva has the latest transaction information. If you instead capture/settle within Braintree, Miva will not see the updated settle information.
Braintree has built in Fraud tools which rely on collecting device data which gets passed in the payment request. To turn it on or off, click on "Payment Settings" and then click on the "Braintree" Tab. To enable it check the box for "Kount Fraud Data Collection". Note: You must first enable Kount in Braintree before you turn it on in Miva. If you do not have it enabled in your Braintree account, the Braintree Payment fields will fail to load on checkout.
To enable Kount in Braintree, follow these steps:
There are two versions of Kount Fraud Protection:
Braintree has two levels of fraud protection they support. The Standard version (Advanced Fraud Tools) is free and included in all Braintree accounts. It does not require an account with Kount. Once you enable it in Miva and in Braintree it will start collecting additional data and showing a fraud score with your orders. When your customers create a new transaction, Braintree will send the information to Kount. They'll analyze the transaction information using the predetermined rules, and – based on the results – the Braintree gateway will either accept or reject each request. You can learn more about the Standard version here.
|Kount Risk Decision||Braintree action|
|Approved||Always sends to the processor|
|Declined||Always gateway rejected|
|Review||Always sends to the processor|
|Escalate||Always sends to the processor|
|Not Evaluated||Sends to the processor by default|
For those merchants who wish to have greater control over their fraud checks, Kount offers a paid custom integration for that need.
Kount Custom is intended for merchants processing greater than 2500 transaction per month and has these additional benefits:
To learn more about those, please click here.
Order Level Risk Decision
Miva 9.14.00 adds support for 3D Secure via when using Braintree. If your new to 3D Secure, here are a few helpful resources:
Important: You must enable 3D Secure in your Braintree Account prior to enabling it in Miva. Failure to do so, will cause the payment fields not to show up during checkout. You need to contact Braintree to have then enable 3D Secure on your account. Also, 3D Secure only works for customer transactions on the front-end of the website. Any transaction place via the admin bypasses 3D Secure alltogether.
The Braintree integration supports the 3D Secure 2.0 protocol, which provides a streamlined experience for the customer. There are many transactions where the merchant bank does not need additional data from the customer and there is nothing more they need to enter. In some cases, the issuing bank will require customers to login into their bank. This prompt will be presented in a new popup window:
If 3D Secure is enabled, additional field will be saved with the Payment response in Miva. This fields are available via the JSON API as part of the payment record response.
Additional Braintree resources on 3D Secure can be found at: https://articles.braintreepayments.com/guides/fraud-tools/3d-secure
Upon running updates your checkout will automatically be updated to use the new User Interface. There is nothing you need to do manually. This UI will be available both in the Miva admin as well as the checkout process for customers.
Additional Braintree resources can be found at: https://articles.braintreepayments.com/