Search...
Log inGet started
Airwallex logo
Home
Core API
Payments
Transactional FX
Payouts
Issuing
Back to home
OverviewHow Transactional FX worksSupported regions and currenciesFunding and settlement models
Use Cases
Amendments
Conversion amendmentsCancel a conversion
Conversion statuses
Troubleshooting
Test and go live
Legacy FX APIs

Conversion statuses

This page describes the status transitions for the conversions object when a conversion is booked.

fx status flow diagram

Status Description Emitted webhook Next steps
SCHEDULED The conversion has been booked and scheduled for settlement on the conversion date. conversion.scheduled Ensure you have sufficient funds in the sell currency Wallet by settlement date for the conversion to be SETTLED. You can cancel (CANCELLED) unsettled conversions using Create an amendment API.
SETTLED Funds have settled into the Wallet. conversion.settled No action needed.
OVERDUE The settlement attempt has failed due to insufficient funds in the sell currency Wallet past settlement cut-off time for customers in post-funded mode. conversion.overdue Fund your sell currency Wallet to ensure the conversion is SETTLED. You can cancel (CANCELLED) unsettled conversions using Create an amendment API.
CANCELLED Conversion was cancelled. Funds have returned to client's Wallet. conversion.cancelled No action needed.