Skip to main content
POST
https://loveandpay.io
/
api
/
v1
/
kyc
/
sessions
Создание KYC сессии
curl --request POST \
  --url https://loveandpay.io/api/v1/kyc/sessions \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "level": "<string>",
  "redirectUrl": "<string>",
  "metadata": {},
  "locale": "<string>",
  "webhookUrl": "<string>"
}
'
{
  "id": "<string>",
  "level": "<string>",
  "status": "<string>",
  "verificationUrl": "<string>",
  "metadata": {},
  "createdAt": "<string>",
  "expiresAt": "<string>"
}

Создание KYC сессии

Создаёт новую сессию для прохождения KYC верификации пользователем.

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

x-api-key
string
required
Ваш API ключ

Параметры запроса

level
string
required
Уровень верификации:
  • basic - базовая верификация (документ + селфи)
  • advanced - расширенная верификация (+ подтверждение адреса)
redirectUrl
string
required
URL для редиректа после завершения верификации
metadata
object
Произвольные данные для связи с вашей системой (например, ID пользователя)
locale
string
default:"ru"
Язык интерфейса верификации: ru, en, kz
webhookUrl
string
URL для отправки результата верификации (альтернатива глобальному вебхуку)

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

curl -X POST "https://loveandpay.io/api/v1/kyc/sessions" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "level": "basic",
    "redirectUrl": "https://yoursite.com/kyc/complete",
    "metadata": {
      "userId": "user_12345",
      "email": "[email protected]"
    },
    "locale": "ru"
  }'

Пример ответа

id
string
Уникальный идентификатор сессии
level
string
Уровень верификации
status
string
Статус сессии: pending, in_progress, completed, failed, expired
verificationUrl
string
URL страницы верификации для пользователя
metadata
object
Переданные метаданные
createdAt
string
Дата создания
expiresAt
string
Дата истечения сессии (по умолчанию: 24 часа)
Успешный ответ (201)
{
  "id": "kyc_abc123def456",
  "level": "basic",
  "status": "pending",
  "verificationUrl": "https://verify.loveandpay.io/kyc_abc123def456",
  "metadata": {
    "userId": "user_12345",
    "email": "[email protected]"
  },
  "createdAt": "2024-01-15T10:30:00Z",
  "expiresAt": "2024-01-16T10:30:00Z"
}

Процесс верификации

1

Создайте сессию

Вызовите API для создания KYC сессии
2

Перенаправьте пользователя

Направьте пользователя на verificationUrl
3

Пользователь проходит верификацию

Пользователь загружает документы и делает селфи
4

Автоматическая проверка

Система проверяет документы (обычно 1-5 минут)
5

Результат

Пользователь перенаправляется на redirectUrl, вы получаете вебхук

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

УровеньТребованияВремя проверки
basicДокумент (паспорт/ID) + селфи1-5 минут
advancedДокумент + селфи + подтверждение адреса5-30 минут

Ошибки

КодОписание
400Неверные параметры запроса
401Неверный API ключ
422Валидация не пройдена