Skip to main content
A payout is EQX’s primary integrator→beneficiary flow. It converts a stablecoin amount into local fiat delivered to a beneficiary’s mobile money wallet or bank account.

​
Flow overview

​
Quotes

A quote locks a conversion rate for a specific corridor and amount. Quotes expire after 90 seconds. You must commit the quote before it expires. Key quote fields:

​
Payout transactions

Committing a quote creates a payout transaction. The transaction moves through these statuses:

​
Reliability expectations

EQX is designed, monitored, and operated to get as close to a 100% successful payout rate as possible. We validate requests before dispatch, reserve liquidity before execution, use idempotency for safe retries, and reconcile ambiguous provider responses instead of silently dropping them. Some payout outcomes still depend on external bank, mobile money, switch, and provider systems. A transaction can be delayed, rejected, reversed, or marked for reconciliation because of beneficiary account issues, network downtime, provider limits, compliance checks, or responses returned by the receiving institution. Always use the transaction status endpoint and webhooks as the source of truth for final payout state. Treat COMPLETED as successful delivery, FAILED as terminal failure, and RECONCILIATION_REQUIRED as an operational review state until EQX confirms the final outcome.

​
Pagination

GET /v1/api/transactions supports offset pagination via page and per_page query parameters. Default page size is 20; maximum is 100.