availability

The Grant API is currently in a limited release. To determine whether it's right for your needs and to request access to the API, contact our Business Development team.

The Grant API uses OAuth to connect a granting Braintree merchant and a receiving Braintree merchant.

Once the recipient goes through these flows and consents to receiving granted payment methods, the grantor will receive an access_token. This token contains encoded information about the recipient, information to the Grant API connection, and the actions the grantor can take on the recipient's behalf.

To use the Grant API with the recipient, the access_token must include the right to grant payment methods to that merchant. When setting the connect_url, the grantor must include the OAuth scope grant_payment_method.

Configuring transaction search

The receipient can search for any transactions they've created using granted payment methods, but in order for the grantor to access this data, the access_token must include the right to search for facilitated transactions. As the grantor, be sure to include the OAuth scope read_facilitated_transactions, in addition to grant_payment_method, when setting the connect_url.

Next Page: Search →

Still have questions?

If you can’t find an answer, contact our Support team