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

Создание нового счёта на оплату

POST /api/v1/invoices

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

cURL

curl --request POST \
  --url https://loveandpay.io/api/v1/invoices \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "amount": 123,
  "currency": "<string>",
  "description": "<string>",
  "metadata": {},
  "expiresAt": "<string>",
  "redirectUrl": "<string>",
  "successUrl": "<string>"
}
'

200

{
  "id": "<string>",
  "amount": 123,
  "currency": "<string>",
  "status": "<string>",
  "paymentUrl": "<string>",
  "createdAt": "<string>",
  "expiresAt": "<string>"
}

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

Создаёт новый счёт на оплату через СБП.

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

x-api-key · string · required

Ваш API ключ

Параметры запроса

amount · number · required

Сумма счёта в указанной валюте

currency · string · required

Валюта счёта. Поддерживаемые значения: USD, EUR, RUB, KZT

description · string

Описание счёта (отображается клиенту)

metadata · object

Произвольные данные для вашего использования (например, ID заказа)

expiresAt · string

Дата истечения счёта в формате ISO 8601. По умолчанию: 24 часа

redirectUrl · string

URL для редиректа после успешной оплаты

successUrl · string

URL для мгновенной переадресации клиента после успешной оплаты. Если не указан — клиент остаётся на странице оплаты Love&Pay со статусом «Оплачено». Подробнее — Переадресация после оплаты.

Пример запроса

cURL

curl -X POST "https://loveandpay.io/api/v1/invoices" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 100.00,
    "currency": "USD",
    "description": "Оплата заказа #12345",
    "metadata": {
      "orderId": "12345",
      "customerEmail": "[e-mail]"
    },
    "redirectUrl": "https://yoursite.com/success"
  }'

Пример ответа

id · string

Уникальный идентификатор счёта

amount · number

Сумма счёта

currency · string

Валюта счёта

status · string

Статус счёта: pending, paid, expired, cancelled

paymentUrl · string

URL страницы оплаты для клиента

createdAt · string

Дата создания в формате ISO 8601

expiresAt · string

Дата истечения в формате ISO 8601

Успешный ответ (201)

{
  "id": "inv_abc123def456",
  "amount": 100.00,
  "currency": "USD",
  "description": "Оплата заказа #12345",
  "status": "pending",
  "paymentUrl": "https://pay.loveandpay.io/inv_abc123def456",
  "metadata": {
    "orderId": "12345",
    "customerEmail": "[e-mail]"
  },
  "createdAt": "2024-01-15T10:30:00Z",
  "expiresAt": "2024-01-16T10:30:00Z"
}

Ошибки

Код	Описание
400	Неверные параметры запроса
401	Неверный API ключ
422	Валидация не пройдена