Введение в API v2

Love&Pay API v2 с усиленной безопасностью

API v1 будет отключён 25.01.2026!

Пожалуйста, мигрируйте на API v2 до этой даты. API v1 перестанет работать и все запросы будут возвращать ошибку.

Что нового в API v2

API v2 включает значительные улучшения безопасности и новые возможности:

HMAC-SHA256 подпись

Все запросы подписываются криптографической подписью

Rate Limiting

Защита от перегрузки с детальными заголовками

Защита от циклов

Автоматическая блокировка повторяющихся запросов

Batch операции

Массовое создание счетов из CSV/JSON

Базовый URL

https://loveandpay.io/api/v2

Ключевые отличия от v1

Функция	API v1	API v2
Аутентификация	Только x-api-key	HMAC-SHA256 подпись
Timestamp	Не требуется	В миллисекундах
Rate Limiting	Нет	100/мин, 1000/час
Защита от циклов	Нет	Есть
Batch операции	Нет	Есть
Управление клиентами	Ограничено	Полное
Чеки (anti-fraud)	Нет	Есть

Обязательные заголовки

Каждый запрос к API v2 должен содержать:

Заголовок	Описание
x-api-key	Ваш API ключ партнёра
x-timestamp	Unix timestamp в миллисекундах
x-signature	HMAC-SHA256 подпись запроса

Быстрый старт

1. Получите ключи API

Перейдите в Панель управления → Настройки API и сгенерируйте новый секретный ключ для API v2.

2. Установите SDK (опционально)

npm install @loveandpay/sdk

3. Сделайте первый запрос

const crypto = require('crypto');

const API_KEY = 'pk_live_xxx';
const SECRET_KEY = 'sk_live_xxx';

function generateSignature(method, path, timestamp, body = '') {
  const bodyHash = crypto.createHash('sha256').update(body).digest('hex');
  const message = `${method.toUpperCase()}${path}${timestamp}${bodyHash}`;
  return crypto.createHmac('sha256', SECRET_KEY).update(message).digest('hex');
}

const timestamp = Date.now().toString();
const method = 'POST';
const path = '/api/v2/invoices';
const body = JSON.stringify({ amount: 1000, description: 'Тестовый счёт' });

const response = await fetch('https://loveandpay.io' + path, {
  method,
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': API_KEY,
    'x-timestamp': timestamp,
    'x-signature': generateSignature(method, path, timestamp, body)
  },
  body
});

console.log(await response.json());

Миграция с v1

1. Сгенерируйте секретный ключ

   В личном кабинете сгенерируйте новый секретный ключ для HMAC подписи

2. Обновите код аутентификации

   Добавьте генерацию HMAC подписи в каждый запрос

3. Обновите URL

   Замените /api/v1/ на /api/v2/ во всех эндпоинтах

4. Протестируйте

   Проверьте работу всех эндпоинтов на тестовых данных

При возникновении вопросов по миграции обращайтесь в поддержку: [e-mail]

---

Следующие шаги

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

Подробно о HMAC подписи

Rate Limiting

Лимиты и защита

Создание счёта

Первый API запрос

Коды ошибок

Обработка ошибок