Create Grant Approval

Initiates the approval process for a new grant.

AuthorizationBasic

Basic authentication of the form Basic <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

1	import requests
2
3	url = "https://global-api-sandbox.afterpay.com/v2/grants/approvals"
4
5	payload = {
6	"grants": [{ "type": "ON_FILE" }],
7	"merchant": {
8	"redirectConfirmUrl": "https://example.com/approval/confirm",
9	"redirectCancelUrl": "https://example.com/approval/cancel"
10	}
11	}
12	headers = {
13	"User-Agent": "User-Agent",
14	"Authorization": "Basic <username>:<password>",
15	"Content-Type": "application/json"
16	}
17
18	response = requests.post(url, json=payload, headers=headers)
19
20	print(response.json())

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	}