Order statuses
What each status means, and how to follow an order to the end.
| Status | Meaning | Final? |
|---|---|---|
paid | Accepted and about to be sent to the provider. | No |
processing | Being delivered. | No |
pending | Sent; the provider hasn't confirmed yet. | No |
delivered | Done. token and receiptUrl are set. | Yes |
refund_due | Couldn't be delivered; credit is being returned. | No |
refunding | Credit is being returned. | No |
refunded | Couldn't be delivered; credited back to your account. | Yes |
failed | Rejected before delivery. Nothing was charged. | Yes |
Following pending orders
Partner webhooks aren't available yet, so poll Get a purchase. Each call re-checks in-progress orders with the provider. We also re-check them every 5 minutes on our side.
- Every 5–10 seconds for the first two minutes.
- Then every few minutes until the status is final.
- Never create a second purchase for the same sale while one is pending: retry with the same Idempotency-Key instead.

