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. Ruby
gateway = Braintree::Gateway.new(
    :access_token => use_access_token_for_merchant
);
result = gateway.transaction.sale(
    :amount => "100.00",
    :payment_method_nonce => nonce_from_the_client
);
transaction_id = result.transaction.id

Creating a customerAnchorIcon

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

  1. Ruby
gateway = Braintree::Gateway.new(
    :access_token => use_access_token_for_merchant
);
result = gateway.customer.create(
    :first_name => "Joe",
    :last_name => "Brown",
    :email => "joe@example.com",
    :phone => "312.555.1234"
);
customer_id = 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::AuthenticationError when attempting to take any action on the merchant’s behalf.


Next Page: Multi-currency →