Документация Coinetic

Всё для приёма криптовалюты на сайте, в приложении или боте. Интеграция — два запроса к API и один обработчик вебхука.

Как устроена оплата

 Ваш сервер                      Coinetic                           Покупатель
 ──────────                      ────────                           ──────────
 1. POST /v1/invoices  ────────▶ создаёт счёт, возвращает checkout_url
 2. redirect на checkout_url ─────────────────────────────────────▶ страница оплаты
                                 3. покупатель выбирает валюту ◀──── (USDT, USDC, BTC…)
                                    и платит на выданный адрес
                                 4. сеть подтверждает платёж
 5. вебхук invoice.paid ◀─────── POST на ваш URL (подпись HMAC)
 6. GET /v1/invoices/{id} ─────▶ перепроверка статуса
 7. выдача заказа
                                 8. «Вернуться в магазин» ─────────▶ ваш return_url

Четыре правила

• Секрет API-ключа — только на вашем сервере. Ни в браузере, ни в мобильном приложении, ни в git.
• Статус оплаты — только от Coinetic. Не верьте параметрам в return_url и не верьте вебхуку на слово: проверьте подпись, затем перепроверьте статус через GET /v1/invoices/{id}.
• Деньги — строки. Суммы приходят десятичными строками ("49.99") или строками в минимальных единицах ("49990000"). Не превращайте их в float.
• Каждый изменяющий запрос — с Idempotency-Key. Повтор после таймаута вернёт тот же счёт, а не создаст второй.

Базовые адреса

Все ответы — JSON в UTF-8, время — RFC 3339 в UTC. Полный формальный контракт — OpenAPI 3 (openapi.yaml), запросите его у поддержки или в кабинете.

Все эндпоинты мерчанта