If you are already using Braintree, you can benefit from Bolt’s optimized checkout and conversion-focused fraud models without having to change your payment processor.
Bolt will not affect your setup or relationship with Braintree. You will keep your existing Braintree account, dashboard, and pricing. Additionally, you will continue using the Braintree dashboard for operations related to payments. Furthermore, any custom tooling built on Braintree’s APIs will continue to work. Payments integrations will remain in place. The transaction data flow will be unaffected so that you can keep your existing ERP/accounting/fulfillment setups. Braintree as a payment processor is available on all ecommerce platforms supported by Bolt.
- Getting Started
- Braintree in the Merchant Dashboard
- Payments Capabilities
- Braintree Account Setup
You’ll work with Bolt’s sales team to sign a contract and manage the technical integration.
The following steps are necessary to get started:
- Contact firstname.lastname@example.org and ask them to set up an account.
- Bolt will initiate your account creation and your Braintree integration.
- Bolt will enter your initial Braintree API credentials into the Bolt Merchant Dashboard.
Bolt requires specific information to set up your account.
Before contacting Bolt, gather the following information:
- Business Name
- Company's Customer Service Phone Number
- Company’s Customer Service Email
- Website URL
- Time Zone
- Support Email
- Support Phone
- If the merchant has agreed to direct debit:
- Company name registered with Bank
- Bank Branch Name
- Bank Routing Number
- Bank Account Number
Braintree Implementation Time
The Braintree implementation timeline will vary by merchant. You can expect the average time to be 2-4 weeks. Factors include the speed of communication between you and Bolt and the complexity of your account. Bolt’s Success team can offer timeline estimates for each merchant.
Braintree in the Merchant Dashboard
As a Merchant using Braintree, you will see a modified version of the Bolt Merchant Dashboard. These changes occur because Bolt will not handle payment processing. The following descriptions show how a Braintree implementation will vary from the payment processing version as it is described elsewhere within Bolt documentation.
The modified top section of the Overview page will not show payment processing information, Unsettled Balance, Settled Balance, and In Progress Transfer.
The modified version of the Transactions page will not display payment processing information, and will not provide some payment processing functions.
When using Braintree, you will not be able to see:
- Transaction details
When using Braintree, you will not be able to perform:
- Multi-capture — Perform multiple captures for one order.
- Recharge — Charges the card for a newly entered amount.
- Downloads — Daily Bank Transfer CSVs or Monthly Statement CSVs.
The Virtual Terminal, in the Bolt Merchant Dashboard, allows back-office processing. If a customer asks you to take their credit card information over the phone, you can input all of that payment information through the Virtual Terminal (instead of through Braintree). If you input the information through Braintree, which you can, then Bolt won’t be able to see that transaction or include it in reports. Choose the method that best suits your accounting practices.
Keys + New Merchant Accounts
You can view your Braintree Public and Private encryption keys in the Bolt Merchant Dashboard under Settings > Keys and URLs.
To use any additional settlement and representment currencies, Braintree requires supplemental ‘Merchant Accounts.’ Braintree merchants can add more Braintree merchant account IDs and currencies in the Bolt Merchant Dashboard under Settings > Keys and URLs.
To add a Braintree Merchant Account:
- Open your Bolt Merchant Dashboard.
- Go to the Settings tab and select Keys and URLs.
- Navigate to the Braintree Keys.
- Click the Add Braintree Merchant Account button.
- The Add new Braintree merchant account dialog box will open.
- Enter the Account ID and Currency Code.
- Click the Submit button
- The Merchant ID will appear below the keys.
Transactions can be updated via the Braintree Dashboard or directly via the API for merchants. Bolt will not pull updates that happen on Braintree’s side, so transactions may not show the proper status in the Bolt Merchant Dashboard. For this reason, it is considered best practice to treat Braintree as the source-of-truth for all payment processing information. Note this limitation for the proper correlation of data with your accounting processes.
Bolt will support the following payment functions:
- Authorize (At checkout and on micro-authorization)
- Capture (After approval)
- Void (After rejection)
When Bolt authorizes a card, we will capture the following data:
- CVV Response
- AVS Response
- Decline Reason
Braintree authorizations automatically expire depending on the type of card. This expiration will behave and will display as if you have voided the transaction in either the Bolt Merchant Dashboard or the Braintree Dashboard. Bolt will apply this categorization when it identifies the update during the transaction syncing process. The sync process aligns the transaction data between Bolt and Braintree.
You will need to know if transactions are in review to ensure you don’t capture and ship the product during the fraud review. Bolt will determine how it will handle passing this information on a merchant-by-merchant basis.
Metadata Passed to Braintree
Bolt will transfer the following metadata to Braintree so that the merchant has context on a given transaction:
- Order ID — Order reference from the cart software when available.
- Bolt Transaction Reference — Bolt’s transaction reference ID.
For the proper receipt of Chargeback Data, Bolt will directly integrate with Braintree to ingest disputes.
As part of the onboarding process, you will set a 'Webhook URL' from the Braintree Dashboard, so whenever a chargeback occurs, Braintree notifies the Bolt server.
Liability will be programmatically determined depending on the 'reason field' of the dispute. If the reason is 'fraud' or 'not_recognized,' the transaction will show as Bolt-liable. All other transactions will show as merchant-liable. No credit is automatically given to you, even if the dispute is Bolt-liable. When Bolt issues an invoice to you, Bolt will calculate the amount of all closed fraud disputes.
No money movement will occur within Bolt's internal ledger service outside of transaction processing. So, at the end of each month, there will be a balance that you owe Bolt (Bolt Fees minus Credits for Indemnified Chargebacks). Bolt will zero out this balance monthly in the ledger.
At the end of each month, Bolt will calculate the Bolt Fee and the Credits for Indemnified Chargebacks and send the merchant's Accounts Payable(AP) team an invoice PDF. The invoice will include:
- General Information
- Bolt Name / Address
- Merchant Name / Address
- Payment instructions
- Amount Due
- Bolt Fee amount
- Chargeback indemnification credit amount
- Total amount due
- Other Data
- Number of chargebacks indemnified
The merchant will pay the invoice based on the agreed-upon terms.
These terms will generally be either:
- Bolt will automatically debit you via ACH for the invoice amount.
- You will wire Bolt the money on 'Net 30' terms.
If Bolt ends up owing you money, for example, due to the chargeback indemnification being more than the Bolt fee, Bolt will transfer money to your bank account at the end of the month.
Bolt will not charge a fee for processing. Instead, Braintree will continue to charge you. Bolt will charge fees only for checkout and fraud.
Braintree Account Setup
The following section covers the process of setting up your Braintree account.
IP Blacklist Configuration
If you have IP blacklists turned on, please whitelist the below IP addresses following these instructions: Whitelisting IP Addresses in Braintree
IP Addresses to Whitelist:
Add Braintree Keys in the Bolt Merchant Dashboard
Follow these steps to Braintree keys:
- Go to Braintree https://www.braintreegateway.com/login (prod)
- Click the Gear icon on the top-right, then click API.
- Click Generate new API key.
- Once a key is generated, click View
- You will see the Merchant ID, Public Key, and Private Key.
- Use these three pieces of information to complete the next steps.
- Log in to the Bolt Merchant Dashboard at merchant.bolt.com.
- A dialog will appear and you will be prompted to enter the Merchant ID, Public Key, and Private Key..
- Enter the keys and click Submit.
Configure Braintree Webhook
This is needed so Bolt can be notified about any chargebacks.
Follow these steps to configure the Braintree webhook:
- Contact your Bolt CSM or Bolt Support for your unique Webhook URL.
- Go to the Braintree dashboard.
- Click Webhooks.
- Click Create new webhook.
- Configure the webhook
- Set the Destination URL to https://api.bolt.com/v1/webhooks/braintree/<USE THE LINK YOU OBTAINED IN STEP 1>
- Check Lost, Opened, and Won under the Dispute section and check Disbursement under the Disbursement section.
- Then scroll down and click Save.
- Find the newly created webhook URL and Click Check URL - You will see a success message.