Bank Codes

To payout funds to a customer's bank, we need to know the recipient's bank by id. We refer to this as the bank code.

Fetch Bank Codes

To get the available bank codes, use the Bank Codes API below to retrieve them per supported country.

Bank Codes API

GET https://sandbox.dusupay.com/v1/payment-options/payout/bank/{country_code}?api_key={api_key}

Path Parameters

Name	Type	Description
country_code*	String	check supported countries

Query Parameters

Name	Type	Description
api_key*	String	Merchant Public Key

Headers

Name	Type	Description
secret-key*	String	secret-key
Content-Type*	String	application/json

200: OK

//for ZA as country_code
{
    "code": 200,
    "status": "success",
    "message": "Request completed successfully.",
    "data": [
        {
            "id": "bank_za",
            "name": "ABSA Bank",
            "transaction_currency": "ZAR",
            "min_amount": 10,
            "max_amount": 30000,
            "available": true,
            "bank_code": "632005",
            "sandbox_test_accounts": {
                "success": "2121562123",
                "failure": "2121562456"
            }
        },
        {
            "id": "bank_za",
            "name": "FNB",
            "transaction_currency": "ZAR",
            "min_amount": 10,
            "max_amount": 30000,
            "available": true,
            "bank_code": "250655",
            "sandbox_test_accounts": {
                "success": "2121562123",
                "failure": "2121562456"
            }
        },
        {
            "id": "bank_za",
            "name": "Standard Bank",
            "transaction_currency": "ZAR",
            "min_amount": 10,
            "max_amount": 30000,
            "available": true,
            "bank_code": "051001",
            "sandbox_test_accounts": {
                "success": "2121562123",
                "failure": "2121562456"
            }
        },
        {
            "id": "bank_za",
            "name": "Nedbank",
            "transaction_currency": "ZAR",
            "min_amount": 10,
            "max_amount": 30000,
            "available": true,
            "bank_code": "198765",
            "sandbox_test_accounts": {
                "success": "2121562123",
                "failure": "2121562456"
            }
        },
        {
            "id": "bank_za",
            "name": "Capitec Bank",
            "transaction_currency": "ZAR",
            "min_amount": 10,
            "max_amount": 30000,
            "available": true,
            "bank_code": "470010",
            "sandbox_test_accounts": {
                "success": "2121562123",
                "failure": "2121562456"
            }
        },
        {
            "id": "bank_za",
            "name": "Investec Bank",
            "transaction_currency": "ZAR",
            "min_amount": 10,
            "max_amount": 30000,
            "available": true,
            "bank_code": "580105",
            "sandbox_test_accounts": {
                "success": "2121562123",
                "failure": "2121562456"
            }
        },
        {
            "id": "bank_za",
            "name": "Tyme Bank",
            "transaction_currency": "ZAR",
            "min_amount": 10,
            "max_amount": 30000,
            "available": true,
            "bank_code": "678910",
            "sandbox_test_accounts": {
                "success": "2121562123",
                "failure": "2121562456"
            }
        },
        {
            "id": "bank_za",
            "name": "African Bank",
            "transaction_currency": "ZAR",
            "min_amount": 10,
            "max_amount": 30000,
            "available": true,
            "bank_code": "430000",
            "sandbox_test_accounts": {
                "success": "2121562123",
                "failure": "2121562456"
            }
        },
        {
            "id": "bank_za",
            "name": "Bidvest Bank",
            "transaction_currency": "ZAR",
            "min_amount": 10,
            "max_amount": 30000,
            "available": true,
            "bank_code": "462005",
            "sandbox_test_accounts": {
                "success": "2121562123",
                "failure": "2121562456"
            }
        }
    ]
}

404: Not Found

// For UG
{
    "code": 404,
    "status": "error",
    "message": "There are no options found for bank payouts in UG",
    "data": []
}

Countries that required Bank codes for payouts

The country codes are also included

• Uganda (UG)

• Kenya (KE)

• Tanzania (TZ)

• Nigeria (NG)

• Ghana (GH)

• USA (US)

• Europe (EU)

• UK (GB)

Europe refers to all countries in Europe that have EUR as their national currency

Sample Request

{
    ...
    "method": "BANK",
    "provider_id": "bank_gh",
    "extra_params": {
        "bank_code": "6876132"
    },
    ...
}