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

​
Processor Details

​
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
  • Merchant accounts by currency: Braintree charges each payment in the currency of the merchant account that receives it. Add a merchant account for each currency you accept, and each payment is charged in its own currency
  • 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
  • Accepted
  • Auto Accepted
  • Disputed
  • Expired
  • Lost
  • Opened
  • Under Review
  • Won
The dispute events (Accepted through Won) report when a customer disputes a payment and each time the dispute changes, through to its final outcome. PayNext records the dispute on the payment and keeps its status up to date. Without these events, PayNext is not notified when a dispute is opened or changes.
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.