Set Up Bolt for Braintree


See Set Up Bolt One-Click for BigCommerce for instructions specific to this platform.


How to Integrate with Braintree

1. Add Bolt IPs to Allowlist List

Use Braintree’s Allowlist documentation to allow the following IPs:

  • 13.57.173.93
  • 18.236.33.230
  • 34.209.104.177
  • 52.36.152.150
  • 12.2.150.168/29
  • 12.249.26.128/30
  • 50.18.19.8

2. Obtain Braintree Keys

  1. Log in to the Braintree Production Console or Sandbox Console.
  2. Navigate to Settings > Business.
  3. Find the Merchant ID and copy for use in a later step.
  4. Navigate to Settings > API.
  5. Click Generate new API Key.
  6. Click View. It should provide the following keys:
    • Public Key
    • Private Key
  7. Copy these keys for use in a later step.

Multi-Current Merchants Only: Obtain Merchant Account ID

If your account includes several submerchant credentials to enable multi-currency support, you must also obtain your Braintree Merchant Account ID.

3. Add Braintree Keys to Bolt

  1. Open the Bolt Merchant Production Dashboard or Sandbox Dashboard in a separate tab.
  2. Navigate to Settings > Payments.
  3. Click Add Braintree.
  4. Add the following Braintree keys:
  • Merchant ID
  • Public Key
  • Private Key
  1. Click Add Braintree.

Multi-Current Merchants Only: Add Merchant Account ID

If your account includes several submerchant credentials to enable multi-currency support, you must provide your Braintree Merchant Account ID.

To do so, select Add Braintree Merchant Account and fill out the fields.

4. Configure Braintree Webhook

Webhooks keep your systems in sync, allowing Bolt and Braintree to easily exchange data about disputes or disbursements. Failure to set up webhooks will result in discrepancies between your systems.

  1. Log in to the Braintree Production Console or Braintree Sandbox Console.
  2. Navigate to Settings > API > Webhooks > Create new webhook.
  3. Configure the webhook. Find the following information from the Bolt Merchant Dashboard:
    • Destination URL: Navigate to Settings > Payments > Manage Braintree and copy the Bolt webhook URL.
    • Public ID: Navigate to Developers > Public ID. Replace <public-id> in the URL.
  4. Subscribe to the following event notifications:
    • Disputes: Enable Lost, Opened, and Won.
    • Disbursement: Enable Disbursement.
  5. Save.
  6. Locate the newly created webhook URL and select it to test. A success message should appear.

5. Define Risk Settings

You must set up a user in Braintree for Bolt, which aligns with our fraud indemnification terms and conditions. We represent chargebacks on behalf of Bolt Pay merchants.

For payments made with a card saved to a shopper’s account, Bolt does not transmit CVV match data to processors.

Disable the following fraud protection filters so that the lack of this data does not trigger auto-declines:

  • Postal Code Options:
    • Postal Code does not match (when provided)
    • Postal Code not verified
    • Postal Code not provided
  • Street Address Options:
    • Street Address does not match (when provided)
    • Street Address not verified
    • Street Address not provided
  • CVV Error Options:
    • Issuing bank does not support CVV
    • CVV system error

If you don’t use Bolt’s Fraud Detection product, contact your fraud solutions provider to inform them that payments transmitted via this processor will not provide CVV match information.

6. Test

Review Braintree’s test-card page and transaction amount requirements for testing.

📖On This Page