API v1 is DEPRECATED
API v1 is DEPRECATED and no longer maintained. Please use API v2 http://developer.coingate.com/v2
Status | Description |
---|---|
pending | Awaiting payment from the buyer. |
confirming | Buyer sent a payment for the invoice. Waiting for confirmation from the Bitcoin network. It can take up to: ~10 sec if price < 300 EUR ~10 min if price >= 300 EUR |
paid | Payment confirmed by the Bitcoin network and merchant order is "ready to be shipped". |
invalid | Payment rejected by the Bitcoin network. |
expired | Buyer did not pay within 20 minutes and the invoice expired. |
canceled | Buyer canceled the invoice. |
refunded | Payment refunded to buyer or merchant. |
Statuses by priority:
- pending
- confirming
- paid OR invalid OR expired OR canceled
- refunded
Statuses and Merchant App Behavior
Status | Behavior | Sends Callback |
---|---|---|
pending | Mark order status as unpaid in database. Display "Unpaid" order status for buyer. | No |
confirming | Mark order status as pending or confirming or processing in database. Display "Waiting payment from CoinGate" status for buyer. | Yes* |
paid | Mark order as paid in database. Display "Paid" order status for buyer. | Yes |
invalid | Mark order as invalid or rejected in database. Display "Invalid" or "Rejected" order status for buyer. | Yes |
expired | Mark order as expired or unpaid in database. Display "Expired" or "Unpaid" order status for buyer. | Yes |
canceled | Mark order as canceled or unpaid in database. Display "Canceled" or "Unpaid" order status for buyer. | Yes |
refunded | Mark order as refunded in database. Display "Refunded" or "Unpaid" order status for buyer. | Yes |
*The "confirming" status is sometimes skipped and "paid" or "invalid" status is sent instead.