Payout Bank Codes

For all countries/currencies where DusuPay supports bank payouts, there's need to specify the unique code for the bank to which the funds are to be sent. These codes are available via the API

The bank codes are attached to the respective payment providers designated for paying out funds to the supported banks. Therefore, a provider code, obtained from here can be used to query the list of supported banks. Any provider that supports BANK payouts will have the list of banks and respective codes.

Get Payout Banks List

GET https://sandboxapi.dusupay.com/data/payout-bank-codes

Returns the list of payout banks based on the provider code.

Query Parameters

Name	Type	Description
provider_code*	String	The payment provider code for the provider whose bank codes are required

Headers

Name	Type	Description
public-key*	String	The merchant account Public Key

Sample Payment Options Request

curl https://sandboxapi.dusupay.com/data/payout-bank-codes?provider_code=bank_ng \
   -H "Accept: application/json" \
   -H "x-api-version: 1" \
   -H "public-key: your-public-key"

200: OK Returns the list of payout banks

{
    "code": 200,
    "status": "success",
    "message": "Request completed successfully.",
    "data": {
        "payout_banks": [
            {
                "bank_name": "Access Bank Nigeria",
                "bank_code": "access_bank_ng",
                "is_active": true
            },
            {
                "bank_name": "Guaranty Trust Bank",
                "bank_code": "gtbank_ng",
                "is_active": true
            }
        ]
    }
}

Response Description

Parameter	Type	Description
bank_code	String	The unique code for the payout bank. It is required for the bank payout transaction requests
bank_name	String	The name of the bank
is_active	Boolean	Whether or not the bank is active for usage

400: Bad Request When the request is not formed as expected

{
  "code": 400,
  "status": "error",
  "message": "provider_code is required",
  "data": {}
}