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

NameTypeDescription

country_code*

String

Query Parameters

NameTypeDescription

api_key*

String

Headers

NameTypeDescription

secret-key*

String

secret-key

Content-Type*

String

application/json

//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"
            }
        }
    ]
}

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

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

Last updated