Additional Features/
Braintree Auth (Beta)/
Merchant API

Merchant API

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 transactionAnchorIcon

This is how to create a transaction using an access token:
  1. PHP
$gateway = new BraintreeGateway([
    'accessToken' => useAccessTokenForMerchant,
]);
$result = $gateway->transaction()->sale([
    'amount' => '100.00',
    'paymentMethodNonce' => nonceFromTheClient
]);
$transactionId = $result->transaction->id;

Creating a customerAnchorIcon

Here's how you would create a customer for a merchant:
  1. PHP
$gateway = new BraintreeGateway([
    'accessToken' => useAccessTokenForMerchant,
]);
$result = $gateway->customer()->create([
    'firstName' => 'Joe',
    'lastName' => 'Brown',
    'email' => 'joe@example.com',
    'phone' => '312-555-1234',
]);
$customerId = $result->customer->id;

Authentication errorsAnchorIcon

The merchant has the right to revoke an authorization grant at any time. If this occurs, you will receive a Braintree\Exception\Authentication when attempting to take any action on the merchant’s behalf.