Immediate Payment Flow

This flow completes the payment approval, starts the consumer's payment plan, and settles the full order value with the merchant - all as a combined action.

  1. Merchant calls the Get Configuration endpoint to retrieve Afterpay order limits, possibly as part of an asynchronous scheduled background process.
  2. Merchant stores these minimum and maximum order values server-side.
  3. Separately, at the checkout, Merchant uses the stored Afterpay minimum and maximum order values to determine if Afterpay should be presented as an available payment method.
  4. Merchant calls the Create Checkout endpoint to retrieve an Afterpay order token.
  5. Merchant uses the token in combination with the JavaScript afterpay.js to direct the Consumer through the Afterpay screenflow.
  6. Consumer completes the Afterpay screenflow and is returned to the Merchant website.
  • If the Consumer clicks "confirm", they will be returned to the Merchant website with the orderToken and a status of "SUCCESS".
  • If the Consumer cancels, they will be returned to the Merchant website with the orderToken and a status of "CANCELLED".
  1. If the merchant is able to fulfil the order, the merchant calls the Capture Full Payment endpoint to capture the payment.
  • Payment status ("APPROVED" or "DECLINED") is only known once Capture Full Payment has been completed.
  • If the payment was approved by Afterpay, the Merchant presents the Consumer with an order confirmation/receipt page.
  • If the payment was declined by Afterpay (e.g. the Consumer’s card details are entered incorrectly), the Merchant presents an appropriate message to the Consumer at the checkout.