Account verification

This allows you verify an account to transfer to.

Step 1 - You would need to find the bank code. You can take the json from below.

{
    "Banks": [
      {
        "Id": 132,
        "Code": "560",
        "Name": "Page MFBank",
        "IsMobileVerified": null
      },
      {
        "Id": 133,
        "Code": "304",
        "Name": "Stanbic Mobile Money",
        "IsMobileVerified": null
      },
      {
        "Id": 134,
        "Code": "308",
        "Name": "FortisMobile",
        "IsMobileVerified": null
      },
      {
        "Id": 135,
        "Code": "328",
        "Name": "TagPay",
        "IsMobileVerified": null
      },
      {
        "Id": 136,
        "Code": "309",
        "Name": "FBNMobile",
        "IsMobileVerified": null
      },
      {
        "Id": 137,
        "Code": "011",
        "Name": "First Bank of Nigeria",
        "IsMobileVerified": null
      },
      {
        "Id": 138,
        "Code": "326",
        "Name": "Sterling Mobile",
        "IsMobileVerified": null
      },
      {
        "Id": 139,
        "Code": "990",
        "Name": "Omoluabi Mortgage Bank",
        "IsMobileVerified": null
      },
      {
        "Id": 140,
        "Code": "311",
        "Name": "ReadyCash (Parkway)",
        "IsMobileVerified": null
      },
      {
        "Id": 141,
        "Code": "057",
        "Name": "Zenith Bank",
        "IsMobileVerified": null
      },
      {
        "Id": 142,
        "Code": "068",
        "Name": "Standard Chartered Bank",
        "IsMobileVerified": null
      },
      {
        "Id": 143,
        "Code": "306",
        "Name": "eTranzact",
        "IsMobileVerified": null
      },
      {
        "Id": 144,
        "Code": "070",
        "Name": "Fidelity Bank",
        "IsMobileVerified": null
      },
      {
        "Id": 145,
        "Code": "023",
        "Name": "CitiBank",
        "IsMobileVerified": null
      },
      {
        "Id": 146,
        "Code": "215",
        "Name": "Unity Bank",
        "IsMobileVerified": null
      },
      {
        "Id": 147,
        "Code": "323",
        "Name": "Access Money",
        "IsMobileVerified": null
      },
      {
        "Id": 148,
        "Code": "302",
        "Name": "Eartholeum",
        "IsMobileVerified": null
      },
      {
        "Id": 149,
        "Code": "324",
        "Name": "Hedonmark",
        "IsMobileVerified": null
      },
      {
        "Id": 150,
        "Code": "325",
        "Name": "MoneyBox",
        "IsMobileVerified": null
      },
      {
        "Id": 151,
        "Code": "301",
        "Name": "JAIZ Bank",
        "IsMobileVerified": null
      },
      {
        "Id": 152,
        "Code": "050",
        "Name": "Ecobank Plc",
        "IsMobileVerified": null
      },
      {
        "Id": 153,
        "Code": "307",
        "Name": "EcoMobile",
        "IsMobileVerified": null
      },
      {
        "Id": 154,
        "Code": "318",
        "Name": "Fidelity Mobile",
        "IsMobileVerified": null
      },
      {
        "Id": 155,
        "Code": "319",
        "Name": "TeasyMobile",
        "IsMobileVerified": null
      },
      {
        "Id": 156,
        "Code": "999",
        "Name": "NIP Virtual Bank",
        "IsMobileVerified": null
      },
      {
        "Id": 157,
        "Code": "320",
        "Name": "VTNetworks",
        "IsMobileVerified": null
      },
      {
        "Id": 158,
        "Code": "221",
        "Name": "Stanbic IBTC Bank",
        "IsMobileVerified": null
      },
      {
        "Id": 159,
        "Code": "501",
        "Name": "Fortis Microfinance Bank",
        "IsMobileVerified": null
      },
      {
        "Id": 160,
        "Code": "329",
        "Name": "PayAttitude Online",
        "IsMobileVerified": null
      },
      {
        "Id": 161,
        "Code": "322",
        "Name": "ZenithMobile",
        "IsMobileVerified": null
      },
      {
        "Id": 162,
        "Code": "303",
        "Name": "ChamsMobile",
        "IsMobileVerified": null
      },
      {
        "Id": 163,
        "Code": "403",
        "Name": "SafeTrust Mortgage Bank",
        "IsMobileVerified": null
      },
      {
        "Id": 164,
        "Code": "551",
        "Name": "Covenant Microfinance Bank",
        "IsMobileVerified": null
      },
      {
        "Id": 165,
        "Code": "415",
        "Name": "Imperial Homes Mortgage Bank",
        "IsMobileVerified": null
      },
      {
        "Id": 166,
        "Code": "552",
        "Name": "NPF MicroFinance Bank",
        "IsMobileVerified": null
      },
      {
        "Id": 167,
        "Code": "526",
        "Name": "Parralex",
        "IsMobileVerified": null
      },
      {
        "Id": 168,
        "Code": "035",
        "Name": "Wema Bank",
        "IsMobileVerified": null
      },
      {
        "Id": 169,
        "Code": "084",
        "Name": "Enterprise Bank",
        "IsMobileVerified": null
      },
      {
        "Id": 170,
        "Code": "063",
        "Name": "Diamond Bank",
        "IsMobileVerified": null
      },
      {
        "Id": 171,
        "Code": "305",
        "Name": "Paycom",
        "IsMobileVerified": null
      },
      {
        "Id": 172,
        "Code": "100",
        "Name": "SunTrust Bank",
        "IsMobileVerified": null
      },
      {
        "Id": 173,
        "Code": "317",
        "Name": "Cellulant",
        "IsMobileVerified": null
      },
      {
        "Id": 174,
        "Code": "401",
        "Name": "ASO Savings and & Loans",
        "IsMobileVerified": null
      },
      {
        "Id": 175,
        "Code": "030",
        "Name": "Heritage",
        "IsMobileVerified": null
      },
      {
        "Id": 176,
        "Code": "402",
        "Name": "Jubilee Life Mortgage Bank",
        "IsMobileVerified": null
      },
      {
        "Id": 177,
        "Code": "058",
        "Name": "GTBank Plc",
        "IsMobileVerified": null
      },
      {
        "Id": 178,
        "Code": "032",
        "Name": "Union Bank",
        "IsMobileVerified": null
      },
      {
        "Id": 179,
        "Code": "232",
        "Name": "Sterling Bank",
        "IsMobileVerified": null
      },
      {
        "Id": 180,
        "Code": "076",
        "Name": "Skye Bank",
        "IsMobileVerified": null
      },
      {
        "Id": 181,
        "Code": "082",
        "Name": "Keystone Bank",
        "IsMobileVerified": null
      },
      {
        "Id": 182,
        "Code": "327",
        "Name": "Pagatech",
        "IsMobileVerified": null
      },
      {
        "Id": 183,
        "Code": "559",
        "Name": "Coronation Merchant Bank",
        "IsMobileVerified": null
      },
      {
        "Id": 184,
        "Code": "601",
        "Name": "FSDH",
        "IsMobileVerified": null
      },
      {
        "Id": 185,
        "Code": "313",
        "Name": "Mkudi",
        "IsMobileVerified": null
      },
      {
        "Id": 186,
        "Code": "214",
        "Name": "First City Monument Bank",
        "IsMobileVerified": null
      },
      {
        "Id": 187,
        "Code": "314",
        "Name": "FET",
        "IsMobileVerified": null
      },
      {
        "Id": 188,
        "Code": "523",
        "Name": "Trustbond",
        "IsMobileVerified": null
      },
      {
        "Id": 189,
        "Code": "315",
        "Name": "GTMobile",
        "IsMobileVerified": null
      },
      {
        "Id": 190,
        "Code": "033",
        "Name": "United Bank for Africa",
        "IsMobileVerified": null
      },
      {
        "Id": 191,
        "Code": "044",
        "Name": "Access Bank",
        "IsMobileVerified": null
      }
    ]

Step 2 - Use the code and make the request

Sandbox Endpoint: https://ravesandboxapi.flutterwave.com/flwv3-pug/getpaidx/api/resolve_account

Live Endpoint: https://api.ravepay.co/flwv3-pug/getpaidx/api/resolve_account

Sample POST Request:

{
  recipientaccount:0690000031,
  destbankcode:044,
  PBFPubKey:your-public-key,
  currency:"GHS" , // optional Add this when resolving a Ghanian account. Expected value is `GHS`
  country:"GH" , //optional Add this when resolving a Ghanian account. Expected value is `GH`
}
curl -X POST \
  https://ravesandboxapi.flutterwave.com/flwv3-pug/getpaidx/api/resolve_account \
  -H 'Content-Type: application/json' \
  -H 'Postman-Token: f67f8bf7-f295-4453-bc6a-549569c1e62c' \
  -H 'cache-control: no-cache' \
  -H 'content-type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW' \
  -F recipientaccount=0690000031 \
  -F destbankcode=044 \
  -F PBFPubKey=your-public-key \
  -F currency= \
  -F country=

What happened in the request above?

We sent a post request to the endpoint with the code of the bank and the account number along with our public key

Sample Successful Response:

{
  "status": "success",
  "message": "ACCOUNT RESOLVED",
  "data": {
    "data": {
      "responsecode": "00",
      "accountnumber": "0690000034",
      "accountname": "Toby St Patrick",
      "responsemessage": "Approved Or Completed Successfully",
      "phonenumber": null,
      "uniquereference": "FLWT00976651",
      "internalreference": null
    },
    "status": "success"
  }
}

Sample Invalid Response

{
    "status": "success",
    "message": "ACCOUNT RESOLVED",
    "data": {
        "data": {
            "responsecode": "RN0",
            "accountnumber": null,
            "accountname": null,
            "responsemessage": "Sorry, recipient account could not be validated. Please try again",
            "phonenumber": null,
            "uniquereference": "FLWT00976652",
            "internalreference": null
        },
        "status": "success"
    }
}