# Криптовалютный инвойс

> Разовый счёт на фиксированную сумму со сроком оплаты и своей страницей оплаты: как в CryptoLike создать инвойс, указать цену, принять оплату и узнать статус.

Source: https://cryptolike.net/ru/glossary/crypto-invoice
Updated: 2026-10-04

Разовый счёт на фиксированную сумму в крипте или в фиате, со сроком оплаты, собственной страницей оплаты и собственным депозитным адресом.

## Как это работает в CryptoLike

В CryptoLike инвойс — это платёж: `POST /v1/invoices` с `amount` и `currency`, где `currency` — фиатная валюта (`USD`, `EUR`) или тикер монеты (`BTC`, `USDT`). В ответе есть `id`, `status: new`, `checkout_url` и `ttl_expires_at`. Передайте `coin_id`, чтобы сразу зафиксировать актив, или не передавайте — тогда плательщик выберет его на странице оплаты, а цена в фиате получит [зафиксированный курс](https://cryptolike.net/ru/glossary/rate-lock). Выбор идёт из монет, доступных для инвойсов (раздел «Монеты» → «Для инвойсов» в кабинете), у каждой видна ориентировочная сумма со знаком ≈; `allowed_coin_ids` сужает список для одного инвойса.

Дальше статус идёт `new` → `pending` → `paid`; платёж может также закончиться статусом `underpaid`, `expired` или `cancelled` (`POST /v1/invoices/{id}/cancel`, только из `new`). Каждое изменение приходит вебхуком `invoice.*`. Поля `order_id`, `description` и `metadata` (до 20 строковых пар, не больше 4 КБ, плательщику не показываются) связывают платёж с вашим заказом; `idempotency_by_order_id: true` возвращает открытый платёж того же заказа вместо создания второго.

Без кода платёж создаётся в кабинете (раздел «Инвойсы»: сумма в фиате или крипте, срок оплаты, ссылка возврата, кто платит комиссию платформы) или в Telegram-боте, после чего остаётся отправить клиенту [ссылку на оплату](https://cryptolike.net/ru/glossary/payment-link). `GET /v1/invoices?format=csv` или `?format=xlsx` выгружает список файлом. Пошагово — [как выставить счёт в криптовалюте](https://cryptolike.net/ru/guides/create-crypto-invoice).

## Пример

Минимальному запросу на инвойс CryptoLike нужны только сумма и валюта; `order_id` связывает его с заказом, а `return_url` — ссылка «вернуться в магазин» после оплаты. Отправляйте запрос с заголовком `Idempotency-Key`, чтобы повтор при сбое сети не создал второй инвойс. Остальные поля — `coin_id`, `ttl_seconds`, `metadata` — добавляйте по мере надобности:

```json
{
  "amount": "10.50",
  "currency": "USD",
  "order_id": "A-1001",
  "return_url": "https://shop.example/thanks"
}
```