Order Status
Status for the purchase order (invoice). On the merchant side, the most commonly used statuses are "NEW" and "PAID". If it is PAID, you might want to fulfill the customer’s purchase. Every time a status change, Payment Callback will be triggered.
Status
| Status Type | Description | Next Possible Status |
|---|---|---|
| NEW | Newly created. Payment currency has not been selected. | WAITING_FOR_PAYMENT, CANCELED |
| WAITING_FOR_PAYMENT | Payment address or invoice generated. Waiting for the customer to send funds. | PARTIALLY_PAID, PENDING, PAID, EXPIRED_PAYMENT, CANCELED |
| PARTIALLY_PAID | Customer sent some funds, but less than the required amount. Waiting for the balance. | PAID, UNRESOLVED, EXPIRED_PAYMENT |
| PENDING | The transaction has been detected and is waiting for blockchain confirmations. Confirmation time varies by network. | PAID, FAILED_PAYMENT |
| PAID | Payment has been received in full and is confirmed. Funds are credited to the merchant. | PENDING, COMPLETED, UNRESOLVED |
| COMPLETED | Order is fully paid, confirmed, and processed successfully. Final success state. | REFUND_PENDING |
| FAILED | A general failure occurred during processing (e.g., internal error or invalid payment state). | NEW (if retried), CANCELED |
| FAILED_PAYMENT | The payment attempt failed (e.g., rejected transaction or invalid transfer). | WAITING_FOR_PAYMENT, CANCELED |
| EXPIRED_PAYMENT | The payment window expired before funds were received. Customer must create a new order. | CANCELED |
| CANCELED | Order was canceled by the buyer or system. It cannot be paid anymore. | — (final state) |
| UNRESOLVED | The transaction was confirmed but diverged from expectations (e.g., overpaid, underpaid, or delayed). | RESOLVED, REFUND_PENDING |
| RESOLVED | The merchant has manually marked the previously unresolved payment as resolved. | COMPLETED |
| EXPIRED | Customer did not pay within the allowed time (default 60 minutes for crypto). The invoice/order expired and cannot be paid. | CANCELED |
| REFUND_PENDING | Customer requested a refund. Refund is pending merchant/system confirmation. | REFUNDED |
| REFUNDED | Payment has been successfully refunded to the customer. | — (final state) |
Help?
Payment sometimes get delayed when the blockchain network is congested. If you sent a payment after the order was expired or if your order does not confirm automatically, please contact us with the Web help widget or contact with info@kidapay.com