Get Checkout

This endpoint retrieves an incomplete individual checkout by token.

Checkout details are only retained in this temporary format for up to 60 minutes. If a checkout token expires or has an order created against it, it can no longer be retrieved from this endpoint. To retrieve a Payment record (Cash App Afterpay Order) along with its associated checkout details, see Get Payment By Token.

This endpoint retrieves an incomplete individual checkout by token. Checkout details are only retained in this temporary format for up to 60 minutes. If a checkout token expires or has an order created against it, it can no longer be retrieved from this endpoint. To retrieve a [Payment](../docs/ONLINE-API/Payment-object.md) record (Cash App Afterpay Order) along with its associated checkout details, see Get Payment By Token.

Authentication

AuthorizationBasic

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

Path parameters

tokenstringRequired

The token of the checkout to be retrieved.

Response

Returns an object combining the Checkout Request and Checkout Response for a provided token.

Returns an object combining the [Checkout Request](reference/Checkouts.v2.yaml/components/schemas/Checkout-Request) and [Checkout Response](reference/Checkouts.v2.yaml/components/schemas/Checkout-Response) for a provided token.

amountobject

Object containing amount and currency

consumerobject

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 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 contact and identification details for a user.

billingobject or null

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.

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>

courierobject or null

Essential information for tracking a shipment. The shippedAt key represents the date and time when the item was shipped. This value follows the ISO 8601 standard format for date and time representations.

The name field indicates the courier service employed to handle the shipment (e.g. FEDEX, UPS). For orders that are picked up in-store (also known as Buy-Online-Pickup-Instore), please use “INSTORE_PICKUP” as the name field value.

The tracking key represents a unique tracking number provided by the courier service to monitor the shipment’s progress. It’s a valuable tool for customers and businesses to track and trace their packages.

The priority field tracks the shipping speed or service level associated with the delivery.

Essential information for tracking a shipment. The `shippedAt` key represents the date and time when the item was shipped. This value follows the [ISO 8601 standard format](https://www.iso.org/iso-8601-date-and-time-format.html) for date and time representations. The `name` field indicates the courier service employed to handle the shipment (e.g. FEDEX, UPS). For orders that are picked up in-store (also known as Buy-Online-Pickup-Instore), please use "INSTORE_PICKUP" as the `name` field value. The `tracking` key represents a unique tracking number provided by the courier service to monitor the shipment's progress. It's a valuable tool for customers and businesses to track and trace their packages. The `priority` field tracks the shipping speed or service level associated with the delivery.

discountslist of objects or null

expiresstring or null

The UTC timestamp of when the checkout token will expire, in ISO 8601 format.

itemslist of objects or null

merchantobject or null

merchantReferencestring or null

modestring or nullDefaults to standard

Must be set to express to enable express checkout. Allowed values: express standard

redirectCheckoutUrlstring or null

A URL that can be used to redirect the customer to the Cash App Afterpay screenflow directly from the merchant backend.

shippingobject or null

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

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

shippingAmountobject or null

Object containing amount and currency

taxAmountobject or null

Object containing amount and currency

tokenstring or null

Checkout token to be used to complete payment.

descriptionstring or nullDeprecated

1	import requests
2
3	url = "https://global-api-sandbox.afterpay.com/v2/checkouts/token"
4
5	headers = {
6	"User-Agent": "User-Agent",
7	"Authorization": "Basic <username>:<password>"
8	}
9
10	response = requests.get(url, headers=headers)
11
12	print(response.json())

1	{
2	"amount": {
3	"amount": "100.00",
4	"currency": "AUD"
5	},
6	"consumer": {
7	"email": "test@example.com",
8	"givenNames": "Joe",
9	"surname": "Consumer",
10	"phoneNumber": "0400 000 000"
11	},
12	"billing": {
13	"name": "Joe Consumer",
14	"line1": "Level 8",
15	"area1": "Melbourne",
16	"region": "VIC",
17	"postcode": "3000",
18	"countryCode": "AU",
19	"line2": "390 Collins Street",
20	"area2": "string",
21	"phoneNumber": "0400 000 000"
22	},
23	"courier": {
24	"shippedAt": "2025-08-24T14:15:22Z",
25	"name": "USA Post",
26	"tracking": "AA0000000000000",
27	"priority": "STANDARD"
28	},
29	"discounts": [
30	{
31	"displayName": "New Customer Coupon",
32	"amount": {
33	"amount": "100.00",
34	"currency": "AUD"
35	}
36	}
37	],
38	"expires": "2023-08-29T00:00:00.000Z",
39	"items": [
40	{
41	"name": "Blue Carabiner",
42	"quantity": 1,
43	"price": {
44	"amount": "100.00",
45	"currency": "AUD"
46	},
47	"sku": "string",
48	"pageUrl": "https://merchant.example.com/carabiner-354193.html",
49	"imageUrl": "https://merchant.example.com/carabiner-7378-391453-1.jpg",
50	"categories": [
51	[
52	"string"
53	]
54	],
55	"estimatedShipmentDate": "2023-08-01",
56	"preorder": false
57	}
58	],
59	"merchant": {
60	"redirectConfirmUrl": "https://example.com/checkout/confirm",
61	"redirectCancelUrl": "https://example.com/checkout/cancel",
62	"popupOriginUrl": "https://merchant.com/cart",
63	"name": "string"
64	},
65	"merchantReference": "string",
66	"mode": "standard",
67	"redirectCheckoutUrl": "https://portal.sandbox.afterpay.com/us/checkout/?token=005.2fkv5o963b132z8ppa34srlh60987y87d55re237wsg9tr4q2",
68	"shipping": {
69	"name": "Joe Consumer",
70	"line1": "Level 8",
71	"area1": "Melbourne",
72	"region": "VIC",
73	"postcode": "3000",
74	"countryCode": "AU",
75	"line2": "390 Collins Street",
76	"area2": "string",
77	"phoneNumber": "0400 000 000"
78	},
79	"shippingAmount": {
80	"amount": "100.00",
81	"currency": "AUD"
82	},
83	"taxAmount": {
84	"amount": "100.00",
85	"currency": "AUD"
86	},
87	"token": "005.2fkv5o963b132z8ppa34srlh60987y87d55re237wsg9tr4q2",
88	"description": "string"
89	}

Authentication

Path parameters

Headers

Response

Errors