Confirm payment
POST /api/v1/cex/settlements/{batchRef}/confirm-payment → 200
Advanced · feature-flagged
This endpoint is gated per-partner by CEX_CONFIRM_PAYMENT_ENABLED. If it's not
enabled for you, it isn't available. Ask Orbitum if you need it.
Fast-track a settlement batch's inbound leg by submitting your payment transaction
hash. A 200 means the submission was accepted — not that the batch is settled.
Request body
| Field | Type | Notes |
|---|---|---|
txHash | string | 0x + 64 hex chars. |
curl -X POST https://api.orbitum.io/api/v1/cex/settlements/CXS-20260902-001/confirm-payment \
-H "X-Api-Key: $ORBITUM_API_KEY" -H "Content-Type: application/json" \
-d '{ "txHash": "0x1234…" }'
Response includes the batch status, legsConfirmed { usdt, orbis }, and
deliveryPending. Rate-limited to 10/min.
Errors
Retryable (transient): CEX_PAYMENT_PENDING_FINALITY, CEX_TX_NOT_FOUND,
CEX_PAYMENT_VERIFICATION_UNAVAILABLE, CEX_BATCH_UNDER_REVIEW. Non-retryable:
CEX_PAYMENT_MISMATCH, CEX_PAID_PAST_DEADLINE, CEX_DEPOSIT_ALREADY_MATCHED,
CEX_BATCH_VOIDED. See the Error Reference.