Introduction

API Reference – ValuuCards Collection & Payout

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

API Reference – ValuuCards Collection & Payout This API reference provides developers with comprehensive guidance on integrating ValuuCards’ Collection and Payout services into their applications.

Collections enable businesses to securely receive payments from customers through supported payment channels, ensuring fast and reliable fund capture. Payouts allow businesses to disburse funds to users, partners, or bank accounts seamlessly, supporting automated and controlled fund transfers.

The documentation details available endpoints, authentication requirements, request and response formats, and error handling to ensure secure, scalable, and efficient transaction processing within the ValuuCards ecosystem.