Paytrie Developer Documentation
Integrations

Sumsub Reusable KYC

Import existing KYC verification from Sumsub

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

Integration flow

Quick start

1. Generate a share token (Sumsub API)

Use the Sumsub API to generate a share token for a specific applicant:

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.

2. 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

Additional resources

On this page