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

---

Endpoint (URL)

POST https://api.valuucards.com/api/v2/get_payment

Request Headers

Key	Value
Content-Type	application/json
Authorization	Bearer YOUR_API_KEY

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 COLLECTIONS (+254)

Currency: KES Supported Channels: Mobile Money

Supported Mobile Money Networks (Kenya)

Code	Network Name	Description
SAFKEN	Safaricom	M-Pesa (Safaricom)
AIRKEN	Airtel Kenya	Airtel Money Kenya

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 (+256)

Collections – Uganda

Currency: UGX Endpoint (Full URL):

POST https://api.valuucards.com/api/v2/get_payment

Supported Mobile Money Networks (Uganda)

Code	Network Name	Description
MTNUGA	MTN Uganda	MTN Mobile Money
AIRUGA	Airtel Uganda	Airtel Money
TIGTZA	Tigo	Tigo Money

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 COLLECTIONS (+233)

Currency: GHS Supported Channels: Mobile Money

Supported Mobile Money Networks (Ghana)

Code	Network Name	Description
MTN	MTN Mobile Money	MTN MoMo Ghana
VOD	Vodafone Cash	Vodafone Cash Ghana
AIR	AirtelTigo Money	AirtelTigo Mobile Money

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

---

🇹🇿 TANZANIA (+255)

Collections – Tanzania

Currency: TZS Endpoint (Full URL):

POST https://api.valuucards.com/api/v2/get_payment

Supported Mobile Money Networks (Tanzania)

Code	Network Name
AIRTZA	Airtel Tanzania
HALTZA	Halotel
TIGTZA	Tigo

Example Collection Request – Tanzania

{
  "currency": "TZS",
  "payee_number": "255701364041",
  "amount": "1000",
  "service_pay": "Utility payment",
  "merchant_name": "Valuu Merchant",
  "ref": "TZA-COLL-001",
  "callback_url": "https://yourdomain.com/webhook",
  "payee_name": "John Doe",
  "payee_bank": "AIRTZA"
}

🇧🇯 BENIN (+229)

Collections – Benin

Currency: XOF Endpoint (Full URL):

POST https://api.valuucards.com/api/v2/get_payment

Supported Mobile Money Networks (Benin)

Code	Network Name
MOOBEN	Moov
MTNBEN	MTN Benin

Example Collection Request – Benin

{
  "currency": "XOF",
  "payee_number": "229701364041",
  "amount": "100",
  "service_pay": "Service payment",
  "merchant_name": "Valuu Merchant",
  "ref": "BEN-COLL-001",
  "callback_url": "https://yourdomain.com/webhook",
  "payee_name": "John Doe",
  "payee_bank": "MOOBEN"
}

🇨🇮 IVORY COAST (+225)

Collections – Ivory Coast

Currency: CFA Endpoint (Full URL):

POST https://api.valuucards.com/api/v2/get_payment

Supported Mobile Money Networks (Ivory Coast)

Code	Network Name
MOMCIV	MTN Mobile Money
ORANGE	Orange Money
MOOV	Moov Money
WAVCIV	Wave

Example Collection Request – Ivory Coast

{
  "currency": "CFA",
  "payee_number": "225701364041",
  "amount": "100",
  "service_pay": "Subscription payment",
  "merchant_name": "Valuu Merchant",
  "ref": "CIV-COLL-001",
  "callback_url": "https://yourdomain.com/webhook",
  "payee_name": "John Doe",
  "payee_bank": "WAVCIV"
}

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

🇿🇦 South Africa – Collection Banks (ZAR)

Bank Code	Bank Name
0001	Bank Name
0002	African Bank
0003	Bidvest Bank
0006	FNB
0007	Investec
0008	Nedbank
0009	Standard Bank
0010	Tyme Bank

BLAAIZ CHANNEL

Collections (USD, GBP, EUR)

Endpoint (Full URL):

POST https://api.valuucards.com/api/v2/make_deposit

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