Skip to main content

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

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
Максимум счетов в batch1,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

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

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