Order Status
After creating an order, you can track its progress through the payment lifecycle.
Order lifecycle
All orders follow the same status progression regardless of the payment gateway:
| Status | Description |
|---|
pending | Order created but payment has not been initiated with the gateway yet. |
processing | Payment is in progress — waiting for buyer action (push approval, OTP, transfer). |
confirmed | Payment completed successfully. Funds will be settled to your wallet. Settlement timelines average 36 hours but vary by gateway and are dynamic. |
cancelled | Order was cancelled — buyer rejected the payment, it timed out, or it was cancelled via API. |
refunded | A refund has been processed for this order. |
Checking order status
You have two options to track when a payment completes:
Option 1: Webhooks (recommended)
Configure a webhook URL in your dashboard to receive real-time notifications when an order status changes. This is the most efficient approach — no polling required.
{
"event": "order_payment",
"data": {
"id_order": 12345,
"status": "confirmed",
"amount": 50000,
"currency": "COP"
}
}
Option 2: Polling
If you cannot receive webhooks, poll the order status endpoint:
curl -X GET "https://api.wava.co/v1/orders/12345" \
-H "merchant-key: YOUR_MERCHANT_KEY"
Polling should be used as a fallback only. We recommend a polling interval of 3–5 seconds. Excessive polling may be rate-limited.
Cancelling an order
You can cancel an order that is still in pending or processing status:
curl -X PUT "https://api.wava.co/v1/orders/12345/cancel" \
-H "merchant-key: YOUR_MERCHANT_KEY"
Orders in confirmed status cannot be cancelled. To reverse a confirmed payment, use the refund flow.
Timeout behavior
Each gateway has a different timeout window. If the buyer does not complete the payment within the timeout period, the order is automatically moved to cancelled status.
| Gateway | Approximate timeout |
|---|
| Nequi | ~5 minutes |
| Daviplata | ~5 minutes |
| Breb | ~15 minutes |
| Stripe | Session-based |
Settlement timelines
Once an order reaches confirmed status, funds are settled to your Wava wallet. Settlement timelines average 36 hours but vary by gateway and are subject to change. Exact per-gateway timelines will be visible in the Wava dashboard in an upcoming release.
Next steps
