1. Create a Checkout

What are the API calls required to create a new Afterpay order?

Before creating an Afterpay checkout the merchant needs to retrieve the minimum and maximum order amounts that Afterpay is enabled for. This is done through the Get Configuration endpoint.

1. Get Configuration


This call should be done as apart of a scheduled background process. We recommend calling this endpoint once a day and storing the minimumAmount and maximumAmount server-side.

The merchant should use these values to determine:

  1. The correct Afterpay Messaging to show on the Product Detail pages
  2. Whether Afterpay should be presented as an available payment method.

A request to create a checkout will be declined if the order grand total is less than the minimum, or more than the maximum Afterpay amount. Check with your Afterpay contact to change your minimum or maximum range.

2. Create Checkout


You will call the Create Checkout endpoint to tell Afterpay information including:

  1. Customer Information
  2. Order Details
  3. Order Total
  4. Shipping Information
  5. URL you would like to direct the customer to when they complete the Afterpay checkout flow


Afterpay uses the Order Total value to calculate the installment plan and to assist with the consumer’s pre-approval process.

Afterpay will respond with a token used to identify this checkout.
e.g. 002.5lmerr3k945d00c7htvcrdff83q36kp10a247m212fjpa5ju

The token is used with the Afterpay.js JavaScript library to direct the consumer to the Afterpay checkout flow.


Afterpay Checkout Final Screen

After the consumer completes the checkout flow they will be returned to the Merchant website URL provided in the Create Checkout request. If using the redirect method the URL will have status appended to the Merchant URL. For Example:

  • If the consumer successfully completes the checkout flow:
  • If the consumer closes the window:


A popup method is also available which uses a postMessage to communicate the status and token.

Choose When You Want to Capture the Order

Now that you have a successful pre-approval for the checkout you can either capture the order directly or create an Auth API call to place funds on hold until you are ready to capture.