Payment status
When a payment is safe to fulfill.
Create a payment, send the buyer to checkout, then fulfill when Orqpay tells you it is paid.
Happy path
CREATED → PAID → SETTLED- You create a payment
- The buyer pays USDC or USDT on hosted checkout
- You receive
invoice.paid→ fulfill in your product - You may receive
invoice.settled→ accounting only (do not use to ship)
Prefer webhooks over polling. Use GET /v1/payments/{id} only when you already have the id.
Statuses
| Status | Meaning | What you usually do |
|---|---|---|
CREATED | Waiting for payment | Show checkout / wait |
UNDERPAID | Partial amount received | Wait for the rest (same checkout) |
PAID | Paid in full on time | Fulfill |
OVERPAID | Paid more than asked | Fulfill; handle surplus if needed |
EXPIRED | Window closed unpaid | Close the order |
EXPIRED_UNDERPAID | Window closed short | Contact the buyer / close |
SETTLED | Funds finished settling | Accounting only |
Fulfill only on invoice.paid. Do not treat late or settled events as a ship signal.