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
- The user must already exist in Paytrie under your API key — create them first using
POST /v2/userswith the same API key you'll use for the import - The Sumsub applicant must be enrolled and verified in the
id-and-livenessverification level
Integration flow
Create API user in Paytrie
Register the user in Paytrie first using POST /v2/users and note the returned user ID — the import writes the KYC data to that 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/v2/users" \
-H "x-api-key: your-api-key" \
-H "Content-Type: application/json" \
-d '{
"email": "john.doe@example.com",
"firstName": "John",
"lastName": "Doe",
"dob": "1990-01-15",
"phone": "4165551234",
"addressLine1": "123 Main Street",
"addressLine2": "Suite 100",
"city": "Toronto",
"province": "on",
"postalCode": "M5V1A1",
"occupation": "Software Engineer",
"pep": false,
"tpd": false
}'API Reference: Create a new user
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 Sumsub share token to import the user's verification, using the userId returned when you created the user in step 1.
curl -X PUT "https://api.paytrie.com/v2/users/{userId}/kyc" \
-H "x-api-key: your-api-key" \
-H "Content-Type: application/json" \
-d '{
"type": "sumsub",
"payload": {
"shareToken": "_act-sb-jwt-eyJHGCi........tN0."
}
}'API Reference: Import KYC data for a user
View complete request parameters and response schema
Common errors
| Error | Description | Solution |
|---|---|---|
| Token expired | The share token has expired | Generate a new share token |
| Token invalid | The share token is malformed | Verify the token format |
| Applicant not found | The applicant doesn't exist in Sumsub | Verify the applicant ID |
| Verification incomplete | The user hasn't completed verification | Ensure KYC is complete before generating token |
| Share token not suitable for level | The share token comes from a different Sumsub level | Enroll and verify applicants in id-and-liveness, then generate a new token |
Email is required: the Sumsub share token does not carry an email... | Your Sumsub applicant doesn't have applicantIdentifiers.email set, and you didn't include email in the request | Pass the user's email in the request body (the same email you used when creating the user with POST /v2/users) |
Email in request does not match the email on the Sumsub applicant. | The email you sent and the email Sumsub has on the applicant differ | Send the email that matches the applicant on Sumsub, or create the user with POST /v2/users using the email Sumsub holds before importing |
Unable to import: please complete registration on Paytrie before importing KYC. | No Paytrie user exists for that email under your API key | Make sure you created the user with POST /v2/users first, using the same email and the same API key you're using for the import |