What is a transaction?
Transactions move value through the platform. Each transaction includes:- A type defining the direction of the conversion
- Source and target currencies with amounts
- A lifecycle status tracking progress
- Payment details and receipts upon completion
Transaction types
| Type | Description | Example |
|---|---|---|
| On-ramp | Converts fiat to stablecoins—customer sends fiat and receives stablecoins in their wallet | Deposit BRL via PIX, receive USDC |
| Off-ramp | Converts stablecoins to fiat—customer’s stablecoins are sent to a bank account | Convert USDC to USD via wire transfer |
| Transfer | Moves stablecoins between wallets without conversion—to another customer or external address | Send USDC to another customer’s wallet |
| Payment Q1/2026 | Fiat-to-fiat cross-border payments using stablecoins as settlement layer | Send BRL, recipient receives USD |
Transaction lifecycle
Each transaction type follows a specific status progression as it moves through the system.- On-ramp
- Off-ramp
- Transfer
AWAITING_FUNDS → TRANSFERRING_FIAT → TRADING → TRANSFERRING_STABLECOIN → SUCCESSIf the transaction fails, it may transition to FAILED → REFUNDING → REFUNDED.Subscribe to webhooks to receive real-time notifications when transaction statuses change.
Transaction purpose
Every on-ramp and off-ramp transaction requires a purpose code that describes the reason for the fund movement. This is required for compliance with international payment regulations.| Purpose | Use case |
|---|---|
PERSONAL_ACCOUNT | Personal transfers to own accounts (requires SELF bank account relationship) |
INVESTMENT | Investment-related transactions |
REAL_ESTATE | Real estate purchases or payments |
TRADE_TRANSACTIONS | Commercial trade and goods |
TAX | Tax payments |
LOAN | Loan disbursements or repayments |
BILLS | Bill payments |
EXPENSES_REIMBURSEMENT | Expense reimbursements |
PROFESSIONAL_SERVICES | Professional service payments |