Create Customer - (Full KYC)
This endpoint is used to create an account for a customer issuing a card. A customer tracking ID is returned which can be used access other resource such as virtual card, USD, GBP, EUR accounts etc.
Last updated
This endpoint is used to create an account for a customer issuing a card. A customer tracking ID is returned which can be used access other resource such as virtual card, USD, GBP, EUR accounts etc.
Last updated
curl --location '{{base_url}}/business/fullkyc-customer' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer SECRET_KEY' \
--data-raw '{
"first_name": "John",
"last_name": "Doe",
"phone_number": "07012345678",
"bvnno": "20123456780",
"birth_date": "2000-03-23",
"nationality": "NGR",
"middle_name": "Faith",
"gender": "male",
"employment_status": "EMPLOYED",
"email_address": "[email protected]",
"taxno": "29323239D2",
"address": {
"house_no": "5",
"street": "queen Estate, Alen road",
"city": "Ikeja",
"state": "Lagos State",
"country": "Nigeria",
"postal_code": "110320"
},
"identity": {
"idtype": "National identity",
"idno": "24H675B9084",
"expiry_date": "24H675B9084",
"idfront_url": "https://res.cloudinary.com/site/image/upload/v1714257348/idcard2.png",
"idback_url": "https://res.cloudinary.com/site/image/upload/v1714257348/idcard2.png",
"issuance_country": "Nigeria"
}
}'const axios = require('axios');
let data = JSON.stringify({
"first_name": "John",
"last_name": "Doe",
"phone_number": "07012345678",
"bvnno": "20123456780",
"birth_date": "2000-03-23",
"nationality": "NGR",
"middle_name": "Faith",
"gender": "male",
"employment_status": "EMPLOYED",
"email_address": "[email protected]",
"taxno": "29323239D2",
"address": {
"house_no": "5",
"street": "queen Estate, Alen road",
"city": "Ikeja",
"state": "Lagos State",
"country": "Nigeria",
"postal_code": "2323"
},
"identity": {
"idtype": "National identity",
"idno": "24H675B9084",
"expiry_date": "24H675B9084",
"idfront_url": "https://res.cloudinary.com/site/image/upload/v1714257348/idcard2.png",
"idback_url": "https://res.cloudinary.com/site/image/upload/v1714257348/idcard2.png",
"issuance_country": "Nigeria"
}
});
let config = {
method: 'post',
maxBodyLength: Infinity,
url: '{{base_url}}/business/fullkyc-customer',
headers: {
'Content-Type': 'application/json',
'Authorization': 'Bearer SECRET_KEY'
},
data : data
};
axios.request(config)
.then((response) => {
console.log(JSON.stringify(response.data));
})
.catch((error) => {
console.log(error);
});
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => '{{base_url}}/business/fullkyc-customer',
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 =>'{
"first_name": "John",
"last_name": "Doe",
"phone_number": "07012345678",
"bvnno": "20123456780",
"birth_date": "2000-03-23",
"nationality": "MGR",
"middle_name": "Faith",
"gender": "male",
"employment_status": "EMPLOYED",
"email_address": "[email protected]",
"taxno": "29323239D2",
"address": {
"house_no": "5",
"street": "queen Estate, Alen road",
"city": "Ikeja",
"state": "Lagos State",
"country": "Nigeria",
"postal_code": "2323"
},
"identity": {
"idtype": "National identity",
"idno": "24H675B9084",
"expiry_date": "24H675B9084",
"idfront_url": "https://res.cloudinary.com/site/image/upload/v1714257348/idcard2.png",
"idback_url": "https://res.cloudinary.com/site/image/upload/v1714257348/idcard2.png",
"issuance_country": "Nigeria"
}
}',
CURLOPT_HTTPHEADER => array(
'Content-Type: application/json',
'Authorization: Bearer SECRET_KEY',
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
var headers = {
'Content-Type': 'application/json',
'Authorization': 'Bearer SECRET_KEY'
};
var request = http.Request('POST', Uri.parse('{{base_url}}/business/fullkyc-customer'));
request.body = json.encode({
"first_name": "John",
"last_name": "Doe",
"phone_number": "07012345678",
"bvnno": "20123456780",
"birth_date": "2000-03-23",
"nationality": "NGR",
"middle_name": "Faith",
"gender": "male",
"employment_status": "EMPLOYED",
"email_address": "[email protected]",
"taxno": "29323239D2",
"address": {
"house_no": "5",
"street": "queen Estate, Alen road",
"city": "Ikeja",
"state": "Lagos State",
"country": "Nigeria",
"postal_code": "2323"
},
"identity": {
"idtype": "National identity",
"idno": "24H675B9084",
"expiry_date": "24H675B9084",
"idfront_url": "https://res.cloudinary.com/site/image/upload/v1714257348/idcard2.png",
"idback_url": "https://res.cloudinary.com/site/image/upload/v1714257348/idcard2.png",
"issuance_country": "Nigeria"
}
});
request.headers.addAll(headers);
http.StreamedResponse response = await request.send();
if (response.statusCode == 200) {
print(await response.stream.bytesToString());
}
else {
print(response.reasonPhrase);
}
{
"status": true,
"responsecode": "01",
"message": "Customer account fully created for John Doe",
"trackid": "06211211"
}{
"status": false,
"responsecode": "00",
"message": "Unable to process request. Invalid authorization key",
"trackid": ""
}