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 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.

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

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
}
PreviousUpload KYC documentsNextCheck KYC status

Last updated