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

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

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

- [Быстрый старт](https://coinetic.money/ru/docs/quickstart/) — Первая тестовая оплата за 15 минут: счёт, редирект, вебхук.
- [Клиенты и примеры](https://coinetic.money/ru/docs/sdks/) — Node.js, PHP, Python, Go — один файл без зависимостей.
- [Вебхуки](https://coinetic.money/ru/docs/webhooks/) — События, подпись, повторы и порядок доставки.
- [Чек-лист запуска](https://coinetic.money/ru/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/ru/docs/invoices/) |
| GET | `/v1/invoices/{id}` | Счёт, платежи, подтверждения |
| GET | `/v1/invoices` | Список счетов с фильтрами и курсором |
| GET | `/v1/assets` | Доступные активы и минимальные суммы |
| GET | `/v1/rates` | Справочный курс (консенсус бирж) |
| POST | `/v1/refunds` | [Заявка на возврат](https://coinetic.money/ru/docs/refunds/) |