Skip to main content

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​

FieldTypeNotes
txHashstring0x + 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.