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

Инициирование процесса верификации пользователя

POST /api/v1/kyc/sessions

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

cURL

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>"
}
'

200

{
  "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

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": "[e-mail]"
    },
    "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": "[e-mail]"
  },
  "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	Валидация не пройдена