Paytrie Developer Documentation
Integrations

Sumsub Reusable KYC

Import existing KYC verification from Sumsub

View as Markdown

If your users have already completed KYC verification through Sumsub with your platform, you can import their verification data to Paytrie. This eliminates the need for users to complete identity verification again.

Overview

Sumsub's Reusable KYC feature allows identity verification data to be shared between platforms. As a "Donor" platform, you generate a share token for a user's verification data, which Paytrie then imports as the "Recipient" platform.

Prerequisites

  • Your platform must be integrated with Sumsub
  • The user must have completed KYC verification on your platform
  • You must have API access to generate Sumsub share tokens
  • The user must already exist in Paytrie (create them first using generateApiLink)
  • The Sumsub applicant must be enrolled and verified in the id-and-liveness verification level

Integration flow

Create API user in Paytrie

Register the user in Paytrie first using generateApiLink so the import can map the Sumsub applicant to an existing Paytrie user.

Generate share token

Use the Sumsub API to generate a share token for the user's verification data from an applicant verified in the id-and-liveness level.

Submit to Paytrie

Send the share token to the Paytrie import endpoint.

User verified

If successful, the user is automatically verified on Paytrie without additional KYC.

Quick start

1. Create the user in Paytrie

Create the Paytrie user first:

curl -X POST "https://api.paytrie.com/generateApiLink" \
  -H "x-api-key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "first_name": "John",
    "last_name": "Doe",
    "email": "john.doe@example.com",
    "phone": "4165551234",
    "dob": "1990-01-15",
    "address1": "123 Main Street",
    "address2": "Suite 100",
    "city": "Toronto",
    "province": "on",
    "postal": "M5V1A1",
    "occupation": "Software Engineer",
    "pep": false,
    "tpd": false
  }'

API Reference: Generate API Link

View complete request parameters and response schema

2. Generate a share token (Sumsub API)

Use the Sumsub API to generate a share token for a specific applicant that is verified in your Sumsub id-and-liveness level:

curl -X POST "https://api.sumsub.com/resources/applicants/{applicantId}/shareToken" \
  -H "X-App-Token: your-sumsub-token" \
  -H "X-App-Access-Sig: your-signature" \
  -H "X-App-Access-Ts: timestamp"

See the Sumsub documentation for complete details.

3. Import to Paytrie

Submit the share token to import the user's verification:

curl -X POST "https://api.paytrie.com/sumsubImportUser" \
  -H "x-api-key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "share_token": "_act-sb-jwt-eyJHGCi........tN0."
  }'

API Reference: Import Sumsub User

View complete request parameters and response schema

Common errors

ErrorDescriptionSolution
Token expiredThe share token has expiredGenerate a new share token
Token invalidThe share token is malformedVerify the token format
Applicant not foundThe applicant doesn't exist in SumsubVerify the applicant ID
Verification incompleteThe user hasn't completed verificationEnsure KYC is complete before generating token
Share token not suitable for levelThe share token comes from a different Sumsub levelEnroll and verify applicants in id-and-liveness, then generate a new token

Additional resources

On this page