🆕 Создание KYC верификации

Code samples

PUT /webapi/kyc

Body parameter

{
  "email": "user@example.com",
  "country_restriction_mode": "all",
  "allowed_countries": ["ru", "kz"],
  "allowed_document_types": ["passport", "id_card"]
}

🛠️ Параметры

Name	In	Type	Required	Description
body	body	object	true	none
» email	body	string(email)	true	Email адрес для верификации
» country_restriction_mode	body	string	false	Режим ограничения по странам: `all` или `whitelist`
» allowed_countries	body	string[]	false	Список разрешенных стран (ISO-коды)
» allowed_document_types	body	string[]	false	Список разрешенных типов документов

Example responses

200 Response

{
  "success": true,
  "item": {
    "id": 1,
    "uuid": "550e8400-e29b-41d4-a716-446655440000",
    "user_id": 123,
    "email": "user@example.com",
    "status": 0,
    "step": 0,
    "country_restriction_mode": "all",
    "allowed_countries": null,
    "allowed_document_types": null,
    "liveness_status": 0,
    "liveness_attempts": 0,
    "created_at": "2023-12-01T09:00:00Z",
    "updated_at": "2023-12-01T09:00:00Z"
  }
}

🔁 Ответы

Status	Meaning	Description	Schema
200	OK	KYC верификация успешно создана	Inline
401	Unauthorized	Не авторизован	Inline
422	Unprocessable Entity	Ошибка валидации	Inline

📋 Response Schema

KycVerification

Name	Type	Description
id	integer	Идентификатор
uuid	string(uuid)	UUID верификации
user_id	integer	Идентификатор пользователя
email	string	Email
status	integer	0: новый, 1: в процессе, 2: на модерации, 3: отклонён, 4: успешен
step	integer	Текущий шаг
country_restriction_mode	string	`all` или `whitelist`
allowed_countries	string[]	Разрешённые страны
allowed_document_types	string[]	Разрешённые типы документов
liveness_status	integer	0: ожидание, 1: успех, 2: отказ
liveness_attempts	integer	Количество попыток liveness