Від реєстрації до першого платежу
— сім кроків
Більшу частину робить майстер підключення в кабінеті. Від розробника — близько 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
Готові почати?
Реєстрація безкоштовна, пісочниця — теж.