Workflows Overview

Integrating with Abroad typically involves a three-step process: Quote, Accept, and Pay.

The Lifecycle of a Transaction

1. Create a Quote: You ask Abroad for an exchange rate and fees for a specific amount and currency pair.
2. Accept the Transaction: If the user accepts the quote, you create a transaction. This locks the rate and returns a unique reference plus a payment_context describing where and how to send the funds.
3. Send Funds: You (or the user) send the source funds to the depositAddress from payment_context — with the memo on Stellar, or followed by a /payments/notify call on Solana and Celo.
4. Payout: Once Abroad confirms the incoming funds, we automatically process the payout to the target account.

Abroad also emits webhooks at each step, so you do not have to poll.

The other direction

The flow above moves crypto into local currency. To let a user buy crypto by paying a PIX in Brazilian Reais, see Buy crypto with PIX — the same three steps, with the legs swapped.

For status definitions and webhook behavior, see Status lifecycle and Webhooks.