---
title: Документація
description: Документація Coinetic для розробників: швидкий старт, підпис запитів до API, рахунки, сторінка оплати, вебхуки, повернення коштів і пісочниця.
url: https://coinetic.money/uk/docs/
lang: uk
---

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

Усе, щоб приймати криптовалюту на сайті, у застосунку чи боті. Інтеграція — два запити до API та один обробник вебхука.

- [Швидкий старт](https://coinetic.money/uk/docs/quickstart/) — Перша тестова оплата за 15 хвилин: рахунок, редирект, вебхук.
- [Клієнти та приклади](https://coinetic.money/uk/docs/sdks/) — Node.js, PHP, Python, Go — один файл без залежностей.
- [Вебхуки](https://coinetic.money/uk/docs/webhooks/) — Події, підпис, повтори та порядок доставки.
- [Чекліст запуску](https://coinetic.money/uk/docs/go-live/) — Що перевірити, перш ніж приймати справжні гроші.

## Як влаштована оплата

`потік оплати`

```
 Ваш сервер                      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`.** Повтор після тайм-ауту поверне той самий рахунок, а не створить другий.

## Базові адреси

| Середовище | API | Кабінет |
| --- | --- | --- |
| Продакшн | `https://pay.coinetic.money` | [https://dash.coinetic.money/merchant](https://dash.coinetic.money/merchant) |
| Пісочниця | `https://sandbox.coinetic.money` | [https://sandbox.coinetic.money/merchant](https://sandbox.coinetic.money/merchant) |

Усі відповіді — JSON в UTF-8, час — RFC 3339 в UTC. Повний формальний контракт — OpenAPI 3 (`openapi.yaml`); запросіть його в підтримки або в кабінеті.

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

| Метод | Шлях | Що робить |
| --- | --- | --- |
| POST | `/v1/invoices` | [Створити рахунок](https://coinetic.money/uk/docs/invoices/) |
| GET | `/v1/invoices/{id}` | Рахунок, платежі, підтвердження |
| GET | `/v1/invoices` | Список рахунків із фільтрами та курсором |
| GET | `/v1/assets` | Доступні активи та мінімальні суми |
| GET | `/v1/rates` | Довідковий курс (консенсус бірж) |
| POST | `/v1/refunds` | [Заявка на повернення](https://coinetic.money/uk/docs/refunds/) |