How Onramps Work
Onramps follow a simple three-step process:- Create an onramp – Initiate a payment from an Account into a Wallet
- Review quote – Examine the exchange rate, fees, and quote validity period
- Send money – Transfer the fiat currency to the provided bank account using the reference ID
Quote Validity
Quotes are time-sensitive and typically expire within 24 hours. This ensures you get current market rates and prevents stale pricing. If a quote expires before you deposit funds, you’ll need to create a new onramp request to get updated pricing.All USDT-related onramps incur an additional 0.1% exchange fee, which will be reflected on your monthly invoice.
Transaction Structure
When you create an onramp, the API response includes detailed information about the transaction:Source
Source
Destination
Destination
Quote
Quote
Deposit Info
Deposit Info
Transaction Status
1. Transaction Creation PhaseCREATED: The transaction request has been successfully created.NOT_INITIATED: The transaction was not submitted due to a validation error.
OPEN_QUOTE: A quote has been generated and is awaiting user acceptance.QUOTE_FAILED: The transaction failed or expired before the quote was accepted.AWAITING_FUNDS: Waiting for funds to be sent to the provided deposit instruction.
FIAT_INITIATED: The fiat transaction process has started.FIAT_PENDING: The fiat transaction is in progress and awaiting processing.FIAT_PROCESSED: The fiat transaction has been successfully processed.FIAT_FAILED: The fiat transaction failed due to an error.FIAT_RETURNED: The fiat funds were returned after a failed transaction.
CRYPTO_INITIATED: The crypto transaction process has started.CRYPTO_PENDING: The crypto transaction is in progress and awaiting on-chain confirmation.CRYPTO_FAILED: The crypto transaction failed due to an error.COMPLETED: The transaction has been successfully confirmed on-chain.
Flow Chart

Deposit Information
ThedepositInfo object contains all the details you need to complete your fiat deposit:
- Bank details: Account number, routing number, and bank address
- Beneficiary information: Name and address of the receiving entity
- Reference ID: Unique identifier you must include with your deposit
- Amount: Exact amount to deposit (must match exactly)
- Instructions: Specific guidance for completing the deposit
Always use the exact reference ID provided in the deposit information when making your fiat transfer. This ensures your funds are properly credited to your onramp transaction.
Quote Information
The quote includes both gross and net amounts for both sending and receiving:- sendGross: Total amount you’re sending in fiat currency
- sendNet: Net amount after any rail fees are deducted
- receiveGross: Total amount you’ll receive in stablecoins
- receiveNet: Net amount you’ll actually receive
- rate: Current exchange rate between fiat and stablecoin
- expiresAt: When the quote expires and you’ll need a new one
Settlement Rules
You can configure settlement rules to automatically calculate and distribute fees for onramp transactions. Settlement rules support:- Percentage-based or fixed fee structures
- Tiered pricing based on transaction volume
- Fee distribution to multiple wallet addresses
- Network-specific configurations
Settlement Rules
Learn how to configure fee calculations and distribution
Try it out
Convert USD to USDC
Learn how to pay in to a Wallet