Links
Comment on page

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.
Parameters
Header
authourization*
SECRET_KEY
Body
trackingid*
A unique id for the user generating account for
firstname*
First name of the user
lastname*
Last name of the user
userbvn*
Bank Verification Number of the user
useremail*
Email Address
userphone*
Phone number
bankcode
Bank code
Responses
200: OK
Take a look at how you might do this:
cURL
NodeJs
PHP - cURL
Dart
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"
}'
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);
});
$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;
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"
}