Identity verification using your provider’s data

If you use your provider for client identity verification (IDV), you can submit a session ID or token for ConnectPay, and ConnectPay will get all the required information from your IDV provider. You can find ConnectPay’s supported IDV providers list in the endpoint description.

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

Note! To set up the Ondato IDV provider in Stage/Production environments we will require your Ondato credentials (ClientID and ClientSecret) to be stored on our end

Identity verification with your provider steps are:

1. Once your client successfully executes identity verification, use the endpoint POST Submit External IDV API. You will need this data:
   • externalReference. It is ID from the Platform system that allows to identification of the client who performed identity verification
   • sessionId. IDV provider’s token or session ID. This information depends on the IDV provider and should be coordinated with ConnectPay
   • providerId. Name of the IDV provider
2. When ConnectPay successfully receives your information and if your provided sessionId is valid, then you will get a response with status IDV_TOKEN_GENERATED and ConnectPay’s created personId
3. The Platform must receive 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
4. If the received status is IDV_DECLINED then start again from the first step
5. When the Platform has client IDV with status IDV_APPROVED and ConnectPay’s created personId, Platform needs to provide additional details about the client to open an account. Depending on the client type (private or corporate), the Platform should call the endpoint POST Personal Onboarding API or POST Business Onboarding API.

Possible identity verification statuses

Supported document types

During IDV verification these document types might be used:

• Passports. This is a default selection for all possible countries.
• ID cards. We support documents issued in EEA only.
• Residence permit. Only Lithuanian issued document is supported.
• Driver license. We support documents issued in EEA and after 2013 Jan 19th (new European format type).

In order to use driver license as acceptable document person.citizenshipCountryCode should be sent in Person onboarding API request. Without this value such identifications will be declined.