Order Statuses

Each order can have various states during its lifecycle. When order callback is sent, response body contains status - a numeric value that indicates the current status of the order. For a better understanding of the order callbacks refer to Order Callbacks.

StatusCallback "status" valueDescription
NEWCallback not sentThe order has been created but no further action has been taken yet.
PENDINGCallback not sentThe payment(s) for corresponding order was received.
PAID"3"The payment(s) is sufficient and approved by transaction monitoring.
FAILED"4"The payment(s) was rejected by transaction monitoring (very rare cases).
EXPIRED"5"The order was not paid within the designated time frame or was underpaid and has expired. To get idea why orders expire and what to do next refer to Expired Orders.

Order status flow

This flowchart illustrates the order payment process, showing status transitions based on payment conditions. It starts with an order marked as NEW, followed by verifying if a payment is created and detected on the blockchain. If valid, the order moves to PENDING, and the payment is monitored. Approved payments are checked against the order amount—if matched, the status becomes PAID, triggering a callback. If unmatched, additional payment is considered; without it, the order becomes EXPIRED. Rejected payments result in a FAILED status with asset refunds.


What’s Next

Next, review the section on order callbacks, which closely relates to order statuses, to build a complete understanding.