Tickets - Login

Set Up Bolt for Braintree

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. Add Braintree Keys to Bolt

You must be an admin in your Bolt Merchant Account to complete the following steps.

  1. Log in to the Braintree Production Console or Sandbox Console.
  2. Select the Settings icon > API.
  3. Select Generate new API Key.
  4. Select View. It should provide the following keys:
    • Merchant ID
    • Public Key
    • Private Key
  5. Copy the mentioned keys.
  6. Open the Bolt Merchant Production Dashboard or Sandbox Dashboard in a separate tab.
  7. Navigate to Settings >Payments.
  8. Add your Braintree keys.
  9. Submit to save.

3. Configure Braintree Webhook

This notifies Bolt about any disputes that occur.

  1. Contact your Bolt CSM or Bolt Support for your unique Webhook URL.
  2. Log in to the Braintree Production Console or Braintree Sandbox Console
  3. Select Webhooks > Create new webhook.
  4. Configure the webhook.
  5. Update the following:
    • Destination URL: <USE THE LINK YOU OBTAINED IN STEP 1>
    • Enable Lost, Opened, and Won Disputes
    • Enable Disbursement
  6. Save.
  7. Locate the newly created webhook URL and select it to test; a success message appears.

4. Define Risk Settings

Risk settings found in your Braintree account must be configured differently depending on your fraud coverage.

You must set up a user in Braintree for Bolt in order for our team to dispute chargebacks on your behalf.

Bolt Indemnified

Disable fraud settings (Postal Code, Street Address, and AVS Errors). This is handled by Bolt on your behalf.

  • 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
  • AVS Error Options:
    • Issuing bank does not support AVS
    • AVS system error

Not Bolt Indemnified

Enable fraud settings provided by Braintree as desired.

Related Articles