Generate Account

This endpoint allows you to generate virtual account for a specified bank as setup in the preferred bank endpoint above

POST https://api.oneappgo.com/v1/dedicated-account

You can pass bankcode as a field to the generate account endpoint to generate account number on the go without considering the default set bank. Get the list of available bank and their code from the partnerbank endpoint.

Headers

Name	Type	Description
authorization*	String	SECRET_KEY

Request Body

Name	Type	Description
trackingid*	String	A unique id for the user generating account for
firstname*	String	First name of the user
lastname*	String	Last name of the user
userbvn*	String	Bank Verification Number of the user
useremail*	String	Email Address
userphone*	String	Phone number
bankcode	String	Bank code

200: OK

{
  "status": true,
  "message": "Account Number Successfully Generated",
  "trackingref": "001858002",
  "trackingid": "002",
  "acctname": "John Doe",
  "acctno": "3984124113",
  "clientid": "1858000",
  "bankcode": "101",
  "bankname": "Providus Bank"
}

Take a look at how you might do this:

cURL

curl --location 'https://api.oneappgo.com/v1/dedicated-account' \
--header 'Authorization: Bearer SECRET_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
    "trackingid": "2727",
    "firstname": "John",
    "lastname": "Doe",
    "userbvn": "22222253444",
    "useremail": "[email protected]",
    "userphone": "09123456789",
    "bankcode": "101"
}'

NodeJs

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://api.oneappgo.com/v1/dedicated-account',
  'headers': {
    'Authorization': 'Bearer SECRET_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "trackingid": "2727",
    "firstname": "John",
    "lastname": "Doe",
    "userbvn": "22222253444",
    "useremail": "[email protected]",
    "userphone": "09123456789",
    "bankcode": "101"
  })

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

PHP - cURL

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api.oneappgo.com/v1/dedicated-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 =>'{
    "trackingid": "2727",
    "firstname": "John",
    "lastname": "Doe",
    "userbvn": "22222253444",
    "useremail": "[email protected]",
    "userphone": "09123456789",
    "bankcode": "101"
}',
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer SECRET_KEY',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Dart

var headers = {
  'Authorization': 'Bearer SECRET_KEY',
  'Content-Type': 'application/json'
};
var request = http.Request('POST', Uri.parse('https://api.oneappgo.com/v1/dedicated-account'));
request.body = json.encode({
  "trackingid": "2727",
  "firstname": "John",
  "lastname": "Doe",
  "userbvn": "22222253444",
  "useremail": "[email protected]",
  "userphone": "09123456789",
  "bankcode": "101"
});
request.headers.addAll(headers);

http.StreamedResponse response = await request.send();

if (response.statusCode == 200) {
  print(await response.stream.bytesToString());
}
else {
  print(response.reasonPhrase);
}

Sample response

{
  "status": true,
  "message": "Account Number Successfully Generated",
  "trackingref": "001858002",
  "trackingid": "002",
  "acctname": "John Doe",
  "acctno": "3984124113",
  "clientid": "1858000",
  "bankcode": "101",
  "bankname": "Providus Bank"
}