API Reference – ValuuCards Collection & Payout

COLLECTION FLOW

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

Example Request

Kenya
{
“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”
}

Header

Key	Description
currency	KES
service_pay	Service being paid for
callback_url	webhook url

Example Request

Uganda
{
“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”
}

Header

Key	Description
currency	UGX
service_pay	Service being paid for
callback_url	webhook url

Example Request

Tanzania
{
“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”
}

Header

Key	Desc
currency	TZS
service_pay	Service being paid for
callback_url	webhook url

Example request

Ghana
{
“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”,2 Names of the payer”,
“payee_bank”:”TIGTZA or AIRTZA or HALTZA”
“payee_name”:”2 Names of the payer”,
“payee_bank”:”MTN or AIR or VOD”
}

Header

Key	Desc
currency	GHS
service_pay	Service being paid for

Example Request

Ivory
Coast
{
“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”
}

Header

Key	Desc
currency	CFA
payee_number	225701364041
callback_url	webhook url

Example Request

Benin
{
“currency”: ”XOF”,
”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”
}

Header

Key	Desc
currency	XOF
service_pay	Service being paid for
payee_bank	MOOBEN or MTNBEN”

Example Request

South
Africa
{
“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”
}

Header

Key	Desc
currency	ZAR
service_pay	Service being paid for

PAYOUT FLOW

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

Example request

Kenya
{
“currency”: ”KES”,
”receiver_number”:”254701364041”,
”amount”:”10-150,000”,
”ref”:”Unique Identifier / Order Number”,
”callback_url”:”webhook url”
}

Header

Key	Desc
currency	KES
callback_url	webhook url
amount	10-150,000

Example Request

Uganda
{
“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”,
}

Header

key	desc
currency	UGX
callback_url	MTNUGA or AIRUGA

Example Request

Tanzania
{
“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”,
}

Header

key	desc
currency	TZS
payto	TIGTZA or AIRTZA or HALTZA

Example Request

Benin
{
“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”,
}

Header

key	Desc
currency	XOF
callback_url	webhook url
amount	200-2,000,000

Example Request

Ivory Coast
{
“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”,
}

Header

Key	Desc
currency	CFA
callback_url	webhook url
payto	MOMCIV or WAVCIV

Example Request

South
Africa
{
“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”,
}

header

Key	Desc
currency	ZAR
bank_code	Payonus Bank codes
payto	Refer to Payonus Payout Bank names

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

Example Request

USA
{
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": "[email protected]",
"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”
}

Header

Key	Desc
currency	USD
country	USA
callback_url	webhook url

Example Request

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

Header

key	Desc
currency	GBP
callback_url	webhook url

Example Request

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

Header

Key	Desc
currency	EUR
callback_url	webhook url

Example Request

China
{
“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”
}

Header

Key	Desc
currency	CNY
callback_url	webhook url

USD, GBP, EUR Collections (Blaaiz Channel)

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

Example Request

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

Header

Key	Desc
currency	EUR/USD/GBP
callback_url	webhook url
channel	blaaiz

USD, GBP, EUR Payouts (Blaaiz Channel)

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

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

Header

Key	Desc
currency	EUR
callback_url	webhook url

Example Request

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

Header

Key	Desc
currency	GBP
callback_url	webhook url

Example Request

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

Header

Key	Desc
currency	GBP
callback_url	webhook url

CAD Collections/Payouts (Blaaiz Channel)

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

Example Request

Collection

{
“type”:”collection”,
“interac_email”:”[email protected]”,
“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”
}

Payouts

{
“type”:”payout”,
“interac_email”:”[email protected]”,
“first_name”:”John”,
“last_name”:”Doe”,
“merchant”:”Name of merchant ”,
”amount”:”10”,
”ref”:”Order Number”,
”callback_url”:”webhook url”
}