📍 Bolt Help / Third-Party Connectors / Payment Processors / Set Up Bolt for Braintree

Set Up Bolt for Braintree

Bolt has launched a new Merchant Dashboard experience, which is currently in Beta. See this page for help documentation that reflects the new dashboard.



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
  1. Log into the Bolt Merchant Dashboard.
  2. Navigate to Settings > Payments.
  3. Click Add Braintree.
  4. Click Link Braintree.
  5. Enter your credentials in the OAuth modal.
  6. Edit the default payment settings to customize how processing works.
  7. Click Complete Setup.

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

4. Define Risk Settings

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 Protection, contact your fraud solutions provider to inform them that payments transmitted via this processor will not provide CVV match information.

Chargeback Handling

📖On This Page
Filter by Section
Filter by Topic