curl -X POST "{{base_url}}/v1/onramp/KES" \
-H "x-api-key: YOUR_CONSUMER_KEY" \
-H "Content-Type: application/json" \
-d '{
"shortcode": "254712345678",
"amount": 500,
"mobile_network": "Safaricom",
"address": "0xYourWallet",
"chain": "BASE",
"asset": "USDC"
}'
Payments (v1)
Onramp
Collect fiat via mobile money and release stablecoins to an address. Amount limits are per transaction.
POST
/
v1
/
onramp
/
{currency_code}
curl -X POST "{{base_url}}/v1/onramp/KES" \
-H "x-api-key: YOUR_CONSUMER_KEY" \
-H "Content-Type: application/json" \
-d '{
"shortcode": "254712345678",
"amount": 500,
"mobile_network": "Safaricom",
"address": "0xYourWallet",
"chain": "BASE",
"asset": "USDC"
}'
Starts a local collection and, after success, releases crypto to the destination wallet.
string
required
e.g.
KES, UGX, GHS, MWK, CDF.string
required
Customer phone / mobile money number (10 digits for KES/UGX).
string
required
Network operator for the market (e.g.
Safaricom, Airtel, MTN).string
required
Destination wallet address for released assets.
string
required
BASE or CELO.string
required
USDC on BASE; USDT on CELO.string
Optional webhook URL.
string
Optional client reference.
Amount limits
Per-transaction min/max by currency: Limits.curl -X POST "{{base_url}}/v1/onramp/KES" \
-H "x-api-key: YOUR_CONSUMER_KEY" \
-H "Content-Type: application/json" \
-d '{
"shortcode": "254712345678",
"amount": 500,
"mobile_network": "Safaricom",
"address": "0xYourWallet",
"chain": "BASE",
"asset": "USDC"
}'