QR-код счёта

Получение QR-кода для оплаты счёта

GET /api/v1/invoices/{id}/qrcode

QR-код счёта

cURL

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

Получение QR-кода

Возвращает QR-код для оплаты счёта в формате PNG или SVG.

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

x-api-key · string · required

Ваш API ключ

Path параметры

id · string · required

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

Query параметры

format · string · default: "png"

Формат изображения: png или svg

size · number · default: "256"

Размер изображения в пикселях (от 128 до 1024)

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

cURL (PNG)

curl -X GET "https://loveandpay.io/api/v1/invoices/inv_abc123def456/qrcode?format=png&size=512" \
  -H "x-api-key: YOUR_API_KEY" \
  --output qrcode.png

Ответ

Эндпоинт возвращает бинарные данные изображения с соответствующим Content-Type:

• image/png для формата PNG
• image/svg+xml для формата SVG

Использование в HTML

<!-- Прямая ссылка (требует аутентификации через query параметр) -->
<img src="https://loveandpay.io/api/v1/invoices/inv_abc123def456/qrcode?size=256"
     alt="QR код для оплаты" />

<!-- Или через data URL (на сервере) -->
<img src="data:image/png;base64,{base64_encoded_qr}"
     alt="QR код для оплаты" />

Пример интеграции

React

function PaymentQR({ invoiceId }) {
  const [qrUrl, setQrUrl] = useState(null);

  useEffect(() => {
    async function fetchQR() {
      const response = await fetch(
        `/api/invoices/${invoiceId}/qrcode?format=png&size=300`,
        { headers: { 'x-api-key': API_KEY } }
      );
      const blob = await response.blob();
      setQrUrl(URL.createObjectURL(blob));
    }
    fetchQR();
  }, [invoiceId]);

  return qrUrl ? <img src={qrUrl} alt="QR код для оплаты" /> : <p>Загрузка...</p>;
}

Ошибки

Код	Описание
400	Неверные параметры (формат или размер)
401	Неверный API ключ
404	Счёт не найден
410	Счёт истёк или отменён