Merchant API

Availability Braintree Auth is in closed beta. Contact us to express interest.

Once you have an access_token, you are ready to perform actions on behalf of that merchant.

The only difference between the API to perform actions on behalf of a merchant and for a merchant performing their own actions is that the gateway object used to make API calls must be instantiated with an access token instead of a client ID and secret.

Creating a transaction

This is how to create a transaction using an access token:

Java

BraintreeGateway gateway = new BraintreeGateway(useAccessTokenForMerchant);
TransactionRequest request = new TransactionRequest()
    .amount(new BigDecimal("100.00"))
    .paymentMethodNonce(nonceFromTheClient);
Result<transaction> result = gateway.transaction().sale(request);
String transactionId = result.getTarget().getId();

Creating a customer

Here's how you would create a customer for a merchant:

Java

BraintreeGateway gateway = new BraintreeGateway(useAccessTokenForMerchant);
CustomerRequest request = new CustomerRequest()
    .firstName("Joe")
    .lastName("Brown")
    .email("joe@example.com")
    .phone("312-555-1234");
Result<customer> result = gateway.customer().create(request);
String customerId = result.getTarget().getId();

Authentication errors

The merchant has the right to revoke an authorization grant at any time. If this occurs, you will receive a com.braintreegateway.exceptions.AuthenticationException when attempting to take any action on the merchant’s behalf.