Business Onramp

Initiate a fiat → stablecoin onramp for a business. You’ll provide core transaction details (business, currency, amount, stable, vendor, wallet, network) and the payer’s account details in a nested block matching the currency/rail you used to send funds.

⚠️ Only one nested block is required per request.

Request Body

Field	Type	Description
customer_id	string	Your Business customer_id
currency	string	Fiat currency you paid in (e.g., USD, GBP, NGN). See Fiat Payment Methods.
amount	string	Fiat amount you paid (as string for precision).
stables	string	Stablecoin you’d like to receive (e.g., USDC, USDT).
vendor_id	string	The payout vendor to use. Retrieve via Get Payment Vendors.
wallet_address	string	Destination wallet address to receive the stablecoin.
network	string	Blockchain network for the stablecoin (e.g., Solana, Polygon)
proof_of_payment	string	A URL pointing to your payment proof. The uploaded file must display your company letterhead, no larger than 5MB. Accepted formats are PDF, JPEG, JPG, or PNG. Example: https://res.cloudinary.com/r.........png.
payment details	object	The account used to send fiat. Format depends on currency and payment rail (see table below).

Quick-choose table

Pick the nested block that matches the currency and payment rail you used to send fiat.

Currency	Payment Rail / Corridor	Nested Block	Required Fields
USD	Domestic ACH / Wire	usd_domestic	account_number, routing_number (+ ach_routing_number, fedwire_routing_number, bank_name if available)
USD	International (IBAN corridors)	iban	iban, swift_code (optional)
GBP	Domestic Faster Payments	gbp_domestic	account_number, sort_code, bank_name
ILS, GBP, MXN, SGD	International (IBAN corridors)	iban	iban, swift_code
EUR, AED, CNY, CAD, HKD, ZAR & AUD	International (IBAN corridors)	iban	iban, swift_code
AED, SGD, HKD, CNY & ILS	Local bank transfer	bank_transfer	account_number, bank_code, branch_code (swift_code optional)
NGN	Domestic transfer	ngn_domestic	account_number, bank_name
AUD	Domestic transfer	aud_domestic	account_number, bsb
EUR	Domestic transfer	iban	iban
CAD	EFT	cad_eft	account_number, transit_number, institution_number
CAD	Interac e-Transfer	cad_interac	interac_email
BRL	PIX	brl_pix	pix_key, (qr_code optional)
MXN	Domestic transfer	mxn_clabe	clabe
PHP	Bank Transfer	php_bank_transfer	account_number, bank_name
PHP	E-wallet	php_ewallet	ewallet_account_number

JSON request examples

{
  "customer_id": "08********",
  "currency": "USD",
  "amount": "15000.00",
  "stables": "USDC",
  "vendor_id": "9146827350",
  "wallet_address": "YourWalletAddressHere",
  "network": "solana",
  "usd_domestic": {
    "account_number": "875104368977",
    "routing_number": "125109019",
    "ach_routing_number": "026073150",
    "fedwire_routing_number": "026073008",
    "bank_name": "Coastal Community Bank"
  }
}

{
  "business_id": "084*******",
  "currency": "GBP",
  "amount": "25000.00",
  "stables": "USDC",
  "vendor_id": "6283947015",
  "wallet_address": "0xYoursolAddress",
  "network": "solanan",
  "gbp_domestic": {
    "account_number": "04555464",
    "sort_code": "041907",
    "bank_name": "Barclays"
  }
}

{
  "business_id": "084*******",
  "currency": "EUR",
  "amount": "100000.00",
  "stables": "USDT",
  "vendor_id": "4758291630",
  "wallet_address": "YourWallet",
  "network": "solana",
  "iban": {
    "iban": "NL02AINH0232055238",
    "swift_code": "ABNANL2A"
  }
}

{
  "business_id": "084*******",
  "currency": "SGD",
  "amount": "120000.00",
  "stables": "USDC",
  "vendor_id": "5924816037",
  "wallet_address": "YourSolanaWallet",
  "network": "solana",
  "bank_transfer": {
    "account_number": "8853870376",
    "bank_code": "7171",
    "branch_code": "072",
    "swift_code": "DBSSSGSG"
  }
}

{
  "business_id": "084*******",
  "currency": "CAD",
  "amount": "2500.00",
  "stables": "USDC",
  "vendor_id": "4926381057",
  "wallet_address": "YourSolanaWallet",
  "network": "solana",
  "cad_interac": {
    "interac_email": "[email protected]"
  }
}

{
  "business_id": "084*******",
  "currency": "PHP",
  "amount": "520000.00",
  "stables": "USDT",
  "vendor_id": "8205639174",
  "wallet_address": "YourWallet",
  "network": "solana",
  "php_bank_transfer": {
    "account_number": "447853760386",
    "bank_name": "DCPay Philippines"
  }
}