От регистрации до первого платежа
— семь шагов
Большую часть делает мастер подключения в кабинете. От разработчика — около 50 строк кода на сервере.
-
2 минуты
Зарегистрируйтесь
В кабинете нажмите «Регистрация»: название бизнеса, email, пароль. Подтвердите email по ссылке из письма.
-
1 минута
Включите второй фактор
Обязательно для всех: приложение-аутентификатор (TOTP). Мастер подключения начинается после него. Позже можно добавить ключи доступа (passkeys).
-
10 минут
Укажите кошельки приёма
Куда приходят оплаты. Нужны только публичные данные — сид-фразу и приватные ключи никогда не вводите ни у нас, ни где-либо ещё.
- Bitcoin, Litecoin, TRON — xpub/zpub аккаунта из Ledger Live, Sparrow, Trust Wallet и т. п.; мы покажем первые адреса, сверьте их с кошельком.
- Ethereum, BSC, Polygon, Base, Arbitrum — кошелёк сбора (лучше мультиподпись Safe).
- Solana — адрес получателя.
-
1 минута
Выберите активы
Какие монеты и сети предлагать покупателям. Начать проще всего со стейблкоинов USDT и USDC: цена 1:1 к доллару, без курсового риска.
-
2 минуты
Создайте ключ API и вебхук
«Ключи и вебхуки»: секрет ключа и секрет вебхука показываются один раз — сразу положите их в секрет-менеджер или переменные окружения сервера.
-
1 вечер
Интегрируйте и проверьте в песочнице
Создание счёта, редирект, обработчик вебхука. В песочнице — отдельный кабинет и ключи, платежи без реальных денег. Прогоните сценарии: точная оплата, недоплата с доплатой, переплата, истёкший счёт, повтор вебхука.
- Быстрый старт — код для Node.js, PHP, Python и Go
- Песочница — тестовые платежи кнопками
-
после проверки
Отправьте на одобрение и запускайтесь
Мастер отправит заявку на проверку. После одобрения выпустите отдельный продакшен-ключ и пройдите чек-лист запуска.
Что понадобится
- Кошельки, которые контролируете выАппаратный кошелёк или мультиподпись — для бизнеса надёжнее мобильного.
- Сервер с HTTPSВебхуки принимаются только по
https://на порт 443 (в песочнице — иlocalhost). - Синхронизированные часыПодпись запроса действует ±5 минут — включите NTP.
- Место для секретовСекрет-менеджер или переменные окружения. Не git, не браузер, не мобильное приложение.
Весь код в одной схеме
# 1. Покупатель нажал «Оплатить»
invoice = client.createInvoice({order_id, price_amount: "49.99", price_currency: "USD",
return_url}, idempotencyKey = "order-" + order_id)
redirect(invoice.checkout_url)
# 2. Coinetic прислал вебхук (сырое тело!)
event = verifyWebhook(WEBHOOK_SECRET, headers, rawBody) # иначе 400/401
if seen(event.id): return 200 # повторная доставка
inv = client.getInvoice(event.data.invoice_id) # статус — только из API
if inv.status in ["paid", "overpaid"]: grantOnce(inv.order_id)
return 200
Готовы начать?
Регистрация бесплатна, песочница — тоже.