Skip to main content
Braintree, a PayPal service, provides payment processing with native support for PayPal and Venmo wallets.

​
Processor Details

​
Currency

Braintree sets the transaction currency from the merchant account, not the payment request — each account supports one currency, and there is no currency field on transaction create. This is a Braintree limitation.
Currency cannot be passed or overridden at payment creation. The amount is charged in the account’s configured currency regardless of the order currency — with no conversion. Route only matching-currency payments to a given Braintree account.

​
Integration Guide

1

Open Braintree Control Panel

Log in to the Braintree Control Panel and navigate to Settings → API
2

Copy credentials

Under API Keys, select a Private Key and click View. Copy the Public Key, Private Key, and Merchant ID
3

Add integration in PayNext

In Dashboard → Integrations, click Add new integration → Braintree → Connect
4

Enter credentials

  • Name: Label for this connection (e.g., “Braintree US”)
  • Public Key, Private Key, Merchant ID: Values from Braintree
  • Network Tokens: Enable if activated by your Braintree account manager
5

Configure webhooks

In the Braintree Control Panel, navigate to Settings → API → Webhooks tab and click Create New Webhook.Add the PayNext webhook URL and subscribe to:
  • Refund Failed
  • Payment Method Revoked By Customer
Payment Method Revoked By Customer reports when a customer revokes a vaulted payment method, such as a Venmo account, from their wallet. PayNext marks the payment method as revoked so it is no longer used for renewals. Without this event, PayNext keeps attempting renewals on an instrument the customer has already disconnected.
6

Save

Click Connect to complete the integration

​
Metadata Mapping

Braintree supports limited metadata fields: See Metadata Mapping for configuration instructions.

​
Premium Fraud Management Tools

To use Braintree’s Premium Fraud Management Tools:
  1. Create a Tokenization Key in Braintree Control Panel under Settings → API
  2. Collect device data using Braintree’s data-collector library
  3. Store the deviceData string in payment metadata
  4. Map your metadata key to Braintree’s device-data field
Verify device data is captured: Check the authorized payment payload in PayNext dashboard. The request should include:
The response should contain:
You can also verify in the Braintree dashboard by clicking on the transaction details.

​
Testing

Braintree testing guide — Test cards and payment scenarios.