Приём крипто-платежа через инвойс
Приём оплаты в крипте сводится к трём действиям: создать инвойс на сумму, направить плательщика на чекаут и отреагировать на webhook о зачислении. Процессинг, управление адресами и отслеживание подтверждений берём на себя.
- Действующий API-ключ
- Настроенный webhook-эндпоинт и секрет подписи
1Создайте инвойс
Запросите инвойс на сумму в фиате и указанные сети, которые принимаете. В ответ придёт адрес для оплаты и URL чекаута.
curl https://api.1st-node.com/v1/payments/invoices \
-H "Authorization: Bearer sk_live_..." \
-d '{"amount_usd":49,"accept":["eth","tron"]}'2Покажите чекаут
Перенаправьте плательщика на возвращённый URL чекаута или отрисуйте адрес и сумму сами. Инвойс отслеживает недоплату, переплату и подтверждения.
3Подтвердите через webhook
При зачислении срабатывает подписанный webhook (HMAC-SHA256) с id инвойса и статусом. Проверьте подпись, затем отметьте заказ оплаченным. Доставка webhook идемпотентна — повторные события не зачисляют дважды.
> POST /your/webhook X-Signature: <hmac>
> { "invoice":"in_..","status":"settled","amount_usd":49 }Частые вопросы
Как доверять webhook?
Каждое событие подписано по HMAC-SHA256 от сырого тела. Пересчитайте подпись своим секретом и отклоняйте несовпадения.
Можно ли не только принимать, но и выплачивать?
Да — массовые выплаты и зачисление — родственные платёжные примитивы на том же балансе.
Читать дальше
Пополнили, получили ключ, запустили.
Полное самообслуживание. Оплата криптой или картой. Тарификация в кредитах — тяжёлые примитивы дороже, простые дёшевы.
Получить API-ключ