Prerequisites
Before you begin, make sure you have:- A User with
GLOBAL_NETWORK
Rail enabled - Valid payment method (bank account, card, etc.)
Step 1: Create Account
POST/v2/users/{userId}/accounts
Step 2: Create Onramp
Create the onramp transaction directly: POST/v2/onramps
Response Breakdown
transferDetails.source
transferDetails.source
Information about the source of funds (NGN account). Includes user details, currency, transfer type, and amount.
transferDetails.destination
transferDetails.destination
Information about the destination (USDC wallet). Includes wallet address, chain, user details, and external wallet ID.
transferDetails.receipt
transferDetails.receipt
Transaction receipt information. The
transactionHash
will be populated once the USDC is sent to your wallet.transferDetails.quoteInformation
transferDetails.quoteInformation
Exchange rate and fee breakdown including:
sendGross
: Total amount you’re sendingsendNet
: Amount after feesrailFee
: Fee charged by the payment railreceiveGross
: Total USDC you’ll receivereceiveNet
: USDC after all feesrate
: Exchange rateexpiresAt
: When the quote expires
transferDetails.depositInfo
transferDetails.depositInfo
Bank deposit information for ACH transfers. Includes:
bankName
: Name of the bankbankAddress
: Bank’s addressaccountNumber
: Account number for depositsroutingNumber
: Bank routing numberbeneficiary
: Recipient informationreferenceId
: Unique reference for your depositamount
: Exact amount to depositinstruction
: Deposit instructions
Refresh Quote
While the quote is still valid, you can refresh it to get updated rates: POST/v2/onramps/{transferId}/quote/refresh
AWAITING_FUNDS
status and before the quote expires.
Step 3: Accept Quote
Once you’re satisfied with the quote, accept it to proceed with the onramp: POST/v2/onramps/{transferId}/quote/accept
Step 4: Send Bank Deposit
Use the deposit information from the response to send funds:- Bank Name: Bank of Nowhere
- Account Number: 11223344556677
- Routing Number: 123456789
- Reference ID: BRGWX4J5BB7MP693BT8Z
- Amount: 60000.00 NGN (exact amount)
- Beneficiary: HiFi Bridge
Step 5: Confirm Transaction
Listen for Webhooks
Set up webhook notifications to track status changes: Webhook Events:ONRAMP.CREATE
- Creation for onrampsONRAMP.UPDATE
- Updates for onramps
Check Wallet Balance
Verify the USDC has been received in your wallet: GET/v2/users/{userId}/wallets/balance