Venmo via Braintree

​

Supported workflows

​

Before you begin

1. Set up a Braintree integration in your workspace. Follow the Braintree integration setup guide if you don’t have one yet.
2. Make sure you registered your Braintree gateway account in the United States, and ask Braintree to enable Venmo on it. Braintree sets the account country at signup.
3. Set up a Venmo merchant profile in Braintree with the name and logo the customer sees in the Venmo app.
4. In the Payrails Portal, go to Settings → Integrations, open your Braintree integration, select Venmo under Payment methods, and save.
5. Add Venmo as a payment option in your workflow.
6. Add the Braintree client SDK with Venmo to your checkout, so it can return a Venmo nonce.

​

Request fields for Braintree

​

Authorize a Venmo payment

{
  "amount": {
    "value": "25.00",
    "currency": "USD"
  },
  "paymentComposition": [
    {
      "integrationType": "api",
      "paymentMethodCode": "venmo",
      "amount": {
        "value": "25.00",
        "currency": "USD"
      },
      "storeInstrument": true,
      "paymentInstrumentData": {
        "paymentToken": "tokenvenmo_example_nonce"
      }
    }
  ],
  "meta": {
    "customer": {
      "name": "Jordan",
      "lastName": "Rivera",
      "email": "jordan.rivera@example.com"
    },
    "order": {
      "reference": "order-1234",
      "softDescriptor": "Example Store"
    }
  }
}

​

How Braintree handles Venmo

• Each nonce works for one transaction only. Get a new nonce from the Braintree client SDK for every customer-initiated payment.
• With delayed capture, Payrails authorizes the payment, and you capture it later. Braintree accepts partial captures and several captures against one Venmo authorization.
• To save the Venmo account, set storeInstrument to true. Braintree stores the account after a successful transaction, and Payrails keeps the reusable Braintree token on the instrument. Payrails charges later merchant-initiated transactions (MIT) against that token, with no customer present.
• A zero-amount authorize saves the Venmo account without charging the customer.