24/7 Support: 800.608.6482

Get Started

How To Guides

How To Guides


1. How To Install

2. Payment Settings

3. Checkout Process

4. View Orders

5. Using PayPal & Braintree

6. Partial Refunds

7. Capturing Outside of Miva

8. Kount Fraud Protection

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.

Payment Settings

Payment Settings:

You’ll now see a “Braintree” tab, click on it.

Enter your Merchant ID, Public Key, Private Key and then confirm your Private Key and click the “Update” button. This info will be provided to you when you sign up for Braintree. Keep in mind, after you hit the update button, the Private Key box will appear blank, even though the key was saved. This is intended behavior.

If you check the “Automatically Submit Transactions for Settlement” box it will do both 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.

Brain Tree Settings

Once you install the module, you’ll see under the “Payment Method Rules” tab the four Braintree payment options (AE, Discover, MC, Visa).

Payment Method Rules

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.

Braintree JSv3 UI

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.

Order Info

From this screen you can Authorize another payment.


You can also refund the order from this screen.


Using PayPal & Braintree

While it is possible to link PayPal to your Braintree account so you can accept both payment methods, it is not currently supported with this integration. If you would also like to use PayPal along side Braintree you will need to setup PayPal using the Express Checkout Module. Setup instructions for PayPal Express Checkout can be found here.

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 recommend 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.

Kount Fraud Protection

Kount Faud Protection comes included with Braintree Integration. To turn it on or off, click on "Payment Settings" and then click on the "Braintree" Tab. Scroll down to the bottom where you will see the "Kount Integration" section.


There are two versions of Kount Fraud Protection:

  1. Standard Account
  2. “Kount

    The Standard is free and included in all Braintree accounts. It does not require an account with Kount, nor is there anything to set up, everything is preset at the order level. 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

  3. Custom Account
  4. “Kount

    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:

    • 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)

    To learn more about those, please click here.

    Order Level Risk Decision


Need Additional Help?

Additional Braintree resources can be found at: https://articles.braintreepayments.com/

Braintree JSv3 User Interface

As of Miva 9.12 (released 10/30/18) we now support the JavaScript v3 User Interface for Braintree.

Braintree JSv3 UI

Upon running updates you're 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.

Looking for Developer Docs?

We have a whole section for that, including: Developer Training Series, Template Language docs, Module Development tutorials and much, much more.

Head to the Developer Section

This website uses cookies to identify visitors, track visitors to our website, store login session information and to remember your user preferences. By continuing to use this site you agree to our use of cookies. Learn More.

This website uses cookies. By continuing to use this site you agree to our use of cookies. Learn More.


Copyright © 1997 – 2019 Miva©, Miva Merchant©, MivaPay©, MivaCon© Miva, Inc. All Rights Reserved.