Skip to main content
GET
https://loveandpay.io
/
api
/
v1
/
kyc
/
sessions
/
{id}
Статус KYC сессии
curl --request GET \
  --url https://loveandpay.io/api/v1/kyc/sessions/{id} \
  --header 'x-api-key: <x-api-key>'
{
  "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 -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)
​
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Сессия не найдена