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.

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
Path parameters
idstringRequired
  • The external identifier of the customer for whom KYC verification is being started.
Responses
204

KYC verification started

application/json
post
/customer/{id}/bank-transfer/kyc/verification
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