Search

Availability

The Grant API is currently in a limited release.Contact us to determine whether it's right for your needs and to request access to the API.

The Grant API provides visibility into facilitated transactions created with granted payment information.

Grantor

With the appropriate rights, the grantor can search for transactions that the recipient has created with granted payment information. Facilitated transaction searches behave the same as any other transaction search, but are limited to only those transactions that the recipient has created with the granted payment information. To enable facilitated transaction search, configure the connection with the recipient to include the ReadFacilitatedTransactions OAuth scope. Search parameters should be relative to the recipient. The grantor cannot query against parameters unique to the payment method record stored in their vault such as PaymentMethodToken. The example below fetches the number of authorized facilitated transactions for a given recipient.

BraintreeGateway gateway = new BraintreeGateway(useAccessTokenForRecipient);

var request = new TransactionSearchRequest().
    Status.Is(TransactionStatus.AUTHORIZED);

ResourceCollection<Transaction> collection = gateway.Transaction.Search(request);
var numberOfFacilitatedTransactions = collection.MaximumCount;

Recipient

Transaction search

The recipient can search for transactions created with granted payment information.

Control Panel

If the recipient has connected to any grantors, those grantors will show up as options for a transaction search under the Payment Method Source filter section. These grantors can be used as parameters in your search like any other transaction sources. If the recipient is connected to multiple grantors, they can include or exclude transactions created with payment methods from any combination of grantors.

API

A recipient can search for facilitated transactions via the API by passing the source search parameter and setting it to the grantor's OAuth application client ID. This value can be found on the OAuth Connected Apps page in the Control Panel, as well as in the facilitator details returned in transaction response objects.

Dispute search

The recipient can also search for disputes for facilitated transactions.

Control Panel

Using the Control Panel dispute search, choose Payment Method Source to specify the grantor.

API

When searching for disputes via the API, specify the Grantor's OAuth application client ID as the transaction source.

Note

The grantor's OAuth application client ID is different from the name that appears in the Control Panel under Payment Method Source.