order.status field. Poll the order or subscribe to order_updated webhooks — status values are identical in both.
2023-01-01
import Ivy from '@getivy/node-sdk'
const client = new Ivy()
const order = await client.orders.retrieve({ id: 'your-order-id' })
Statuses
| Status | Description | Next | Terminal |
|---|---|---|---|
processing | Order created and payment flow started. | waiting_for_payment, paid, finalizing, canceled | No |
waiting_for_payment | Customer authorized the payment. Settlement pending. Not guaranteed. Skipped if settlement happens first. | paid, finalizing, failed, canceled | No (yes for direct settlement) |
finalizing | Payment received, booking verification in progress. Usually minutes, up to 48 hours. Can still be expired via API. | paid, canceled | No |
paid | Funds arrived or are guaranteed by Augustus. Settlement takes anywhere from instant to 3 business days depending on scheme. Only appears when Augustus holds your collection account. | in_refund | Yes (unless refunded) |
canceled | Session expired or was canceled. Late payments are auto-returned. | — | Yes |
failed | Funds did not arrive in time (6 days for instant_preferred / standard, 24 hours for instant_only). Late payments are auto-returned. | — | Yes |
in_refund | Refund in flight to the customer’s bank. | refunded, partially_refunded | No |
refunded | Fully refunded. | — | Yes |
partially_refunded | Part of the order was refunded. | in_refund | No |
Payments don’t always follow the common path — handle every transition in your integration.