Receiving Institutions
You can make an API call to get the list of institutions that eexist on a particular payout channel so your customer can select the relevant recipient's bank, and the insitution code can then be sent in the lookup or payout request.
Request Parameters
Param
| required | description | |
|---|---|---|
| channel | N | payout channel | 
curl --location '/api/v1/payouts/receiving-institutions'  
--header 'Content-Type: application/json'  
--header 'Authorization: Bearer {{access token}}' \\
Sample response
[
    {
        "code": "ACA",
        "name": "ACA MFB"
    },
    {
        "code": "ABP",
        "name": "Access Bank PLC"
    },
    {
        "code": "DMD",
        "name": "Diamond Bank PLC"
    },
    {
        "code": "ECO",
        "name": "Eco Bank"
    },
    {
        "code": "FBP",
        "name": "Fidelity Bank"
    },
   
    {
        "code": "FBN",
        "name": "First Bank PLC"
    },
    {
        "code": "FCM",
        "name": "First City Monument Bank"
    },
    {
        "code": "FNB",
        "name": "First Nation"
    },
    
    {
        "code": "GLB",
        "name": "Globus Bank"
    },
    {
        "code": "E54",
        "name": "Grub - land"
    },
    {
        "code": "GTB",
        "name": "Guaranty Trust Bank"
    },
    {
        "code": "HPL",
        "name": "Honesty Bank Plc "
    },
    {
        "code": "IFS",
        "name": "IFIS"
    },
    
    {
        "code": "MFS",
        "name": "Interswitch Mobile Financial Services"
    },
    {
        "code": "KIP",
        "name": "KOP"
    },
    {
        "code": "KDB",
        "name": "KUDA BANK"
    },
    {
        "code": "KDD",
        "name": "KUDA TEST"
    },
    {
        "code": "MCM",
        "name": "MCM MFB"
    },
    {
        "code": "MFM",
        "name": "MFM MFB"
    },
    {
        "code": "MRN",
        "name": "MRN"
    },
    {
        "code": "MNP",
        "name": "Moniepoint"
    },
    {
        "code": "NBR",
        "name": "Nicholas Bank Russia"
    },
    {
        "code": "OPY",
        "name": "OPAY"
    },
    
    {
        "code": "PAM",
        "name": "Palmpay"
    },
    {
        "code": "UMB",
        "name": "Providus Bank"
    },
    {
        "code": "UMA",
        "name": "Providus Bank 1"
    },
    {
        "code": "QTD",
        "name": "Quickteller digital"
    },
   
    {
        "code": "SUN",
        "name": "Sun Trust"
    },
  
    {
        "code": "TBF",
        "name": "The Bank of Free"
    },
  
    {
        "code": "TRP",
        "name": "TransPay Inc"
    },
 
    {
        "code": "UBA",
        "name": "United Bank For Africa"
    },
    {
        "code": "WMA",
        "name": "WEMA"
    },
    {
        "code": "GLT",
        "name": "Zenith"
    }
]
Updated 8 months ago
