Skip to main content

Submit KYC With Token

POST 
/v2/contacts/share_token

This API enables merchants to verify a contact’s identity seamlessly using Sumsub KYC solution. Instead of requiring contacts to upload identification documents and selfies directly, this API leverages a token-based approach. When a contact completes their KYC process through Sumsub interface, a unique verification token is generated. This token represents the validated identity data, eliminating the need for manual document handling. The merchant submits this token along with the contact’s email to finalize the verification process on the server. Additionally, this API allows for automated KYC status tracking through webhook notifications. Merchants can provide a callback URL and an authorization header to receive real-time updates whenever the KYC status changes, ensuring a smooth verification experience without requiring periodic checks. With this approach, merchants can enhance security, streamline identity verification, and provide contacts with a frictionless onboarding experience.

Request​

Responses​

KYC submission successful

Callbacks​

POST 
{$request.body#/endpoint_url}

When the KYC status changes, Hello Clever will call the endpoint_url provided in the Submit KYC request. The call will be made using the HTTP POST method.

The notification will include detailed KYC information for the contact, including the updated status (pending, approved, failed), and other relevant details.

Callbacks Responses​

The merchant's server should return this code