Create a new bank account
curl --request POST \
--url https://staging-vouchers.ventogram.com/api/v1/create-account \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <api-key>' \
--header 'X-Api-User: <api-key>' \
--data '
{
"bvn": "46444443431",
"currency": "NGN",
"email": "rahman+1@gmail.com",
"firstName": "rahmann",
"lastName": "plus",
"middleName": "one",
"phone": "+2348033333511",
"dob": "25-02-2000",
"country": "NG",
"stateOfOrigin": "Lagos",
"stateOfResidence": "Lagos",
"lgaOfOrigin": "Amuwo",
"lgaOfResidence": "Ifako",
"addressLine1": "27 Obafemi Awolowo Way",
"addressLine2": "",
"addressLine3": ""
}
'import requests
url = "https://staging-vouchers.ventogram.com/api/v1/create-account"
payload = {
"bvn": "46444443431",
"currency": "NGN",
"email": "rahman+1@gmail.com",
"firstName": "rahmann",
"lastName": "plus",
"middleName": "one",
"phone": "+2348033333511",
"dob": "25-02-2000",
"country": "NG",
"stateOfOrigin": "Lagos",
"stateOfResidence": "Lagos",
"lgaOfOrigin": "Amuwo",
"lgaOfResidence": "Ifako",
"addressLine1": "27 Obafemi Awolowo Way",
"addressLine2": "",
"addressLine3": ""
}
headers = {
"X-Api-User": "<api-key>",
"X-Api-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'X-Api-User': '<api-key>',
'X-Api-Key': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
bvn: '46444443431',
currency: 'NGN',
email: 'rahman+1@gmail.com',
firstName: 'rahmann',
lastName: 'plus',
middleName: 'one',
phone: '+2348033333511',
dob: '25-02-2000',
country: 'NG',
stateOfOrigin: 'Lagos',
stateOfResidence: 'Lagos',
lgaOfOrigin: 'Amuwo',
lgaOfResidence: 'Ifako',
addressLine1: '27 Obafemi Awolowo Way',
addressLine2: '',
addressLine3: ''
})
};
fetch('https://staging-vouchers.ventogram.com/api/v1/create-account', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://staging-vouchers.ventogram.com/api/v1/create-account",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'bvn' => '46444443431',
'currency' => 'NGN',
'email' => 'rahman+1@gmail.com',
'firstName' => 'rahmann',
'lastName' => 'plus',
'middleName' => 'one',
'phone' => '+2348033333511',
'dob' => '25-02-2000',
'country' => 'NG',
'stateOfOrigin' => 'Lagos',
'stateOfResidence' => 'Lagos',
'lgaOfOrigin' => 'Amuwo',
'lgaOfResidence' => 'Ifako',
'addressLine1' => '27 Obafemi Awolowo Way',
'addressLine2' => '',
'addressLine3' => ''
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-Api-Key: <api-key>",
"X-Api-User: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://staging-vouchers.ventogram.com/api/v1/create-account"
payload := strings.NewReader("{\n \"bvn\": \"46444443431\",\n \"currency\": \"NGN\",\n \"email\": \"rahman+1@gmail.com\",\n \"firstName\": \"rahmann\",\n \"lastName\": \"plus\",\n \"middleName\": \"one\",\n \"phone\": \"+2348033333511\",\n \"dob\": \"25-02-2000\",\n \"country\": \"NG\",\n \"stateOfOrigin\": \"Lagos\",\n \"stateOfResidence\": \"Lagos\",\n \"lgaOfOrigin\": \"Amuwo\",\n \"lgaOfResidence\": \"Ifako\",\n \"addressLine1\": \"27 Obafemi Awolowo Way\",\n \"addressLine2\": \"\",\n \"addressLine3\": \"\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Api-User", "<api-key>")
req.Header.Add("X-Api-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://staging-vouchers.ventogram.com/api/v1/create-account")
.header("X-Api-User", "<api-key>")
.header("X-Api-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"bvn\": \"46444443431\",\n \"currency\": \"NGN\",\n \"email\": \"rahman+1@gmail.com\",\n \"firstName\": \"rahmann\",\n \"lastName\": \"plus\",\n \"middleName\": \"one\",\n \"phone\": \"+2348033333511\",\n \"dob\": \"25-02-2000\",\n \"country\": \"NG\",\n \"stateOfOrigin\": \"Lagos\",\n \"stateOfResidence\": \"Lagos\",\n \"lgaOfOrigin\": \"Amuwo\",\n \"lgaOfResidence\": \"Ifako\",\n \"addressLine1\": \"27 Obafemi Awolowo Way\",\n \"addressLine2\": \"\",\n \"addressLine3\": \"\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://staging-vouchers.ventogram.com/api/v1/create-account")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-Api-User"] = '<api-key>'
request["X-Api-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"bvn\": \"46444443431\",\n \"currency\": \"NGN\",\n \"email\": \"rahman+1@gmail.com\",\n \"firstName\": \"rahmann\",\n \"lastName\": \"plus\",\n \"middleName\": \"one\",\n \"phone\": \"+2348033333511\",\n \"dob\": \"25-02-2000\",\n \"country\": \"NG\",\n \"stateOfOrigin\": \"Lagos\",\n \"stateOfResidence\": \"Lagos\",\n \"lgaOfOrigin\": \"Amuwo\",\n \"lgaOfResidence\": \"Ifako\",\n \"addressLine1\": \"27 Obafemi Awolowo Way\",\n \"addressLine2\": \"\",\n \"addressLine3\": \"\"\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"message": "bank account successfully completed",
"data": [
{
"bankCode": "",
"bankName": "Test Bank",
"accountName": "TEST-MANAGED-ACCOUNT",
"accountNumber": "1238314012",
"currency": "NGN"
}
]
}{
"success": false,
"message": "Account completion failed",
"errors": [
"<string>"
]
}Collect & Onramp
Create a new bank account
Creates a new managed bank account using user identity and contact information.
POST
/
v1
/
create-account
Create a new bank account
curl --request POST \
--url https://staging-vouchers.ventogram.com/api/v1/create-account \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <api-key>' \
--header 'X-Api-User: <api-key>' \
--data '
{
"bvn": "46444443431",
"currency": "NGN",
"email": "rahman+1@gmail.com",
"firstName": "rahmann",
"lastName": "plus",
"middleName": "one",
"phone": "+2348033333511",
"dob": "25-02-2000",
"country": "NG",
"stateOfOrigin": "Lagos",
"stateOfResidence": "Lagos",
"lgaOfOrigin": "Amuwo",
"lgaOfResidence": "Ifako",
"addressLine1": "27 Obafemi Awolowo Way",
"addressLine2": "",
"addressLine3": ""
}
'import requests
url = "https://staging-vouchers.ventogram.com/api/v1/create-account"
payload = {
"bvn": "46444443431",
"currency": "NGN",
"email": "rahman+1@gmail.com",
"firstName": "rahmann",
"lastName": "plus",
"middleName": "one",
"phone": "+2348033333511",
"dob": "25-02-2000",
"country": "NG",
"stateOfOrigin": "Lagos",
"stateOfResidence": "Lagos",
"lgaOfOrigin": "Amuwo",
"lgaOfResidence": "Ifako",
"addressLine1": "27 Obafemi Awolowo Way",
"addressLine2": "",
"addressLine3": ""
}
headers = {
"X-Api-User": "<api-key>",
"X-Api-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'X-Api-User': '<api-key>',
'X-Api-Key': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
bvn: '46444443431',
currency: 'NGN',
email: 'rahman+1@gmail.com',
firstName: 'rahmann',
lastName: 'plus',
middleName: 'one',
phone: '+2348033333511',
dob: '25-02-2000',
country: 'NG',
stateOfOrigin: 'Lagos',
stateOfResidence: 'Lagos',
lgaOfOrigin: 'Amuwo',
lgaOfResidence: 'Ifako',
addressLine1: '27 Obafemi Awolowo Way',
addressLine2: '',
addressLine3: ''
})
};
fetch('https://staging-vouchers.ventogram.com/api/v1/create-account', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://staging-vouchers.ventogram.com/api/v1/create-account",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'bvn' => '46444443431',
'currency' => 'NGN',
'email' => 'rahman+1@gmail.com',
'firstName' => 'rahmann',
'lastName' => 'plus',
'middleName' => 'one',
'phone' => '+2348033333511',
'dob' => '25-02-2000',
'country' => 'NG',
'stateOfOrigin' => 'Lagos',
'stateOfResidence' => 'Lagos',
'lgaOfOrigin' => 'Amuwo',
'lgaOfResidence' => 'Ifako',
'addressLine1' => '27 Obafemi Awolowo Way',
'addressLine2' => '',
'addressLine3' => ''
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-Api-Key: <api-key>",
"X-Api-User: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://staging-vouchers.ventogram.com/api/v1/create-account"
payload := strings.NewReader("{\n \"bvn\": \"46444443431\",\n \"currency\": \"NGN\",\n \"email\": \"rahman+1@gmail.com\",\n \"firstName\": \"rahmann\",\n \"lastName\": \"plus\",\n \"middleName\": \"one\",\n \"phone\": \"+2348033333511\",\n \"dob\": \"25-02-2000\",\n \"country\": \"NG\",\n \"stateOfOrigin\": \"Lagos\",\n \"stateOfResidence\": \"Lagos\",\n \"lgaOfOrigin\": \"Amuwo\",\n \"lgaOfResidence\": \"Ifako\",\n \"addressLine1\": \"27 Obafemi Awolowo Way\",\n \"addressLine2\": \"\",\n \"addressLine3\": \"\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Api-User", "<api-key>")
req.Header.Add("X-Api-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://staging-vouchers.ventogram.com/api/v1/create-account")
.header("X-Api-User", "<api-key>")
.header("X-Api-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"bvn\": \"46444443431\",\n \"currency\": \"NGN\",\n \"email\": \"rahman+1@gmail.com\",\n \"firstName\": \"rahmann\",\n \"lastName\": \"plus\",\n \"middleName\": \"one\",\n \"phone\": \"+2348033333511\",\n \"dob\": \"25-02-2000\",\n \"country\": \"NG\",\n \"stateOfOrigin\": \"Lagos\",\n \"stateOfResidence\": \"Lagos\",\n \"lgaOfOrigin\": \"Amuwo\",\n \"lgaOfResidence\": \"Ifako\",\n \"addressLine1\": \"27 Obafemi Awolowo Way\",\n \"addressLine2\": \"\",\n \"addressLine3\": \"\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://staging-vouchers.ventogram.com/api/v1/create-account")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-Api-User"] = '<api-key>'
request["X-Api-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"bvn\": \"46444443431\",\n \"currency\": \"NGN\",\n \"email\": \"rahman+1@gmail.com\",\n \"firstName\": \"rahmann\",\n \"lastName\": \"plus\",\n \"middleName\": \"one\",\n \"phone\": \"+2348033333511\",\n \"dob\": \"25-02-2000\",\n \"country\": \"NG\",\n \"stateOfOrigin\": \"Lagos\",\n \"stateOfResidence\": \"Lagos\",\n \"lgaOfOrigin\": \"Amuwo\",\n \"lgaOfResidence\": \"Ifako\",\n \"addressLine1\": \"27 Obafemi Awolowo Way\",\n \"addressLine2\": \"\",\n \"addressLine3\": \"\"\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"message": "bank account successfully completed",
"data": [
{
"bankCode": "",
"bankName": "Test Bank",
"accountName": "TEST-MANAGED-ACCOUNT",
"accountNumber": "1238314012",
"currency": "NGN"
}
]
}{
"success": false,
"message": "Account completion failed",
"errors": [
"<string>"
]
}Body
application/json
Example:
"46444443431"
Example:
"NGN"
Example:
"rahman+1@gmail.com"
Example:
"rahmann"
Example:
"plus"
Example:
"one"
phone number starting with +234
Example:
"+2348033333511"
Date of birth in dd-mm-yyyy format
Example:
"25-02-2000"
Example:
"NG"
Example:
"Lagos"
Example:
"Lagos"
Example:
"Amuwo"
Example:
"Ifako"
Example:
"27 Obafemi Awolowo Way"
Example:
""
Example:
""
Was this page helpful?
⌘I