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

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

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

В CryptoLike инвойс — это платёж: POST /v1/invoices с amount и currency, где currency — фиатная валюта (USD, EUR) или тикер монеты (BTC, USDT). В ответе есть id, status: new, checkout_url и ttl_expires_at. Передайте coin_id, чтобы сразу зафиксировать актив, или не передавайте — тогда плательщик выберет его на странице оплаты, а цена в фиате получит зафиксированный курс. Выбор идёт из монет, доступных для инвойсов (раздел «Монеты» → «Для инвойсов» в кабинете), у каждой видна ориентировочная сумма со знаком ≈; 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-боте, после чего остаётся отправить клиенту ссылку на оплату. GET /v1/invoices?format=csv или ?format=xlsx выгружает список файлом. Пошагово — как выставить счёт в криптовалюте.

#Пример

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

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