Skip to content
HitchPay API Docs

PAYOUT

Verify Account Name

Validate a bank account name using the account number

POST /v1/transfer/resolve-account

Body

Name Type Description
bank_code string Bank NUUBAN Code
account_number string Customer bank account number
var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://sandbox.hitchpay.ng/v1/transfer/resolve-account',
  'headers': {
    'Content-Type': 'application/json',
    'Authorization': '••••••'
  },
  body: JSON.stringify({
    "bank_code": "999240",
    "account_number": "8023039719"
  })

};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://sandbox.hitchpay.ng/v1/transfer/resolve-account',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
    "bank_code": "999240",
    "account_number": "8023039719"
}',
  CURLOPT_HTTPHEADER => array(
    'Content-Type: application/json',
    'Authorization': '••••••'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;
import requests
import json

url = "https://sandbox.hitchpay.ng/v1/transfer/resolve-account"

payload = json.dumps({
  "bank_code": "999240",
  "account_number": "8023039719"
})
headers = {
  'Content-Type': 'application/json',
  'Authorization': '••••••'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

Response

{
    "status": "success",
    "message": "Account verified",
    "data": {
        "account_name": "JOHN DOE",
        "enquiry_token": ""
    }
}
{
    "status": "error",
    "code": "RESOLVE_FAILED",
    "message": "Unable to verify account number"
}

Questions? Email [email protected]. Also on GitBook.