Skip to main content
POST
Create Onramp
You can create an onramp request with either mobile money or bank checkout to convert fiat to crypto.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
fiatAmount
number
required

Fiat amount

currency
string
required

The currency of the wallet

Example:

"KES"

chain
enum<string>
required

Chain

Available options:
ETHEREUM,
CELO,
AVALANCHE,
POLYGON,
ARBITRUM,
OPTIMISM,
BINANCE,
STELLAR,
TRON,
FUSE,
LIGHTNING,
SOLANA,
PROVENANCE,
CARDANO,
HEDERA,
BASE,
LISK,
VICTION,
SCROLL
token
enum<string>
required

Stable Coin

Available options:
CUSD,
USDC,
USDT,
USDT0,
SAT,
BTC,
HASH,
FUSE,
HBAR,
USDGLO,
CKES,
CGHS,
MSAT,
XLM,
ADA
receiverAddress
string
required

Receiver address

referenceId
string
required

Reference ID

mobileMoney
object

Mobile Money details

bankCheckout
object

Bank Checkout details

callbackUrl
string

Webhook URL for the terminal status. Falls back to your default webhook URL.

rateId
string

Rate ID

fiatWalletId
string

Links this transaction to a fiat wallet for currency resolution. No fiat is debited.

Response

success
boolean
Example:

true

message
string
Example:

"Request has been successfully created"

data
object