Conversion statuses (legacy API versions)
This page applies for API version 2024-06-14 or earlier.
Conversions have different status types and state transitions. There are two types of status: Intermediate (transition) and Terminal (final).
| STATUS | DESCRIPTION | EMITTED WEBHOOK | NEXT STEPS |
|---|---|---|---|
AWAITING_FUNDS | Intermediate status. Conversion booked successfully, and waiting for client funds. Post-fund pending deduction state. | conversion.awaiting_funds | On the settlement date, if there are sufficient funds in sell currency, the conversion will transition to PENDING_SETTLEMENT and then be immediately SETTLED. |
You can cancel (CANCELLED) unsettled conversions using the Create an amendment API API . See Funding and settlement models for more information. | |||
PENDING_SETTLEMENT | Intermediate status. Conversion is processing. Pre-fund future-dated conversions pending settlement state. | conversion.pending_settlement | On the settlement date, the conversion will transition to SETTLED. You can cancel (CANCELLED) unsettled conversions using the Create an amendment API API. See Funding and settlement models for more information. |
CANCELLED | Terminal status. Conversion cancelled. Funds returned to client wallet. | conversion.cancelled | No action needed. |
SETTLED | Terminal status. Funds have been settled in the wallet. | conversion.settled | No action needed. |
ROLLOVER_REQUESTED | Deprecated | conversion.rollover_requested | N/A |
PENDING_ROLLOVER | Deprecated | conversion.pending_rollover | N/A |