Skip to main content

​
Onramp

Convert fiat to crypto and deliver to a designated wallet. Type: onramp

​
How onramps work

  1. Deposit fiat currency from your bank account
  2. Convert it into cryptocurrency
  3. Receive crypto in your designated Conduit custody wallet

​
Key fields

  • Source: bank account ID (bank_...) : where fiat comes from
  • Destination: Conduit custody wallet ID (wlt_...) : where crypto is credited
  • Quote: valid quote ID for the conversion rate
  • Purpose (optional): transaction purpose code
  • Documents (optional): supporting documents for the transaction
  • Reference (optional): transaction reference

​
Transaction flow

  1. Create a quote: get the current conversion rate
  2. Create the onramp transaction: use your payment method IDs and the quote
  3. Receive deposit instructions: use the provided deposit instructions to send your fiat payment to Conduit
  4. Send your fiat payment: use the provided deposit instructions; Conduit converts and delivers crypto to your custody wallet

​
Transaction status flow

Your transaction progresses through these stages:
  • Initializing: transaction is being set up
  • Created: transaction created, deposit instructions available
  • Awaiting funds: waiting for your fiat payment to arrive
  • Funds received: your payment has been received
  • Processing settlement: converting and sending crypto to your Conduit custody wallet
  • Completed: crypto delivered to your Conduit custody wallet

​
Deposit instruction types

Depending on your source currency, deposit instructions may include:
  • USD: SWIFT or Fedwire
  • BRL: TED or PIX
  • MXN: SPEI
  • EUR: SEPA
  • NGN: NIP

​
Common use cases

  • Crypto portfolio funding
  • Business crypto acquisition
  • Cross-border payments setup

​
Best practices

  • Send the fiat payment promptly after creating the transaction; monitor quote validity
  • Ensure the source bank account is verified and matches the request
  • Keep records of payment instructions, confirmations, and supporting documents
  • Track transaction status via API or webhooks; set alerts for failures

​
Troubleshooting

  • Invalid or expired quote: generate a new quote and retry
  • Source account not verified: complete verification for the source account
  • Unsupported destination: confirm the wallet supports the asset and network
  • Amount mismatch: send the exact quoted amount and include all required references

​
What’s next?

Now that you know what an onramp is and how it works, learn how to create one by following Creating an Onramp Transaction. For full request details, see the API Reference.

​
Support

Reach out to our support team to get help and share your feedback.
⌘I