Set up Braintree

Connect Braintree to Bolt so Bolt can authorize and capture payments through your Braintree account.

Step 1: Allowlist Bolt and merchant IPs

Also add your office IP addresses so payment processing succeeds from your network.

Expected result: Braintree appears as your active processor under Settings > Payments.

Webhooks keep Bolt and Braintree in sync for disputes and disbursements.

Log into the Braintree Production Console or Sandbox Console.
Go to Settings > API > Webhooks > Create new webhook.
From the Bolt Merchant Dashboard:
- Destination URL: Settings > Payments > Manage Braintree (copy the Bolt webhook URL)
- Public ID: Developers > Public ID (replace <public-id> in the URL)
Subscribe to Disputes (Lost, Opened, Won) and Disbursement.
Save, then test the webhook until you see a success message.

For saved cards, Bolt does not transmit CVV match data.

Go to the Braintree Control Panel.
Use Braintree's AVS and CVV settings to:
- Allow transactions without CVV data
- Allow shipping and billing address mismatches

If you do not use Bolt Fraud Protection, tell your fraud provider that payments through this processor will not include CVV match information.

Configure Braintree communication preferences for digital chargeback notifications.

With Fraud Protection: Set up a user in Braintree so Bolt's chargebacks team can access dispute information.
Without Fraud Protection: Follow Braintree's chargebacks process.