Введение в API v1

Обзор Love&Pay API v1 для приёма платежей через СБП

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

Рекомендуем перейти на API v2, который включает:

• HMAC-SHA256 подпись запросов
• Защиту от replay-атак
• Rate limiting с детальными заголовками
• Пакетное создание счетов
• Управление клиентами
• И многое другое!

Перейти на API v2 →

Добро пожаловать в Love&Pay API v1

Love&Pay API позволяет интегрировать приём платежей через Систему Быстрых Платежей (СБП) в ваше приложение. С помощью нашего API вы можете:

Создавать счета

Выставляйте счета клиентам для оплаты через СБП

Получать уведомления

Настройте вебхуки через дашборд — моментальные уведомления об оплатах

Верифицировать клиентов

Проводите KYC верификацию для соответствия требованиям регуляторов

Анализировать данные

Получайте подробную аналитику по платежам и конверсии

Попробуйте прямо сейчас

Каждая страница API имеет встроенный API Playground — вы можете тестировать запросы прямо в браузере! Просто введите ваш API ключ в правой панели и нажмите Send.

Базовый URL

Все запросы к API выполняются по адресу:

https://loveandpay.io/api/v1

Версионирование API

Текущая версия API: v1

Love&Pay API постоянно развивается — мы непрерывно работаем над улучшением функциональности, внедрением новых возможностей и совершенствованием алгоритмов взаимодействия.

Принципы версионирования

Обратная совместимость

Мы стремимся сохранять обратную совместимость в рамках одной мажорной версии

Плавная миграция

При выходе новой версии предоставляем подробные инструкции по миграции

Уведомления

Заранее сообщаем о планируемых изменениях через email и документацию

Переходный период

Старая версия продолжает работать минимум 6 месяцев после выхода новой

Что постоянно улучшается

• Скорость обработки — оптимизация алгоритмов для ещё более быстрых платежей
• Надёжность — повышение отказоустойчивости и стабильности системы
• Безопасность — внедрение новейших методов защиты данных
• Новые функции — расширение возможностей API на основе обратной связи
• Интеграции — добавление поддержки новых банков и платёжных методов

Как узнавать об обновлениях

1. Следите за документацией

   Все изменения API отражаются в этой документации

2. Подпишитесь на рассылку

   Важные обновления отправляем на email партнёров

3. Проверяйте заголовки

   В ответах API есть заголовок X-API-Version с текущей версией

При добавлении новых полей в ответы API ваш код должен корректно их игнорировать. Не считайте неизвестные поля ошибкой — это часть нашей стратегии обратной совместимости.

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

API использует API ключи для аутентификации. Передавайте ключ в заголовке x-api-key:

curl -X GET "https://loveandpay.io/api/v1/invoices" \
  -H "x-api-key: YOUR_API_KEY"

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

Формат данных

• Все запросы и ответы используют формат JSON
• Даты передаются в формате ISO 8601 (например: 2024-01-15T10:30:00Z)
• Денежные суммы указываются как числа с плавающей точкой

Коды ответов

Код	Описание
200	Успешный запрос
201	Ресурс успешно создан
400	Неверный запрос
401	Ошибка аутентификации
403	Доступ запрещён
404	Ресурс не найден
422	Ошибка валидации
429	Превышен лимит запросов
500	Внутренняя ошибка сервера

Лимиты

Лимит	Значение
Запросов в минуту	100
Запросов в день	10,000
Максимум счетов в batch	1,000

При превышении лимита вы получите ответ с кодом 429 и заголовком Retry-After.

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

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

   Зарегистрируйтесь и получите ключ в панели управления

2. Создайте счёт

   curl -X POST "https://loveandpay.io/api/v1/invoices" \
     -H "x-api-key: YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{"amount": 1000, "currency": "RUB"}'
   
3. Настройте вебхук

   Создайте вебхук для получения уведомлений об оплате

4. Обработайте оплату

   При получении события invoice.paid выполните действие (отправка товара, активация подписки и т.д.)

Преимущества СБП

Мгновенные платежи

Деньги поступают на счёт в течение нескольких секунд

Низкие комиссии

Комиссия значительно ниже чем у банковских карт

Без карты

Клиенту достаточно мобильного банка

QR-коды

Удобная оплата сканированием QR-кода

SDK и библиотеки

loveandpay-sdk

Официальный TypeScript SDK доступен на npm!

Установка

npm install loveandpay-sdk

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

import { LoveAndPay } from 'loveandpay-sdk';

const client = new LoveAndPay({
  apiKey: process.env.LOVEANDPAY_API_KEY!,
});

// Создание счёта
const invoice = await client.invoices.create({
  amount: 1500,
  currency: 'RUB',
  description: 'Оплата заказа #12345',
});

console.log(`Ссылка для оплаты: ${invoice.paymentLink}`);

Полная документация SDK

Смотрите все методы и примеры использования SDK

Нужна помощь?

Свяжитесь с нашей командой поддержки в онлайн-чате