Create Grant

Creates a new grant from a grant approval token.

AuthorizationBasic

Basic authentication of the form Basic <username:password>.

This endpoint expects an object.

requestIdstringRequired<=64 characters

A unique request ID, required for idempotent retries. It is recommended that the merchant generate a UUID for each unique request.

tokenstringRequired

The token returned from the create approval request.

codestringOptional

The one-time code received from the consumer. Note: The code will only be sent with the headless integration.

Created

grantobject

1	curl -X POST https://global-api-sandbox.afterpay.com/v2/grants \
2	-H "Content-Type: application/json" \
3	-u "<username>:<password>" \
4	-d '{
5	"requestId": "123e4567-e89b-12d3-a456-426614174000",
6	"token": "005.2fkv5o963b132z8ppa34srlh60987y87d55re237wsg9tr4q2"
7	}'

1	{
2	"grant": {
3	"id": "005.2fkv5o963b132z8ppa34srlh60987y87d55re237wsg9tr4q2",
4	"type": "ON_FILE",
5	"status": "ACTIVE",
6	"created": "2024-03-04T12:00:00Z",
7	"merchantReference": "merchant_ref_123",
8	"cancelled": "2024-03-05T12:00:00Z",
9	"expires": "2025-03-04T12:00:00Z",
10	"consumerReference": "cust_12345",
11	"email": "j*@e*.com",
12	"requestId": "req_abc123def456"
13	}
14	}