Skip to main content
GET
https://loveandpay.io
/
api
/
v1
/
invoices
/
{id}
Получение счёта
curl --request GET \
  --url https://loveandpay.io/api/v1/invoices/{id} \
  --header 'x-api-key: <x-api-key>'
{
  "id": "<string>",
  "amount": 123,
  "currency": "<string>",
  "status": "<string>",
  "paymentUrl": "<string>",
  "description": "<string>",
  "metadata": {},
  "qrCodeUrl": "<string>",
  "sbpTransactionId": "<string>",
  "payerBank": "<string>",
  "createdAt": "<string>",
  "expiresAt": "<string>",
  "paidAt": "<string>"
}

Получение счёта по ID

Возвращает полную информацию о счёте по его уникальному идентификатору.

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

x-api-key
string
required
Ваш API ключ

Path параметры

id
string
required
Уникальный идентификатор счёта (например: inv_abc123def456)

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

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

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

id
string
Уникальный идентификатор счёта
amount
number
Сумма счёта
currency
string
Валюта счёта
status
string
Статус счёта: pending, paid, expired, cancelled
paymentUrl
string
URL страницы оплаты
description
string
Описание счёта
metadata
object
Произвольные данные, переданные при создании
qrCodeUrl
string
URL QR-кода для оплаты через СБП
sbpTransactionId
string
ID транзакции в системе СБП (появляется после оплаты)
payerBank
string
Название банка плательщика (появляется после оплаты)
createdAt
string
Дата создания в формате ISO 8601
expiresAt
string
Дата истечения в формате ISO 8601
paidAt
string
Дата оплаты в формате ISO 8601 (только для оплаченных счетов)
Успешный ответ (200)
{
  "id": "inv_abc123def456",
  "amount": 1500.00,
  "currency": "RUB",
  "description": "Оплата заказа #12345",
  "status": "paid",
  "paymentUrl": "https://pay.loveandpay.io/inv_abc123def456",
  "metadata": {
    "orderId": "12345",
    "customerEmail": "[email protected]"
  },
  "qrCodeUrl": "https://pay.loveandpay.io/qr/inv_abc123def456",
  "sbpTransactionId": "SBP1234567890",
  "payerBank": "Сбербанк",
  "createdAt": "2024-01-15T10:30:00Z",
  "expiresAt": "2024-01-16T10:30:00Z",
  "paidAt": "2024-01-15T10:35:00Z"
}

Статусы счёта

СтатусОписание
pendingОжидает оплаты
paidУспешно оплачен
expiredИстёк срок оплаты
cancelledОтменён

Ошибки

КодОписание
401Неверный API ключ
404Счёт не найден