Braintree - Venmo

Braintree is a payment platform from PayPal that provides comprehensive payment processing solutions across multiple payment methods and regions. Venmo is a digital wallet and payments app owned by PayPal that allows buyers to send and receive money from other Venmo users and make purchases at online retailers. Venmo is primarily available in the United States and offers a convenient way for US customers to complete transactions.

Venmo is only available to United States Braintree accounts.

Setup

Follow the Braintree setup instructions before configuring Venmo payments. After setting up your Braintree account, make sure Venmo is enabled as a payment method in your merchant account settings. Tokenization key: set up a Braintree Tokenization Key in the Braintree Admin Portal under Settings -> API -> Keys. Ingest billing and shipping details: by default, billing and shipping details received from Braintree are not imported. To enable this feature, head over to Connections -> Configured and select your Venmo connector. Next, go to Credentials and toggle Import billing details and/or Import shipping details. When Import billing details is enabled, any of the user’s name, email address, and billing address is automatically imported into your transaction, merging it with any data already present on the transaction. Linked buyers are not updated, but only the snapshot of the buyer on the transaction. When Import shipping details is enabled, the user’s shipping address is automatically requested and imported into your transaction, merging it with any data already present on the transaction. Linked buyers are not updated, but only the snapshot of the buyer on the transaction. Please note that the ingestion of billing and shipping details is not available for tokenized payments. These toggles apply per connection, so set them on each Venmo connection you use, including sandbox connections. Details are only imported when the buyer approves a payment, so transactions created before you turned on a toggle aren’t updated.

Supported countries

Supported currencies

Capabilities

Integration

For Venmo, the default integration for Braintree is through a redirect to a hosted payments page. Start by creating a new transaction with the following required fields.

var transaction = await client.Transactions.CreateAsync(
  transactionCreate: new TransactionCreate()
  {
    Amount = 1299,
    Currency = "USD",
    Country = "US",
    PaymentMethod =
      TransactionCreatePaymentMethod.CreateRedirectPaymentMethodCreate(
        new RedirectPaymentMethodCreate()
        {
          Method = "venmo",
          Country = "US",
          Currency = "USD",
          RedirectUrl = "https://example.com/callback",
        }
      ),
  }
);

amount := int64(1299)
currency := "USD"
country := "US"
method := components.RedirectPaymentMethodCreateMethodVenmo
redirectUrl := "https://example.com/callback"

redirectPaymentMethodCreate := components.RedirectPaymentMethodCreate{
  Method: method,
  Country: country,
  Currency: currency,
  RedirectURL: redirectUrl,
}
paymentMethod := components.CreateTransactionCreatePaymentMethodRedirectPaymentMethodCreate(redirectPaymentMethodCreate)

transactionCreate := components.TransactionCreate{
  Amount:        amount,
  Currency:      currency,
  Country:       &country,
  PaymentMethod: &paymentMethod,
}

transaction, err := client.Transactions.Create(ctx, transactionCreate, nil, nil, nil)

CreateTransactionResponse transactionResponse = gr4vyClient.transactions().create()
  .transactionCreate(TransactionCreate.builder()
    .amount(1299L)
    .currency("USD")
    .country("US")
    .paymentMethod(TransactionCreatePaymentMethod.of(RedirectPaymentMethodCreate.builder()
      .method(RedirectPaymentMethodCreateMethod.VENMO)
      .country("US")
      .currency("USD")
      .redirectUrl("https://example.com/callback")
      .build()))
    .build())
  .call();

Transaction transaction = transactionResponse.transaction().orElse(null);

$transactionCreate = new TransactionCreate(
  amount: 1299,
  currency: 'USD',
  country: 'US',
  paymentMethod: new RedirectPaymentMethodCreate(
    method: 'venmo',
    country: 'US',
    currency: 'USD',
    redirectUrl: 'https://example.com/callback'
  )
);
$response = self::$sdk->transactions->create($transactionCreate);
$transaction = $response->transaction;

transaction: models.Transaction = client.transactions.create(
  amount=1299,
  currency="USD",
  country="US",
  payment_method={
    "method": "venmo",
    "country": "US",
    "currency": "USD",
    "redirect_url": "https://example.com/callback",
  }
)

const transaction = await gr4vy.transactions.create({
  amount: 1299,
  currency: "USD",
  country: "US",
  paymentMethod: {
    method: "venmo",
    country: "US",
    currency: "USD",
    redirectUrl: "https://example.com/callback"
  }
})

After the transaction is created, the API response includes payment_method.approval_url and the buyer_approval_pending status.

{
  "type": "transaction",
  "id": "ea1efdd0-20f9-44d9-9b0b-0a3d71e9b625",
  "payment_method": {
    "type": "payment-method",
    "approval_url": "https://cdn.sandbox.spider.gr4vy.app/connectors/braintree/apm.html?token=..."
  },
  "method": "venmo"
}

Redirect the buyer to the approval_url so they can complete authentication and approve the payment. After approval the buyer is redirected to the redirect_url you provided when creating the transaction. Do not rely solely on the redirect - either poll the transaction or (recommended) rely on webhooks to detect the final status (for example capture_succeeded or failure states). Venmo via Braintree supports separate authorization and capture, including partial captures, and you can void an authorized transaction before capture. In the dashboard, the payment method label for a Venmo transaction shows the buyer’s Venmo username followed by their Venmo user ID, as returned by Braintree.

Testing

Braintree has instructions on how to test Venmo. Gr4vy obtains the Venmo payment method nonce from the approval redirect, so you can’t pass Braintree’s static test nonce values to the Gr4vy API. To test, create a transaction in sandbox and complete the approval flow at the approval_url.

Introduction

Aggregators

Methods

Digital wallets

Anti-fraud

Browse

Braintree - Venmo

Setup

Supported countries

Supported currencies

Capabilities

Integration

Testing

​Setup

​Supported countries

​Supported currencies

​Capabilities

​Integration

​Testing

Setup

Supported countries

Supported currencies

Capabilities

Integration

Testing