API Reference – ValuuCards Collection & Payout

COLLECTION FLOW

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

COUNTRY	CURRENCY	PAYLOAD
Kenya +254	KES	{ “currency”: ”KES”, ”payee_number”:”254701364041”, ”amount”:”100-150,000”, ”service_pay”:”Service being paid for”, ”merchant_name”:”Merchant name”, ”ref”:”Unique Identifier / Order Number”, ”callback_url”:”webhook url” }
Uganda +256	UGX	{ “currency”: ”UGX”, ”payee_number”:”256701364041”, ”amount”:”500-1,000,000”, ”service_pay”:”Service being paid for”, ”merchant_name”:”Merchant name”, ”ref”:”Unique Identifier / Order Number”, ”callback_url”:”webhook url”, “payee_name”:”2 Names of the payer”, “payee_bank”:”MTNUGA or AIRUGA” }
Tanzania +255	TZS	{ “currency”: ”TZS”, ”payee_number”:”255701364041”, ”amount”:”1000-2,000,000”, ”service_pay”:”Service being paid for”, ”merchant_name”:”Merchant name”, ”ref”:”Unique Identifier / Order Number”, ”callback_url”:”webhook url”, “payee_name”:”2 Names of the payer”, “payee_bank”:”TIGTZA or AIRTZA or HALTZA” }
Ghana +233	GHS	{ “currency”: ”GHS”, ”payee_number”:”233701364041”, ”amount”:”10-3,000,000”, ”service_pay”:”Service being paid for”, ”merchant_name”:”Merchant name”, ”ref”:”Unique Identifier / Order Number”, ”callback_url”:”webhook url”,
		“payee_name”:”2 Names of the payer”, “payee_bank”:”MTN or AIR or VOD” }
Ivory Coast +225	CFA	{ “currency”: ”CFA”, ”payee_number”:”225701364041”, ”amount”:”100-2,000,000”, ”service_pay”:”Service being paid for”, ”merchant_name”:”Merchant name”, ”ref”:”Unique Identifier / Order Number”, ”callback_url”:”webhook url”, “payee_name”:”2 Names of the payer”, “payee_bank”:”MOMCIV or WAVCIV” }
Benin +229	XOF	{ “currency”: ”CFA”, ”payee_number”:”229701364041”, ”amount”:”100-2,000,000”, ”service_pay”:”Service being paid for”, ”merchant_name”:”Merchant name”, ”ref”:”Unique Identifier / Order Number”, ”callback_url”:”webhook url”, “payee_name”:”2 Names of the payer”, “payee_bank”:”MOOBEN or MTNBEN” }
South Africa +27	ZAR	{ “currency”: ”ZAR”, ”payee_number”:”27701364041”, ”amount”:”10-500,000”, ”service_pay”:”Service being paid for”, ”merchant_name”:”Merchant name”, ”ref”:”Unique Identifier / Order Number”, ”callback_url”:”webhook url”, “payee_name”:”2 Names of the payer”, “payee_email”:”email address”, “payee_bank”:”List of country bank codes shared” }

PAYOUT FLOW

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

COUNTRY	CURRENCY	PAYLOAD
Kenya +254	KES	{ “currency”: ”KES”, ”receiver_number”:”254701364041”, ”amount”:”10-150,000”, ”ref”:”Unique Identifier / Order Number”, ”callback_url”:”webhook url” }
Uganda +256	UGX	{ “currency”: ”UGX”, ”receiver_number”:”256701364041”, ”amount”:”200-2,000,000”, ”ref”:”Unique Identifier / Order Number”, ”callback_url”:”webhook url”, “payto”:”MTNUGA or AIRUGA”, “sender_name”:”Names of sender”, “sender_phone”:”phone number”, “receiver_name”:”names of beneficiary”, }
Tanzania +255	TZS	{ “currency”: ”TZS”, ”receiver_number”:”255701364041”, ”amount”:”200-2,000,000”, ”ref”:”Unique Identifier / Order Number”, ”callback_url”:”webhook url”, “payto”:”TIGTZA or AIRTZA or HALTZA”, “sender_name”:”Names of sender”, “sender_phone”:”phone number”, “receiver_name”:”names of beneficiary”, }
Benin +229	XOF	{ “currency”: ”XOF”, ”receiver_number”:”229701364041”, ”amount”:”200-2,000,000”, ”ref”:”Unique Identifier / Order Number”, ”callback_url”:”webhook url”, “payto”:”MOOBEN or MTNBEN”, “sender_name”:”Names of sender”, “receiver_name”:”names of beneficiary”, }
Ivory Coast +225	CFA	{ “currency”: ”CFA”, ”receiver_number”:”225701364041”, ”amount”:”200-2,000,000”, ”ref”:”Unique Identifier / Order Number”, ”callback_url”:”webhook url”, “payto”:” MOMCIV or WAVCIV”, “sender_name”:”Names of sender”, “sender_phone”:”phone number”, “receiver_name”:”names of beneficiary”, }
South Africa +27	ZAR	{ “currency”: ”ZAR”, ”receiver_number”:”27701364041”, ”amount”:”50-2,000,000”, ”ref”:”Unique Identifier / Order Number”, ”callback_url”:”webhook url”, “payto”:”Refer to Payonus Payout Bank names”, “account_number”:”Beneficiary bank Acc/No”, “bank_code”:”Payonus Bank codes”, “narration”:”Reason for payment/payment details”, }

