Onramp

This endpoint calls the Pretium payment protocol to initiate cash collection from the user, confirm receipt via mobile money or bank transfer, and release the equivalent amount in stablecoins.

POST {{uri}}/v1/onramp/KES

Body Request

---

Name	Type	Description
shortcode	String	Customer's phone number
amount	Integer	Amount to collect
mobile_network	String	Mobile money network i.e Safaricom, or Airtel
chain	String	BASE ,CELO or STELLAR
asset	String	USDT, USDC or CUSD
address	String	0x3Eaab84B42F9fCf2A9B3f2FDB83572B4153eE958
callback_url	URL	URL to receive payment notification

Sample Request

{
    "shortcode": "0725212418",
    "amount": 1000,
    "mobile_network": "Safaricom",
    "chain": "BASE",
    "asset": "USDC",
    "address": "0x3Eaab84B42F9fCf2A9B3f2FDB83572B4153eE958",
    "callback_url": "https://pretium.africa/b2c/log-test"
}

200 - Success

{
    "code": 200,
    "message": "Prompt sent",
    "data": {
        "status": "PENDING",
        "transaction_code": "DDM6D",
        "message": "Success! Processing payment..."
    }
}

400 - Bad Request

{
   "code": 400,
   "message": "Failed - Bad Request"
}