Introduction

ValuuCards API Documentation

Welcome to the ValuuCards API Reference. This documentation guides developers on how to integrate Collections and Payouts across Africa and international corridors using ValuuCards.

---

Base URL

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

Authentication

All API requests must include your API credentials in the request headers.

Headers

Key	Value
Content-Type	application/json
Authorization	Bearer YOUR_API_KEY

WEBHOOKS (CALLBACKS)

Overview

All transactions send asynchronous updates to your callback_url.

Sample Webhook Payload

{
  "status": "successful",
  "ref": "COLL-KEN-001",
  "amount": "100",
  "currency": "KES",
  "message": "Transaction completed successfully"
}

Possible Status Values

• pending

• successful

• failed

---

ERROR HANDLING

Error Response

{
  "status": "error",
  "message": "Invalid payee number",
  "code": "400"
}

---

BANK & NETWORK REFERENCES

South Africa – Payout Banks (ZAR)

Code	Bank
051001	Standard Bank
470010	Capitec
198765	Nedbank
580105	Investec
678910	TymeBank

---

Mobile Money Codes

Country	Code	Network
Ghana	MTN	MTN Mobile Money
Kenya	SAFKEN	Safaricom
Uganda	MTNUGA	MTN Uganda
Tanzania	AIRTZA	Airtel Tanzania
Ivory Coast	MOMCIV	MTN
Benin	MOOBEN	Moov

PASSPOINT CHANNEL

USD • GBP • EUR • CNY

Account Deposits (International)

Endpoint (Full URL):

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

Example – USD (USA)

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

🇨🇦 CANADA – INTERAC (BLAAIZ)

Collections & Payouts

Endpoint (Full URL):

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

Collection

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

Payout

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