Braintree Auth (Beta)
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 transaction
This is how to create a transaction using an access token:
- PHP
$gateway = new BraintreeGateway([
'accessToken' => useAccessTokenForMerchant,
]);
$result = $gateway->transaction()->sale([
'amount' => '100.00',
'paymentMethodNonce' => nonceFromTheClient
]);
$transactionId = $result->transaction->id;
Creating a customer
Here's how you would create a customer for a merchant:
- 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 errors
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.
Next Page: Multi-currency →