Order Status
The order statuses are returned by CityPay callback for identifying the current state of order in question.
Status | Description |
In-progress | The buyer has opened the payment page and has selected cryptocurrency. |
Paid/Unconfirmed | The buyer has fully paid the order amount, but six confirmations are not received yet. |
Confirmed | The buyer has fully paid the order amount and 5+ confirmations are received. |
Underpaid | The buyer hasn't fully paid the order amount. |
Overpaid | The buyer has paid more than the order amount. |
Expired | The buyer did not pay any amount and the order time has expired. |
Canceled | The buyer has canceled the order by clicking on the cancel button. |
Statuses are received by payment callback. You can use them to determine whether a payment was received or not and what are its conditions.
When the order is created you will receive a call from our callback service. the newly created orders have In-progress status. In-progress status remains unchanged until the order expires, or is paid/overpaid or is canceled.
If your customer makes a payment you will receive a new call from our callback, with the indication of the corresponding status. If the status remains In-progress, that means that customer hasn't yet paid the full amount.
You can determine order expiration or underpayment by calculating the expiration time using the call to the creation time.