Onramp - Pretium

Onramp collects mobile money (or similar) from a customer, then releases crypto to an address you provide.

Flow

Call POST /v1/onramp/{currency_code} with phone/network, amount, destination address, chain, and asset.
Customer completes the collection prompt (e.g. STK push).
Poll status or wait for a webhook; when collection completes, assets are released on-chain.

Networks & assets

Chain	Asset
`BASE`	`USDC`
`CELO`	`USDT`

Only BASE and CELO are accepted for onramp.

Amount limits

Per-transaction min/max by currency and mobile money network: Limits.

Example (KES)

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",
    "callback_url": "https://example.com/hooks/pretium"
  }'

Check POST /v2/exchange-rate for is_onramp_active before starting collections.

⌘I