Skip to main content

Order Life Cycle

One-Stage Paymentโ€‹

Note

In the Create Order API endpoint, the autoCapture parameter must be explicitly set to True or not included in the request at all.


Two-Stage Payment (๐Ÿšง in development)โ€‹

Note

For two-stage payments in the Create Order API endpoint, the autoCapture parameter must be set to False. Additionally, it is required to make the POST /api/v1/order/capture API call to complete the payment process.


Order Actions and Conditionsโ€‹

Order StatusPossible ActionsAction Preconditions
in_progresspost /api/v1/order/cancelOrder status is in_progress, the payments array within the response of the Retrieve Order Details doesn't contain payment item
in_progresspost /api/v1/order/rejectOrder status is in_progress, the payments array within the response of the Retrieve Order Details contain payment item
in_progresspost /api/v1/order/captureExclusive to two-stage payment. The order status should be in_progress, autoCapture must be set to false, and the payments array within the response from the Retrieve Order Details endpoint must include at least one payment item for two-stage payment type.
completedpost /api/v1/order/refundOrder status must be completed
rejectedSuccessful execution of post /api/v1/order/reject
canceledSuccessful execution of post /api/v1/order/cancel
failedThis status occurs if:
- The client hasn't paid by timeout.
- There are issues on the provider's side processing the payment.
- The client entered invalid payment details and the payment could not be completed.
refundedpost /api/v1/order/refundA refund has been processed for this order. For the refunded amount, check the sum of amount in cost objects with paymentType refund within the payments array (link for response). If the total order amount equals the sum of these amounts, a full refund is completed and no further actions can be performed. If the total refunded is less than the order amount, additional refunds may be processed if needed.