Як підключити

Від реєстрації до першого платежу
— сім кроків

Більшу частину робить майстер підключення в кабінеті. Від розробника — близько 50 рядків коду на сервері.

  1. 2 хвилини

    Зареєструйтеся

    У кабінеті натисніть «Реєстрація»: назва бізнесу, email, пароль. Підтвердьте email за посиланням із листа.

  2. 1 хвилина

    Увімкніть другий фактор

    Обов’язково для всіх: застосунок-автентифікатор (TOTP). Майстер підключення починається після нього. Пізніше можна додати ключі доступу (passkeys).

  3. 10 хвилин

    Вкажіть гаманці для приймання

    Куди надходять оплати. Потрібні лише публічні дані — сид-фразу та приватні ключі ніколи не вводьте ні в нас, ні деінде.

    • Bitcoin, Litecoin, TRON — xpub/zpub акаунта з Ledger Live, Sparrow, Trust Wallet тощо; ми покажемо перші адреси, звірте їх із гаманцем.
    • Ethereum, BSC, Polygon, Base, Arbitrum — гаманець для збору коштів (краще мультипідпис Safe).
    • Solana — адреса одержувача.
  4. 1 хвилина

    Оберіть активи

    Які монети й мережі пропонувати покупцям. Почати найпростіше зі стейблкоїнів USDT і USDC: ціна 1:1 до долара, без курсового ризику.

  5. 2 хвилини

    Створіть ключ API та вебхук

    «Ключі та вебхуки»: секрет ключа й секрет вебхука показуються один раз — одразу збережіть їх у менеджері секретів або змінних оточення сервера.

  6. 1 вечір

    Інтегруйте й перевірте в пісочниці

    Створення рахунку, редирект, обробник вебхука. У пісочниці — окремий кабінет і ключі, платежі без справжніх грошей. Проженіть сценарії: точна оплата, недоплата з доплатою, переплата, прострочений рахунок, повтор вебхука.

  7. після перевірки

    Надішліть на схвалення та запускайтеся

    Майстер надішле заявку на перевірку. Після схвалення випустіть окремий продакшн-ключ і пройдіть чекліст запуску.

Що знадобиться

  • Гаманці, які контролюєте виАпаратний гаманець або мультипідпис — для бізнесу надійніше за мобільний.
  • Сервер із 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

Готові почати?

Реєстрація безкоштовна, пісочниця — теж.