Create Order

This is the first step in the on file grant purchase process. Use the token in the response to initiate the payment

Authentication

AuthorizationBasic

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

Request

This endpoint expects an object.

requestIdstringRequiredformat: "uuid"<=64 characters

A unique identifier for the request, used for idempotency

grantIdstringRequired

ID of the grant used to create this order

amountobjectRequired

The total amount of the order

enrichmentsobjectRequired

Describes additional fields beyond core payment information.

consumerobjectOptional

The consumer data model is used for gathering essential user information. It captures details such as the individual’s first name, represented by givenNames, and their last name, captured under surname. In addition, it stores the user’s contact number under phoneNumber and their email address under email. These fields collectively provide indispensable contact and identification details for a user.

The consumer data model is used for gathering essential user information. It captures details such as the individual's first name, represented by `givenNames`, and their last name, captured under `surname`. In addition, it stores the user's contact number under `phoneNumber` and their email address under `email`. These fields collectively provide indispensable contact and identification details for a user.

billingobjectOptional

This data model is used for storing an individual’s contact information. Mandatory fields such as name, line1, area1, region, postcode, and countryCode help in capturing vital information about a user’s location.

The line2 and area2 fields provide additional space for extended addresses, while phoneNumber can be used to store the user’s contact number.

Important Note

The area1, area2 and region properties feature localized terminology based on country. Refer to the property descriptions for insights on each country’s specific usage

This data model is used for storing an individual's contact information. Mandatory fields such as **name**, **line1**, **area1**, **region**, **postcode**, and **countryCode** help in capturing vital information about a user's location. The `line2` and `area2` fields provide additional space for extended addresses, while `phoneNumber` can be used to store the user's contact number. <Warning title="Important Note"> The `area1`, `area2` and `region` properties feature localized terminology based on country. Refer to the property descriptions for insights on each country's specific usage </Warning>

shippingobjectOptional

The line2 and area2 fields provide additional space for extended addresses, while phoneNumber can be used to store the user’s contact number.

Important Note

The area1, area2 and region properties feature localized terminology based on country. Refer to the property descriptions for insights on each country’s specific usage

itemslist of objectsOptional

discountslist of objectsOptional

merchantReferencestringOptional<=128 characters

The reference/order ID in the merchant’s system

shippingAmountobjectOptional

The shipping cost amount

taxAmountobjectOptional

The tax amount

Response

Created

tokenstring

expiresstringformat: "date-time"

1	import requests
2
3	url = "https://global-api-sandbox.afterpay.com/v2/orders"
4
5	payload = {
6	"requestId": "123e4567-e89b-12d3-a456-426614174000",
7	"grantId": "005.2fkv5o963b132z8ppa34srlh60987y87d55re237wsg9tr4q2",
8	"amount": {
9	"amount": "100.00",
10	"currency": "AUD"
11	},
12	"enrichments": { "initiation": { "actor": "CUSTOMER" } }
13	}
14	headers = {
15	"User-Agent": "User-Agent",
16	"Authorization": "Basic <username>:<password>",
17	"Content-Type": "application/json"
18	}
19
20	response = requests.post(url, json=payload, headers=headers)
21
22	print(response.json())

Authentication

Headers

Request

Important Note

Important Note

Response

Errors

Important Note

Important Note

1	{
2	"token": "001.8v3cpfue87bl9gcv6ampnfct9ts5o9vis39vee9tlor2aq6a",
3	"expires": "2025-07-24T03:47:25.278Z"
4	}