Identity verification with ConnectPay provider

If you do not have an identity verification (IDV) provider or do not have the possibility to manage your client data, you can use the ConnectPay solution for ID verification.

You can find the IDV endpoint here. This endpoint will give you the link. This link will redirect your client to the ConnectPay-branded IDV provider’s page. After verification is done, you will receive a notification about the status.

You can find the ConnectPay supported providers list in the endpoint description.

Use this endpoint to do IDV for private clients or corporate client representatives.

Identity verification with ConnectPay provider steps:

1. Request identify verification redirect link via endpoint POST Initiate IDV session. With a successful response, you get a redirect link, ConnectPay created personid, and IDV status. The link provided is valid for 24 hours. After this time, a new IDV session needs to be created.
2. With the received link, ask the client to perform identity verification.
3. After successful IDV, the client will be redirected back or to successUrl if provided.
   1. If IDV fails, then the client will be redirected back or to failureUrl if provided.
   2. If IDV is dropped without ending the flow, the client will be redirected back or to dropUrl if provided.
4. The Platform must receive the application status IDV_APPROVED:
   1. via webhook IDV status change notification. You can find information here on how to subscribe to ConnectPay webhooks
   2. or via endpoint GET IDV status
5. If the Platform received the status IDV_DECLINED or IDV_TOKEN_EXPIRED then need to start again from the first step
6. When the Platform has client IDV with the status IDV_APPROVED and ConnectPay created personid that is provided in GET IDV status or IDV status change notification, the Platform needs to provide additional details about the client to open an account. Depending on the client type (private or corporate), the Platform must call POST Initiate personal application or POST Initiate business application.

Possible identity verification statuses

Status	Description
IDV_TOKEN_GENERATED	The IDV of the end user has been approved
IDV_APPROVED	The IDV of the end user has been declined
IDV_DECLINED	The IDV of the end user has expired and a new token must be generated
IDV_TOKEN_EXPIRED	The IDV of the end user has expired and a new token must be generated