Skip to main content
POST
https://loveandpay.io
/
api
/
v1
/
invoices
Создание счёта
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>"
}
'
{
  "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 для редиректа после успешной оплаты

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

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": "[email protected]"
    },
    "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": "[email protected]"
  },
  "createdAt": "2024-01-15T10:30:00Z",
  "expiresAt": "2024-01-16T10:30:00Z"
}

Ошибки

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