PAYONUS PAYOUT BANKS

Currently serving South Africa (+27), Currency Code ZAR

Bank Code	Bank Name
632005	ABSA
430000	AFRICAN_BANK
800000	Albaraka Bank
888000	Bank Zero
462005	Bidvest Bank
470010	Capitec Bank
350005	CitiBank
679000	Discovery Bank
250655	RMB
587000	HSBC Bank
580105	Investec
198765	Nedbank
683000	Sasfin Bank
051001	Sasfin Bank
051001	Standard Bank
730020	Standard Chartered Bank
678910	TymeBank
431010	Ubank Limited

PAYONUS COLLETION BANKS

Currently serving South Africa (+27), Currency Code 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

Payaza Banks Reference

Country	Bank Code	Mobile Money
Ghana +233	MTN VOD AIR	MTN MOBILE MONEY VODAFONE CASH AIRTELTIGO MONEY
Uganda +256	MTNUGA AIRUGA TIGTZA	MTN MOBILE MONEY AIRTEL TIGO
Tanzania +255	AIRTZA HALTZA	AIRTEL HALOTEL
Kenya +254	SAFKEN AIRKEN	SAFARICOM AIRTEL
Benin +229	MOOBEN MTNBEN	MOOV MTN
Ivory Coast +225	MOMCIV MOMCIV MOMCIV WAVCIV	MTN ORANGE MOOV WAVE

USD, GBP, EUR, CNY Account Deposits (Passpoint Channel)

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

Country	Currency	Payload
USA +1	USD	{ USA +1 “currency”: ”USD”, ”amount”:”10”, ”service_pay”:”Service being paid for”, ”merchant_name”:”Merchant name”, ”ref”:”Unique Identifier / Order Number”, ”callback_url”:”webhook url”, "senderFirstName": "Joshua", "senderLastName": "Ghaju", "senderAddress": "Plot 331, Raji Rasaki Estate", "senderMobile": "5678761918", "senderEmail": "[e-mail]", "senderCity": "Lagos", "senderZipCode": "5005", "senderIdNumber": "46543345322", "senderIdIssueCountry": "NGA", "senderIdIssueDate": "2022-08-28", "senderIdExpireDate": "2025-09-30",
		"receiverFirstName": "WIKARNDoA", "receiverLastName": "SURATPHAWADEE", "receiverAddress": "Plot 331, Raji Rasak", "receiverState": "Delaware", "receiverCity": "rec-city", "receiverZipCode": "5005", "bankAccountNumber": "9999999999393993939", "bankBranchCode": "067014822", "receiverContactNumber": "18901669689", “channel”:”passpoint” }
