This endpoint captures a full or partial payment. Any amounts successfully captured will be settled from Afterpay to the merchant's nominated bank account on the following day. Records of all payments captured against an order are returned in the events list as events of type, "CAPTURED".
This operation is idempotent based on the
requestId(if provided), which allows for the safe retry of requests, guaranteeing the payment operation is only performed once.
Successful Response (201)
If successful, returns an updated copy of the Payment object, with the newly captured payment appended to the
events array as a Payment Event object with a
type of "CAPTURED".
In addition to the PUT/POST Errors applicable to all POST endpoints, the following errors are specific to Capture Payment:
|HTTP Status Code||errorCode||Description|
|No numeric |
|Payment has already been fully captured for this order, or partially captured with the remainder voided.|
|A numeric |
|The order was declined by Afterpay; no payment can be captured for this order.|
|The auth for this order has already been completely voided.|
|The auth for this order has expired; no further payment can be captured.|