search

Initiate KYC verification

The following API is the final step of passing a KYC - it initiates verification of all provided data. It should be used only within SEPA Secure host-to-host flow and only after a merchant provides all required data for a customer.

circle-exclamation

The endpoint always returns 204 status code.

The Verification results are delivered asynchronously via callbacks.

An additional way to confirm the KYC status is using this API.

triangle-exclamation

The response for this API may take several minutes in some cases.

hashtag
Start a KYC verification for a customer.

post

Starts a KYC (Know Your Customer) verification process for the specified customer.

This endpoint starts SumSub KYC verification using the customerā€™s uploaded documents and profile data. It should be called after the customer has uploaded all required KYC documents and accepted the necessary compliance agreements.

Access to this endpoint requires a valid API key, provided via the x-api-key header.

Preconditions for successful verification:

  • The customer must have a user profile (see POST /customer/{id}/bank-transfer/user).

  • The customer must have a KYC applicant (see POST /customer/{id}/bank-transfer/kyc/applicant).

  • The customer must have uploaded all required KYC documents.

  • The customer must have accepted compliance agreements (Privacy Policy, Terms of Service, etc.).

  • The customer must currently have a KYC status of KYC_PENDING, PENDING_KYC_DATA, or SOFT_KYC_FAILED.

Authorizations
x-api-keystringRequired
Path parameters
idstringRequired
  • The external identifier of the customer for whom KYC verification is being started.
Responses
post
/customer/{id}/bank-transfer/kyc/verification
PreviousUpload KYC documentsNextCheck KYC status

Last updated