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.

Deprecated

Starting a KYC (Know Your Customer) verification with the current documents uploaded.

post

Starting a KYC (Know Your Customer) verification with the current documents uploaded.

Access to this endpoint requires a valid API key. The API key is sent in the x-api-key header on requests. Requirements to start the KYC verification process:

  • the customer has a bank account;

  • the customer has a KYC application;

  • the customer has uploaded all the necessary documents;

  • the customer has KYC status KYC_PENDING or SOFT_KYC_FAILED.

Authorizations
Path parameters
idstringRequired
  • The external identifier for the customer for whom KYC verification is being initiated.
Responses
204

KYC verification started

application/json
post
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