GBP (11 Countries)	GBP	{ “currency”: ”GBP”, ”amount”:”10”, ”service_pay”:”Service being paid for”, ”merchant_name”:”Merchant name”, ”ref”:”Unique Identifier / Order Number”, ”callback_url”:”webhook url”, "senderFirstName": "Josh", "senderLastName": "Ghaju", "senderAddress": "Plot 331, Raji Rasaki Estate", "senderCity": "Lagos", "senderZipCode": "5005", "senderIdNumber": "46543345322", "receiverFirstName": "WIKARNDoA", "receiverLastName": "SURATPHAWADEE", "receiverAddress": "Plot 331, Raji Rasak", "receiverCity": "rec-city", "receiverZipCode": "5005", "bankAccountNumber":"GB17BOFS8005510081", “channel”:”passpoint” }
EUR	EUR	{ “currency”: ”EUR”, ”amount”:”10”, ”service_pay”:”Service being paid for”, ”merchant_name”:”Merchant name”, ”ref”:”Unique Identifier / Order Number”, ”callback_url”:”webhook url”, "senderFirstName": "Josh Travels", "senderLastName": "Ghaju", "senderAddress": "Plot 331, Raji Rasaki Estate", "senderCity": "Lagos", "senderZipCode": "5005", "senderIdNumber": "46543345322", "receiverFirstName": "WIKARNDoA", "receiverLastName": "SURATPHAWADEE", "receiverAddress": "Plot 331, Raji Rasak", "receiverCity": "rec-city", "receiverZipCode": "5005", "bankAccountNumber": "DK4900401234567892", “channel”:”passpoint” }
China	CNY	{ “currency”: ”CNY”, ”amount”:”10”, ”service_pay”:”Service being paid for”, ”merchant_name”:”Merchant name”, ”ref”:”Unique Identifier / Order Number”, ”callback_url”:”webhook url”, "senderFirstName": "Josh Travels", "senderLastName": "Ghaju", "senderAddress": "Plot 331, Raji Rasaki Estate", "senderMobile": "5678761918", "senderCity": "Lagos", "senderZipCode": "5005", "senderIdNumber": "46543345322", "senderIdIssueCountry": "NGA", "receiverFirstName": "SEEA", "receiverLastName": "MOI", "receiverContactNumber": "13333333333", "receiverCity": "rec-city", "receiverZipCode": "5005", "receiverIdNumber": "330602198201220041", "receiverIdIssueCountry": "CHN", "receiverIdIssueDate": "2022-08-28",
		"receiverIdExpireDate": "2026-12-12", "bankAccountNumber": "6210281010000312", "bankBranchCode": "067014822", “channel”:”passpoint” }

USD, GBP, EUR Collections (Blaaiz Channel)

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

Currencies	Payload
EUR, USD, GBP	{ “currency”: ”EUR/USD/GBP”, ”amount”:”10”, ”service_pay”:”Service being paid for”, ”merchant_name”:”Merchant name”, ”ref”:”Unique Identifier / Order Number”, ”callback_url”:”webhook url”, “channel”:”blaaiz” }

USD, GBP, EUR Payouts (Blaaiz Channel)

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

Currencies	Payload
EUR	{ “currency”: ”EUR”, ”amount”:”10”, “iban”:””, “bic_code”:””, “street”:”street address”, “city”:”recipients city”, “zip_code”:”Recipients zip code”, ”account_name”:”The recipient's bank account number”, ”ref”:”Unique Identifier / Order Number”, ”callback_url”:”webhook url” }
GBP	{ “currency”: ”GBP”, ”amount”:”10”, “sort_code”:””, “account_number”:”The recipient's bank account number”, ”account_name”:”The recipient's bank account name”, “street”:”street address”, “city”:”recipients city”, “zip_code”:”Recipients zip code”, ”ref”:”Unique Identifier / Order Number”, ”callback_url”:”webhook url” }
USD	{ “currency”: ”GBP”, ”amount”:”10”, “account_number”:”The recipient's bank account number”, ”account_name”:”The recipient's bank account name”, ”payto”:”Bank ID of the customer”, ”ref”:”Unique Identifier / Order Number”, ”callback_url”:”webhook url” }

CAD Collections/Payouts (Blaaiz Channel)

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

Collections	Payouts
{ “type”:”collection”, “interac_email”:”[e-mail]”, “first_name”:”John”, “last_name”:”Doe”, “merchant”:”Name of merchant”, ”amount”:”10”, ”narration”:”reason for payment”, ”ref”:”Unique Identifier / Order Number”, ”callback_url”:”webhook url” }	{ “type”:”payout”, “interac_email”:”[e-mail]”, “first_name”:”John”, “last_name”:”Doe”, “merchant”:”Name of merchant ”, ”amount”:”10”, ”ref”:”Order Number”, ”callback_url”:”webhook url” }