How To Guides
Braintree
9. Braintree JSv3 User Interface
How To Install
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.
Module Settings:
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).
Checkout Process:
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.
View Orders:
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.
Using PayPal Checkout & Braintree
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.
Partial Refunds
Multiple Partial Refunds are supported. However, if the transaction hasn’t settled only the entire amount can be voided.
Capturing Outside of Miva
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.
Collecting Device Data
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:
- Log into the Control Panel
- Click on the gear icon in the top right corner
- Click Processing from the drop-down menu
- Scroll to the Fraud Tools section
- Next to Advanced Fraud Tools, click the toggle to turn it on
There are two versions of Kount Fraud Protection:
- Standard Account
- Custom Account
- Tailoring your rules to suit your unique business model
- Making your rules as aggressive or lenient as you need them to be
- Getting assistance with your rules from experts at Kount
- Leveraging the ability to review transactions and decide what course of action to take
- Blacklisting or whitelisting customers (e.g. by IP or email address)
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 Standard Risk Decisions:
| 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
Braintree 3D Secure
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:
- https://www.braintreepayments.com/blog/ready-for-3d-secure-2-0/
- https://www.braintreepayments.com/features/3d-secure
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.
3D Secure Settings
- Disabled - This is the default state. 3D Secure is turned off for all transactions
- Require if 3D Secure is Enabled on Card - This is the recommended state to enable 3D Secure. It will only Prompt for additional data if the card the customer is using has 3D Secure enabled.
- Always Require 3D Secure - Only use this state if you want all transactions to go through 3D Secure. Note: If this is on, and the customers card does not support 3D Secure, the transaction will be declined.
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
Braintree JSv3 User Interface
As of Miva 9.12 (released 10/30/18) we now support the JavaScript v3 User Interface for Braintree.
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.
Need Additional Help?
Additional Braintree resources can be found at: https://articles.braintreepayments.com/