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

Получение информации о конкретном счёте по ID

GET /api/v1/invoices/{id}

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

cURL

curl --request GET \
  --url https://loveandpay.io/api/v1/invoices/{id} \
  --header 'x-api-key: <x-api-key>'

200

{
  "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

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": "[e-mail]"
  },
  "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	Счёт не найден