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.
The response for this API may take several minutes in some cases.
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, orSOFT_KYC_FAILED.
- The external identifier of the customer for whom KYC verification is being started.
KYC verification started
Database violation
Unauthorized
Internal server error
POST /api/v2/customer/{id}/bank-transfer/kyc/verification HTTP/1.1
Host: api.xgateway.tech
x-api-key: YOUR_API_KEY
Accept: */*
{
"data": "KYC verification started",
"success": true
}Last updated