Identity verification with ConnectPay provider

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

IDV endpoint you can find here. With this endpoint you will get the link. With this link redirect your client to the ConnectPay branded IDV provider’s page. After verification is done, you will get notification about status.

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

Use this endpoint if you want to do IDV for private client or corporate client representatives.

Identity verification with ConnectPay provider steps:

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

Possible identity verification statuses

StatusDescription
IDV_TOKEN_GENERATEDThe IDV token of the end-user has been generated
IDV_APPROVEDThe IDV of the end-user has been approved
IDV_DECLINEDThe IDV of the end-user has been declined
IDV_TOKEN_EXPIREDThe IDV of the end-user has been expired and new token must be generated

Open account for private client

Open account for corporate client

Scroll to Top