Skip to main content
Braintree is a payment platform from PayPal that provides comprehensive card processing solutions. The platform supports card payments with advanced features like delayed capture, partial refunds, and digital wallet integration across multiple currencies and countries.

​
Setup

Please follow the common Braintree instructions to get set up with Braintree. After you set up your Braintree account, configure the following settings in your merchant account so you can use all features:
  • Enable 3D Secure (if required by your region or card type)
  • Configure payment method preferences
  • Set up webhook endpoints for transaction notifications

​
Capabilities

This connector doesn’t support the Mastercard Transaction Link Identifier (TLID) yet. Braintree returns the TLID and Gr4vy stores it. However, Braintree’s API doesn’t currently accept a TLID on merchant-initiated payments for cards stored outside Braintree, and Gr4vy starts sending it once Braintree adds support. When Gr4vy creates a PSP token with this connector, it vaults the card with Braintree. The PSP token is the reusable Braintree payment method token, not a single-use nonce. Deleting the PSP token in Gr4vy also deletes the card from the Braintree vault. See PSP tokenization.

​
Cart items

Gr4vy sends cart_items to Braintree as line items. The item name is sent unchanged, and Gr4vy doesn’t shorten it. According to Braintree’s API reference, a line item name takes at most 35 characters, so shorten longer names before you send them.

​
Supported countries

​
Supported currencies

Each merchant account at Braintree processes payments in one currency. Braintree processes the amount in that currency, whatever currency the transaction uses. Only send transactions in the currency of the merchant account for this connection, and add a separate connection for each currency.

​
Integration

To accept card payments with Braintree, use one of Gr4vy’s client-side integration methods to securely collect card details. Due to PCI compliance requirements, card data should never be sent directly to your servers. You can integrate using:
  • Embed - A pre-built, customizable payment form that handles the complete payment flow
  • Secure Fields - Embed card input fields for building custom payment forms while maintaining PCI compliance
  • Mobile SDKs - Embed SDKs for iOS, Android, and React Native
These methods handle card data collection and tokenization. Once the card details are collected and tokenized, create a transaction through the Gr4vy API, which automatically routes the payment to your configured Braintree connection based on your Flow rules or explicit payment_service_id parameter.

​
Testing

For testing in sandbox environments, you can use standard test card numbers. Braintree supports industry-standard test cards for simulating different transaction scenarios: Successful transactions:
  • Visa: 4111 1111 1111 1111
  • Mastercard: 5555 5555 5555 4444
  • American Express: 3782 822463 10005
Use any future expiry date and any 3-digit CVV (4 digits for American Express). For more test scenarios and additional card numbers, refer to the Braintree testing documentation or contact your Braintree representative.