Get Transaction Status
Get the status of a transaction.
Test Base URL
https://api-staging.providusbank.com
Production Base URL
HTTP Request
GET /account/bvn
BVN Details.
GET https://api-staging.providusbank.com/v1/account/bvn
Get NIP Account.
Request Body
Name
Type
Description
Username
string
Username of account owner
Password
string
Password of account owner
number
String
bvn number of account owner
Sample Implementation
curl -x GET "https://api-demo.providusbank/account/NIP/banks"
-H "Authorization: {{Authentication token}}"
-H "Username: Username"
-H "Password: Password"The above command returns JSON structured like this:
{
"banks":[
{"bankCode":"000014","bankName":"ACCESS BANK"},
{"bankCode":"100013","bankName":"ACCESS MOBILE"},
{"bankCode":"090133","bankName":"AL-BARAKAH MICROFINANCE BANK"},
{"bankCode":"090116","bankName":"AMML MICROFINANCE BANK"},
{"bankCode":"090001","bankName":"ASO SAVINGS"},
{"bankCode":"090127","bankName":"BC KASH MICROFINANCE BANK"},
{"bankCode":"090117","bankName":"BOCTRUST MICROFINANCE BANK LIMITED"},
{"bankCode":"100005","bankName":"CELLULANT"},
{"bankCode":"100015","bankName":"CHAMS MOBILE"},
{"bankCode":"000009","bankName":"CITI BANK"},
{"bankCode":"060001","bankName":"CORONATION BANK"},
{"bankCode":"070006","bankName":"COVENANT MFB"},
{"bankCode":"000005","bankName":"DIAMOND BANK"},
{"bankCode":"100021","bankName":"EARTHOLEUM"},
{"bankCode":"000010","bankName":"ECOBANK"},
{"bankCode":"100008","bankName":"ECOBANK XPRESS ACCOUNT"},
{"bankCode":"090114","bankName":"EMPIRE TRUST MICROFINANCE BANK"},
{"bankCode":"000019","bankName":"ENTERPRISE BANK"},
{"bankCode":"100006","bankName":"eTRANZACT"},
{"bankCode":"060002","bankName":"FBN MERCHANT BANK"},
{"bankCode":"100014","bankName":"FBN MOBILE"}
],
"responseMessage":"SUCCESS",
"responseCode":"00"}import requests
from requests.structures import CaseInsensitiveDict
url = "https://api-demo.providusbank/account/NIP/banks"
headers = CaseInsensitiveDict()
headers["Authorization"] = "{{Authentication token}}"
headers["Username"] = "Username"
headers["Password"] = "Password"The above command returns JSON structured like this:
{
"banks":[
{"bankCode":"000014","bankName":"ACCESS BANK"},
{"bankCode":"100013","bankName":"ACCESS MOBILE"},
{"bankCode":"090133","bankName":"AL-BARAKAH MICROFINANCE BANK"},
{"bankCode":"090116","bankName":"AMML MICROFINANCE BANK"},
{"bankCode":"090001","bankName":"ASO SAVINGS"},
{"bankCode":"090127","bankName":"BC KASH MICROFINANCE BANK"},
{"bankCode":"090117","bankName":"BOCTRUST MICROFINANCE BANK LIMITED"},
{"bankCode":"100005","bankName":"CELLULANT"},
{"bankCode":"100015","bankName":"CHAMS MOBILE"},
{"bankCode":"000009","bankName":"CITI BANK"},
{"bankCode":"060001","bankName":"CORONATION BANK"},
{"bankCode":"070006","bankName":"COVENANT MFB"},
{"bankCode":"000005","bankName":"DIAMOND BANK"},
{"bankCode":"100021","bankName":"EARTHOLEUM"},
{"bankCode":"000010","bankName":"ECOBANK"},
{"bankCode":"100008","bankName":"ECOBANK XPRESS ACCOUNT"},
{"bankCode":"090114","bankName":"EMPIRE TRUST MICROFINANCE BANK"},
{"bankCode":"000019","bankName":"ENTERPRISE BANK"},
{"bankCode":"100006","bankName":"eTRANZACT"},
{"bankCode":"060002","bankName":"FBN MERCHANT BANK"},
{"bankCode":"100014","bankName":"FBN MOBILE"}
],
"responseMessage":"SUCCESS",
"responseCode":"00"}URL url = new URL("https://api-demo.providusbank/account/NIP/banks");
HttpURLConnection http = (HttpURLConnection)url.openConnection();
http.setRequestProperty("Authorization", "{{Authentication token}}");
http.setRequestProperty("Username", "Username");
http.setRequestProperty("Password", "Password");
System.out.println(http.getResponseCode() + " " + http.getResponseMessage());
http.disconnect();The above command returns JSON structured like this:
{
"banks":[
{"bankCode":"000014","bankName":"ACCESS BANK"},
{"bankCode":"100013","bankName":"ACCESS MOBILE"},
{"bankCode":"090133","bankName":"AL-BARAKAH MICROFINANCE BANK"},
{"bankCode":"090116","bankName":"AMML MICROFINANCE BANK"},
{"bankCode":"090001","bankName":"ASO SAVINGS"},
{"bankCode":"090127","bankName":"BC KASH MICROFINANCE BANK"},
{"bankCode":"090117","bankName":"BOCTRUST MICROFINANCE BANK LIMITED"},
{"bankCode":"100005","bankName":"CELLULANT"},
{"bankCode":"100015","bankName":"CHAMS MOBILE"},
{"bankCode":"000009","bankName":"CITI BANK"},
{"bankCode":"060001","bankName":"CORONATION BANK"},
{"bankCode":"070006","bankName":"COVENANT MFB"},
{"bankCode":"000005","bankName":"DIAMOND BANK"},
{"bankCode":"100021","bankName":"EARTHOLEUM"},
{"bankCode":"000010","bankName":"ECOBANK"},
{"bankCode":"100008","bankName":"ECOBANK XPRESS ACCOUNT"},
{"bankCode":"090114","bankName":"EMPIRE TRUST MICROFINANCE BANK"},
{"bankCode":"000019","bankName":"ENTERPRISE BANK"},
{"bankCode":"100006","bankName":"eTRANZACT"},
{"bankCode":"060002","bankName":"FBN MERCHANT BANK"},
{"bankCode":"100014","bankName":"FBN MOBILE"}
],
"responseMessage":"SUCCESS",
"responseCode":"00"}var xhr = new XMLHttpRequest();
xhr.withCredentials = true;
xhr.addEventListener("readystatechange", function() {
if(this.readyState === 4) {
console.log(this.responseText);
}
});
xhr.open("GET", "https://api-staging.providusbank.com/account/NIP/banks");
xhr.setRequestHeader("Authorization", "{{Authentication token}}");
xhr.setRequestHeader("Username", "Username");
xhr.setRequestHeader("Password", "Password");
xhr.send();The above command returns JSON structured like this:
{
"banks":[
{"bankCode":"000014","bankName":"ACCESS BANK"},
{"bankCode":"100013","bankName":"ACCESS MOBILE"},
{"bankCode":"090133","bankName":"AL-BARAKAH MICROFINANCE BANK"},
{"bankCode":"090116","bankName":"AMML MICROFINANCE BANK"},
{"bankCode":"090001","bankName":"ASO SAVINGS"},
{"bankCode":"090127","bankName":"BC KASH MICROFINANCE BANK"},
{"bankCode":"090117","bankName":"BOCTRUST MICROFINANCE BANK LIMITED"},
{"bankCode":"100005","bankName":"CELLULANT"},
{"bankCode":"100015","bankName":"CHAMS MOBILE"},
{"bankCode":"000009","bankName":"CITI BANK"},
{"bankCode":"060001","bankName":"CORONATION BANK"},
{"bankCode":"070006","bankName":"COVENANT MFB"},
{"bankCode":"000005","bankName":"DIAMOND BANK"},
{"bankCode":"100021","bankName":"EARTHOLEUM"},
{"bankCode":"000010","bankName":"ECOBANK"},
{"bankCode":"100008","bankName":"ECOBANK XPRESS ACCOUNT"},
{"bankCode":"090114","bankName":"EMPIRE TRUST MICROFINANCE BANK"},
{"bankCode":"000019","bankName":"ENTERPRISE BANK"},
{"bankCode":"100006","bankName":"eTRANZACT"},
{"bankCode":"060002","bankName":"FBN MERCHANT BANK"},
{"bankCode":"100014","bankName":"FBN MOBILE"}
],
"responseMessage":"SUCCESS",
"responseCode":"00"}<?php
require_once 'HTTP/Request2.php';
$request = new HTTP_Request2();
$request->setUrl('https://api-staging.providusbank.com/account/NIP/banks');
$request->setMethod(HTTP_Request2::METHOD_GET);
$request->setConfig(array(
'follow_redirects' => TRUE
));
$request->setHeader(array(
'Authorization' => '{{Authentication token}}',
'Username' => 'Username',
'Password' => 'Password'
));
try {
$response = $request->send();
if ($response->getStatus() == 200) {
echo $response->getBody();
}
else {
echo 'Unexpected HTTP status: ' . $response->getStatus() . ' ' .
$response->getReasonPhrase();
}
}
catch(HTTP_Request2_Exception $e) {
echo 'Error: ' . $e->getMessage();
}
?>The above command returns JSON structured like this:
{
"banks":[
{"bankCode":"000014","bankName":"ACCESS BANK"},
{"bankCode":"100013","bankName":"ACCESS MOBILE"},
{"bankCode":"090133","bankName":"AL-BARAKAH MICROFINANCE BANK"},
{"bankCode":"090116","bankName":"AMML MICROFINANCE BANK"},
{"bankCode":"090001","bankName":"ASO SAVINGS"},
{"bankCode":"090127","bankName":"BC KASH MICROFINANCE BANK"},
{"bankCode":"090117","bankName":"BOCTRUST MICROFINANCE BANK LIMITED"},
{"bankCode":"100005","bankName":"CELLULANT"},
{"bankCode":"100015","bankName":"CHAMS MOBILE"},
{"bankCode":"000009","bankName":"CITI BANK"},
{"bankCode":"060001","bankName":"CORONATION BANK"},
{"bankCode":"070006","bankName":"COVENANT MFB"},
{"bankCode":"000005","bankName":"DIAMOND BANK"},
{"bankCode":"100021","bankName":"EARTHOLEUM"},
{"bankCode":"000010","bankName":"ECOBANK"},
{"bankCode":"100008","bankName":"ECOBANK XPRESS ACCOUNT"},
{"bankCode":"090114","bankName":"EMPIRE TRUST MICROFINANCE BANK"},
{"bankCode":"000019","bankName":"ENTERPRISE BANK"},
{"bankCode":"100006","bankName":"eTRANZACT"},
{"bankCode":"060002","bankName":"FBN MERCHANT BANK"},
{"bankCode":"100014","bankName":"FBN MOBILE"}
],
"responseMessage":"SUCCESS",
"responseCode":"00"}var client = new RestClient("https://api-staging.providusbank.com/account/NIP/banks");
client.Timeout = -1;
var request = new RestRequest(Method.GET);
request.AddHeader("Authorization", "{{Authentication token}}");
request.AddHeader("Username", "Username");
request.AddHeader("Password", "Password");
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);The above command returns JSON structured like this:
{
"banks":[
{"bankCode":"000014","bankName":"ACCESS BANK"},
{"bankCode":"100013","bankName":"ACCESS MOBILE"},
{"bankCode":"090133","bankName":"AL-BARAKAH MICROFINANCE BANK"},
{"bankCode":"090116","bankName":"AMML MICROFINANCE BANK"},
{"bankCode":"090001","bankName":"ASO SAVINGS"},
{"bankCode":"090127","bankName":"BC KASH MICROFINANCE BANK"},
{"bankCode":"090117","bankName":"BOCTRUST MICROFINANCE BANK LIMITED"},
{"bankCode":"100005","bankName":"CELLULANT"},
{"bankCode":"100015","bankName":"CHAMS MOBILE"},
{"bankCode":"000009","bankName":"CITI BANK"},
{"bankCode":"060001","bankName":"CORONATION BANK"},
{"bankCode":"070006","bankName":"COVENANT MFB"},
{"bankCode":"000005","bankName":"DIAMOND BANK"},
{"bankCode":"100021","bankName":"EARTHOLEUM"},
{"bankCode":"000010","bankName":"ECOBANK"},
{"bankCode":"100008","bankName":"ECOBANK XPRESS ACCOUNT"},
{"bankCode":"090114","bankName":"EMPIRE TRUST MICROFINANCE BANK"},
{"bankCode":"000019","bankName":"ENTERPRISE BANK"},
{"bankCode":"100006","bankName":"eTRANZACT"},
{"bankCode":"060002","bankName":"FBN MERCHANT BANK"},
{"bankCode":"100014","bankName":"FBN MOBILE"}
],
"responseMessage":"SUCCESS",
"responseCode":"00"}Last updated