Skip to main content
POST
/
api
/
v2
/
kyc
/
sessions
curl -X POST "https://loveandpay.io/api/v2/kyc/sessions" \
  -H "Content-Type: application/json" \
  -H "x-api-key: pk_live_xxx" \
  -H "x-timestamp: 1706012345678" \
  -H "x-signature: a1b2c3d4e5f6..." \
  -d '{
    "invoiceId": "550e8400-e29b-41d4-a716-446655440001",
    "customerEmail": "client@example.com",
    "customerPhone": "+79991234567",
    "customerId": "your-internal-id-123",
    "callbackUrl": "https://yoursite.com/kyc-callback",
    "language": "ru"
  }'

{
  "success": true,
  "session": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "sessionId": "verification-550e8400-e29b-41d4-a716-446655440000",
    "status": "NOT_STARTED",
    "verificationUrl": "https://kyc.loveandpay.io/verify/550e8400-e29b-41d4-a716-446655440000",
    "invoiceId": "550e8400-e29b-41d4-a716-446655440001",
    "customerEmail": "client@example.com",
    "customerPhone": "+79991234567",
    "customerId": "your-internal-id-123",
    "expiresAt": "2024-01-23T12:30:00.000Z",
    "createdAt": "2024-01-23T12:00:00.000Z"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.loveandpay.io/llms.txt

Use this file to discover all available pages before exploring further.

​
Заголовки

​
x-api-key
string
required
Ваш API ключ
​
x-timestamp
string
required
Unix timestamp в миллисекундах
​
x-signature
string
required
HMAC-SHA256 подпись

​
Тело запроса

​
invoiceId
string
UUID счёта для привязки KYC (опционально)
​
customerEmail
string
Email клиента
​
customerPhone
string
Телефон клиента в формате +7XXXXXXXXXX
​
customerId
string
Ваш внутренний ID клиента (для связи с вашей системой)
​
callbackUrl
string
URL для редиректа после верификации
​
language
string
default:"ru"
Язык интерфейса верификации: ru, en, kk
{
  "success": true,
  "session": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "sessionId": "verification-550e8400-e29b-41d4-a716-446655440000",
    "status": "NOT_STARTED",
    "verificationUrl": "https://kyc.loveandpay.io/verify/550e8400-e29b-41d4-a716-446655440000",
    "invoiceId": "550e8400-e29b-41d4-a716-446655440001",
    "customerEmail": "client@example.com",
    "customerPhone": "+79991234567",
    "customerId": "your-internal-id-123",
    "expiresAt": "2024-01-23T12:30:00.000Z",
    "createdAt": "2024-01-23T12:00:00.000Z"
  }
}

curl -X POST "https://loveandpay.io/api/v2/kyc/sessions" \
  -H "Content-Type: application/json" \
  -H "x-api-key: pk_live_xxx" \
  -H "x-timestamp: 1706012345678" \
  -H "x-signature: a1b2c3d4e5f6..." \
  -d '{
    "invoiceId": "550e8400-e29b-41d4-a716-446655440001",
    "customerEmail": "client@example.com",
    "customerPhone": "+79991234567",
    "customerId": "your-internal-id-123",
    "callbackUrl": "https://yoursite.com/kyc-callback",
    "language": "ru"
  }'

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

1

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

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

Перенаправьте клиента

Направьте клиента на verificationUrl
3

Клиент проходит верификацию

Клиент фотографирует документ и делает селфи
4

Получите результат

Результат придёт на вебхук или проверьте через API

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

СтатусОписание
NOT_STARTEDКлиент ещё не начал верификацию
IN_PROGRESSКлиент проходит верификацию
APPROVEDВерификация успешно пройдена
DECLINEDВерификация отклонена
EXPIREDСрок действия сессии истёк