Collections

COLLECTIONS

Collections allow merchants to receive payments from customers via:

• Mobile Money

• Bank transfers

• International deposit channels (Passpoint & Blaaiz)

---

Mobile Money & Bank Collections (Africa)

Endpoint

POST /get_payment

---

Required Fields

Field	Description
currency	Transaction currency
payee_number	Customer mobile number
amount	Amount to collect
service_pay	Description of service
merchant_name	Merchant name
ref	Unique transaction reference
callback_url	Webhook URL

---

Kenya (KES)

{
  "currency": "KES",
  "payee_number": "254701364041",
  "amount": "100",
  "service_pay": "Subscription payment",
  "merchant_name": "Valuu Store",
  "ref": "COLL-KEN-001",
  "callback_url": "https://yourdomain.com/webhook"
}

---

Uganda (UGX)

{
  "currency": "UGX",
  "payee_number": "256701364041",
  "amount": "500",
  "service_pay": "Service payment",
  "merchant_name": "Valuu Store",
  "ref": "COLL-UGA-001",
  "callback_url": "https://yourdomain.com/webhook",
  "payee_name": "John Doe",
  "payee_bank": "MTNUGA"
}

---

Ghana (GHS)

{
  "currency": "GHS",
  "payee_number": "233701364041",
  "amount": "10",
  "service_pay": "Product purchase",
  "merchant_name": "Valuu Store",
  "ref": "COLL-GHA-001",
  "callback_url": "https://yourdomain.com/webhook",
  "payee_name": "John Doe",
  "payee_bank": "MTN"
}

---

South Africa (ZAR – Bank)

{
  "currency": "ZAR",
  "payee_number": "27701364041",
  "amount": "50",
  "service_pay": "Invoice payment",
  "merchant_name": "Valuu Store",
  "ref": "COLL-ZA-001",
  "callback_url": "https://yourdomain.com/webhook",
  "payee_name": "John Doe",
  "payee_email": "[email protected]",
  "payee_bank": "STANDARD_BANK"
}

---

Collection Response

{
  "status": "success",
  "message": "Payment request initiated",
  "transaction_ref": "COLL-KEN-001"
}

Blaaiz Channel (USD, GBP, EUR)

Collections

{
  "currency": "EUR",
  "amount": "10",
  "service_pay": "Service payment",
  "merchant_name": "Valuu Store",
  "ref": "BLZ-COLL-001",
  "callback_url": "https://yourdomain.com/webhook",
  "channel": "blaaiz"
}

Collection

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