🆔Shared KYC
By enabling Sumsub’s reusable verification mechanism, previously verified in you system users can reuse their existing KYC status instead of completing the full verification process again. This significantly improves user experience by:
Minimizing repeated document submissions
Increasing conversion rates
Shortening time to verification
Reducing friction during onboarding
To support KYC sharing implementation refer to our partner documentation:
https://docs.sumsub.com/docs/reusable-kyc-via-api
Generate token for your user using
https://docs.sumsub.com/reference/generate-share-token
Provide shared token to merchantShareUserData.shareToken
request field
Request Body Example:
{
"type": "FIXED_PRICE", // Type of checkout
"fixedAmount": {
"amount": 100, // User pay amount
"currency": "USD" // User pay currency
},
"clientOrderId": "unique-merchant-id", // If provided, can be used to identify checkout
"expiresAt": "2026-01-31T00:00:00Z", // Checkout expiration date
"merchantShareUserData": {
"email": "user@example.com", // User email in merchant system
"shareToken": "share_token_abc123" // Sumsub-generated share token
},
"name": "100 USD Top Up", // Will be displayed on checkout page
"returnUrl": "https://merchant-site.com/success?id=unique-merchant-id" // If provided, user will be redirected on payment complete
}Last updated
Was this helpful?