Документація 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); запросіть його в підтримки або в кабінеті.

Усі ендпоінти мерчанта