curl -X POST "{{base_url}}/kes/bank-transfer" \
-H "x-api-key: YOUR_CONSUMER_KEY" \
-H "Content-Type: application/json" \
-d '{
"amount": 500,
"account_number": "001918181",
"bank_code": "247247",
"callback_url": "https://example.com/hooks/pretium"
}'
{
"code": 200,
"message": "Message",
"data": {
"status": "PENDING",
"transaction_code": "045c1753-4e5b-4fa8-997b-ee52b78a96fa",
"message": "Success! Processing payment..."
}
}
{
"code": 400,
"message": "Failed - Bad Request"
}
Banks
Bank transfer
Settle a wallet-funded disbursement to a recipient bank account.
POST
/
{currency_code}
/
bank-transfer
curl -X POST "{{base_url}}/kes/bank-transfer" \
-H "x-api-key: YOUR_CONSUMER_KEY" \
-H "Content-Type: application/json" \
-d '{
"amount": 500,
"account_number": "001918181",
"bank_code": "247247",
"callback_url": "https://example.com/hooks/pretium"
}'
{
"code": 200,
"message": "Message",
"data": {
"status": "PENDING",
"transaction_code": "045c1753-4e5b-4fa8-997b-ee52b78a96fa",
"message": "Success! Processing payment..."
}
}
{
"code": 400,
"message": "Failed - Bad Request"
}
Settles a disbursement to a recipient bank account from your Pretium wallet balance. Track it afterwards with
POST /{currency_code}/status using the returned transaction_code.
string
required
Lowercase market prefix, e.g.
kes.number
required
Amount to transfer. For
kes the allowed range is 100 – 250,000.string
required
Recipient bank account number.
string
required
Bank code from List banks.
string
Optional URL for payment notification.
string
Optional unique reference used as the
transaction_code. Auto-generated if omitted.curl -X POST "{{base_url}}/kes/bank-transfer" \
-H "x-api-key: YOUR_CONSUMER_KEY" \
-H "Content-Type: application/json" \
-d '{
"amount": 500,
"account_number": "001918181",
"bank_code": "247247",
"callback_url": "https://example.com/hooks/pretium"
}'
{
"code": 200,
"message": "Message",
"data": {
"status": "PENDING",
"transaction_code": "045c1753-4e5b-4fa8-997b-ee52b78a96fa",
"message": "Success! Processing payment..."
}
}
{
"code": 400,
"message": "Failed - Bad Request"
}