Создание KYC сессии
Создаёт новую сессию для прохождения KYC верификации пользователем.
Аутентификация
Параметры запроса
Уровень верификации:
basic - базовая верификация (документ + селфи)
advanced - расширенная верификация (+ подтверждение адреса)
URL для редиректа после завершения верификации
Произвольные данные для связи с вашей системой (например, ID пользователя)
Язык интерфейса верификации: ru, en, kz
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"
}'
Пример ответа
Уникальный идентификатор сессии
Статус сессии: pending, in_progress, completed, failed, expired
URL страницы верификации для пользователя
Дата истечения сессии (по умолчанию: 24 часа)
{
"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"
}
Процесс верификации
Создайте сессию
Вызовите API для создания KYC сессии
Перенаправьте пользователя
Направьте пользователя на verificationUrl
Пользователь проходит верификацию
Пользователь загружает документы и делает селфи
Автоматическая проверка
Система проверяет документы (обычно 1-5 минут)
Результат
Пользователь перенаправляется на redirectUrl, вы получаете вебхук
Уровни верификации
| Уровень | Требования | Время проверки |
|---|
basic | Документ (паспорт/ID) + селфи | 1-5 минут |
advanced | Документ + селфи + подтверждение адреса | 5-30 минут |
Ошибки
| Код | Описание |
|---|
| 400 | Неверные параметры запроса |
| 401 | Неверный API ключ |
| 422 | Валидация не пройдена |