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/UGX

Body Request

---

Name	Type	Description
shortcode	String	Customer's phone number
amount	Integer	Amount to collect
mobile_network	String	Mobile money network i.e MTN, or Airtel
chain	String	CELO, BASE or STELLAR
asset	String	USDT, USDC or CUSD
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"
}