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"
}

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"
}

⌘I

Overview

Account

Rates

Payments (v1)

Banks

Checkout

Collection & disbursement