...
With this service, the calling apps can do KYC with the customer's bvn. This service will return maximum KYC information. Apps will forward collect the account number they will like to obtain information on and forward to OnePipe. If authorisation details are required by a provider, apps will have to provide this. OnePipe will in turn forward to the provider’s dedicated implementation.
...
| Code Block | ||
|---|---|---|
| ||
{
"status": "Successful",
"message": "Transaction processed successfully",
"data": {
"provider_response_code": "00",
"provider": "Beeceptor",
"errors": null,
"error": null,
"provider_response": {
"bvn": "22333055555",
"first_name": "John",
"middle_name": "Jane",
"last_name": "Doe",
"dob": "091990-Dec12-199022",
"phone_number_1": "07037608648",
"phone_number_2": "",
"registration_date": "1990-12-Sep-201522",
"enrollment_bank": "011",
"enrollment_branch": "MATORI",
"email": "john.doe@gmail.com",
"gender": "Male",
"level_of_account": "Level 2 - Medium Level Accounts",
"lga_of_origin": "Owerri West",
"lga_of_residence": "Ikeja",
"marital_status": "Single",
"nin": "77766492344",
"name_on_card": "John Jane Doe",
"nationality": "Nigeria",
"residential_address": "34, Banjo Street, Ikeja, Lagos",
"state_of_origin": "Imo State",
"state_of_residence": "Lagos State",
"title": "Mr",
"watchlisted": "NO",
"base64_image": "{{Base64Image}}"
}
}
} |
...
| Code Block |
|---|
{
"status": "Successful",
"message": "Operation was successful",
"data": {
"provider_responde_code":"00",
"provider": "Polaris",
"errors": null,
"error": null,
"provider_response": {
"bvn": "22333055555",
"first_name": "John",
"middle_name": "Jane",
"last_name": "Doe",
"dob": "09-Dec-1990yyyy-MM-dd-HH-mm-ss",
"phone_number_1": "07037608648",
"phone_number_2": "",
"registration_date": "12-Sep-2015yyyy-MM-dd-HH-mm-ss",
"enrollment_bank": "011",
"enrollment_branch": "MATORI",
"email": "john.doe@gmail.com",
"gender": "Male",
"level_of_account": "Level 2 - Medium Level Accounts",
"lga_of_origin": "Owerri West",
"lga_of_residence": "Ikeja",
"marital_status": "Single",
"nin": "77766492344",
"name_on_card": "John Jane Doe",
"nationality": "Nigeria",
"residential_address": "34, Banjo Street, Ikeja, Lagos",
"state_of_origin": "Imo State",
"state_of_residence": "Lagos State",
"title": "Mr",
"watchlisted": "NO",
"base64_image": "{{Base64Image}}"
}
}
} |
...
Whenever a request is to be validated by OTP, the provider microservice should first call the provider, store response info in the database, send an OTP to the phone number attached to the BVN, then respond with WaitingForOTP.
On the OTP validation phase, if user OTP is valid, provider should retrieve info from the database, then respond with a Successful response.
NB: Data should be erased from the DB.
Special notes for providers
...