Payout

PAYOUTS

Overview

Payouts allow merchants to send money to:

• Mobile wallets

• Bank accounts

• International beneficiaries

---

Mobile Money & Bank Payouts (Africa)

Endpoint

POST /make_payment

---

Kenya (KES)

{
  "currency": "KES",
  "receiver_number": "254701364041",
  "amount": "10",
  "ref": "PAY-KEN-001",
  "callback_url": "https://yourdomain.com/webhook"
}

---

Uganda (UGX)

{
  "currency": "UGX",
  "receiver_number": "256701364041",
  "amount": "200",
  "ref": "PAY-UGA-001",
  "callback_url": "https://yourdomain.com/webhook",
  "payto": "MTNUGA",
  "sender_name": "Valuu Store",
  "sender_phone": "256700000000",
  "receiver_name": "Jane Doe"
}

---

South Africa (ZAR – Bank)

{
  "currency": "ZAR",
  "receiver_number": "27701364041",
  "amount": "50",
  "ref": "PAY-ZA-001",
  "callback_url": "https://yourdomain.com/webhook",
  "payto": "STANDARD_BANK",
  "account_number": "1234567890",
  "bank_code": "051001",
  "narration": "Vendor payment"
}

---

Payout Response

{
  "status": "success",
  "message": "Payout initiated",
  "transaction_ref": "PAY-ZA-001"
}

---

INTERNATIONAL PAYMENTS

Passpoint Channel (USD, GBP, EUR, CNY)

Endpoint

POST /make_deposit

Used for international bank deposits requiring sender & receiver KYC details.

{
  "currency": "USD",
  "amount": "10",
  "service_pay": "Tuition payment",
  "merchant_name": "Valuu Store",
  "ref": "PASS-USD-001",
  "callback_url": "https://yourdomain.com/webhook",
  "channel": "passpoint"
}

---

Payouts

POST /pay_account

---

CAD (Canada) – Interac

Endpoint

POST /cad_payments

Payout

{
  "type": "payout",
  "interac_email": "[email protected]",
  "first_name": "John",
  "last_name": "Doe",
  "merchant": "Valuu Store",
  "amount": "10",
  "ref": "CAD-PAY-001",
  "callback_url": "https://yourdomain.com/webhook"
}