Create Grant Approval

Initiates the approval process for a new grant.

AuthorizationBasic

Basic authentication of the form Basic <base64(username:password)>.

This endpoint expects an object.

grantslist of objectsRequired

Grant type for approval (only single grant is supported)

merchantobjectRequired

merchantReferencestringOptional<=128 characters

Merchant's unique reference for this grant

consumerobjectOptional

Consumer details for the grant

tokenstring

Token identifying this grant approval request

expiresstringformat: "date-time"

When this approval request expires

redirectCheckoutUrlstringformat: "uri"

URL where the consumer should be redirected to complete approval

401

Unauthorized Error

403

Forbidden Error

415

Unsupported Media Type Error

422

Unprocessable Entity Error

$	curl -X POST https://global-api-sandbox.afterpay.com/v2/grants/approvals \
>	-H "User-Agent: User-Agent" \
>	-H "Content-Type: application/json" \
>	-u "<username>:<password>" \
>	-d '{
>	"grants": [
>	{
>	"type": "ON_FILE"
>	}
>	],
>	"merchant": {
>	"redirectConfirmUrl": "https://example.com/approval/confirm",
>	"redirectCancelUrl": "https://example.com/approval/cancel"
>	}
>	}'

$	curl -X POST https://global-api-sandbox.afterpay.com/v2/grants/approvals \
>	-H "User-Agent: User-Agent" \
>	-H "Content-Type: application/json" \
>	-u "<username>:<password>" \
>	-d '{
>	"grants": [
>	{
>	"type": "ON_FILE"
>	}
>	],
>	"merchant": {
>	"redirectConfirmUrl": "https://example.com/approval/confirm",
>	"redirectCancelUrl": "https://example.com/approval/cancel"
>	}
>	}'

1	{
2	"token": "ba_approval_xyz789abc123",
3	"expires": "2024-03-05T22:13:45Z",
4	"redirectCheckoutUrl": "https://portal.afterpay.com/us/checkout/ba-approval?token=ba_approval_xyz789abc123"
5	}