Banking as a Service with integrated SCA uses ConnectPay solution for ID verification.
IDV endpoint can be found here. With this endpoint you will get the link. With this link you should redirect your client to the ConnectPay branded IDV provider’s page. After verification is done, you will get notification about status.
Use this endpoint if you want to do IDV for private client or corporate client representatives.
Identity verification with ConnectPay provider steps:
- Request identify verification redirect link via endpoint POST Initiate IDV session API. With success response you will get redirect link, ConnectPay’s created
personid
and IDV status. The link provided is valid for 24 hours. After this time, new IDV session needs to be created. - With the received link ask client to perform identity verification.
- After successful IDV client will be redirected back or to
successUrl
if provided.- If IDV is failed, then client will be redirected back or to
failureUrl
if provided. - If IDV is dropped without ending the flow client will be redirected back or to
dropUrl
if provided.
- If IDV is failed, then client will be redirected back or to
- Platform must receive application status
IDV_APPROVED
:- via webhook IDV status change notification. You can find information here how to subscribe ConnectPay webhooks
- or via endpoint GET IDV status API
- If Platform received status
IDV_DECLINED
or IDV_TOKEN_EXPIRED
then need to start again from the first step - When Platform has client IDV with status
IDV_APPROVED
and ConnectPay createdpersonid
that is provided in GET IDV status API response or IDV status change notification , Platform needs to provide additional details about client to open an account. - To personalize credentials, this user should be logged out using Logout API and perform a new login via Login process. This action is a confirmation a user is linked with certain identity.
- Then a Platform is required to call POST Initiate personal application API with user’s access token. Currently, only private individuals can be onboarded via ConnectPay user solution, corporate onboarding is planned for the future.
Possible identity verification statuses
Status | Description |
---|---|
IDV_TOKEN_GENERATED | The IDV token of the end-user has been generated |
IDV_APPROVED | The IDV of the end-user has been approved |
IDV_DECLINED | The IDV of the end-user has been declined |
IDV_TOKEN_EXPIRED | The IDV of the end-user has been expired and new token must be generated |