Статус KYC сессии

Получение текущего статуса верификации

GET /api/v1/kyc/sessions/{id}

Статус KYC сессии

cURL

curl --request GET \
  --url https://loveandpay.io/api/v1/kyc/sessions/{id} \
  --header 'x-api-key: <x-api-key>'

200

{
  "id": "<string>",
  "level": "<string>",
  "status": "<string>",
  "verifiedData": {
    "firstName": "<string>",
    "lastName": "<string>",
    "dateOfBirth": "<string>",
    "nationality": "<string>",
    "documentType": "<string>",
    "documentNumber": "<string>"
  },
  "metadata": {},
  "createdAt": "<string>",
  "completedAt": "<string>",
  "failureReason": "<string>",
  "failureDetails": "<string>"
}

Получение статуса KYC сессии

Возвращает текущий статус и детали сессии верификации.

Аутентификация

x-api-key · string · required

Ваш API ключ

Path параметры

id · string · required

Уникальный идентификатор KYC сессии (например: kyc_abc123def456)

Пример запроса

cURL

curl -X GET "https://loveandpay.io/api/v1/kyc/sessions/kyc_abc123def456" \
  -H "x-api-key: YOUR_API_KEY"

Пример ответа (успешная верификация)

id · string

Уникальный идентификатор сессии

level · string

Уровень верификации

status · string

Текущий статус: pending, in_progress, completed, failed, expired

verifiedData · object

Верифицированные данные пользователя (только при status: completed)

Show Поля verifiedData

firstName · string

Имя

lastName · string

Фамилия

dateOfBirth · string

Дата рождения (YYYY-MM-DD)

nationality · string

Гражданство (ISO 3166-1 alpha-2)

documentType · string

Тип документа: passport, id_card, driver_license

documentNumber · string

Номер документа (частично скрыт)

metadata · object

Переданные при создании метаданные

createdAt · string

Дата создания

completedAt · string

Дата завершения (только при status: completed)

Успешная верификация (200)

{
  "id": "kyc_abc123def456",
  "level": "basic",
  "status": "completed",
  "verifiedData": {
    "firstName": "Иван",
    "lastName": "Петров",
    "dateOfBirth": "1990-05-15",
    "nationality": "RU",
    "documentType": "passport",
    "documentNumber": "****5678"
  },
  "metadata": {
    "userId": "user_12345"
  },
  "createdAt": "2024-01-15T10:30:00Z",
  "completedAt": "2024-01-15T10:35:00Z"
}

Пример ответа (неудачная верификация)

failureReason · string

Причина отказа (только при status: failed)

failureDetails · string

Детальное описание причины отказа

Неудачная верификация (200)

{
  "id": "kyc_abc123def456",
  "level": "basic",
  "status": "failed",
  "failureReason": "document_expired",
  "failureDetails": "Срок действия документа истёк",
  "metadata": {
    "userId": "user_12345"
  },
  "createdAt": "2024-01-15T10:30:00Z",
  "failedAt": "2024-01-15T10:35:00Z"
}

Статусы сессии

Статус	Описание
pending	Сессия создана, ожидает начала верификации
in_progress	Пользователь проходит верификацию
completed	Верификация успешно завершена
failed	Верификация не пройдена
expired	Сессия истекла (не использована в течение 24 часов)

Причины отказа

Код	Описание
document_expired	Срок действия документа истёк
document_unreadable	Документ нечитаем или плохого качества
document_mismatch	Данные документа не совпадают
selfie_mismatch	Лицо на селфи не совпадает с фото в документе
suspected_fraud	Подозрение на мошенничество
unsupported_document	Тип документа не поддерживается

Ошибки

Код	Описание
401	Неверный API ключ
404	Сессия не найдена