...
With this service, the calling apps can do KYC with the customer's bvn. This service will return slightly above minimal KYC information. Apps will forward collect the account number BVN 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_number1": "07037608648",
"phone_number2": "",
"registration_date": "1990-12-Sep-201522",
"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"
}
}
} |
...
| 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": "091990-Dec12-199022",
"phone_number1": "07037608648",
"phone_number2": "",
"registration_date": "1990-12-Sep-201522",
"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"
}
}
} |
...
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
...