Краткое руководство по интеграции

Подключите платежи в стейблкоинах (USDT / USDC) в четыре шага. Сначала настройте ключ API, секрет Webhook и кошельки получения для включенных сетей. В примере справа проверяется ваш ключ API.

1

Создать платежное поручение

Ваш сервер

Вызовите /api/v1/order/create со своей серверной части, указав цену, валюту, сеть и заказ продавца ID. В ответе будет указан ваш настроенный кошелек и окончательная сумма к оплате; несколько заказов могут использовать один и тот же кошелек.

GET /api/v1/ping проверяет ваш ключ API. Для создания заказа также требуется timestamp и подпись запроса.
2

Показать сведения о платеже

Ваш интерфейс

Откройте checkoutUrl из ответа или покажите сумму, адрес, сеть и валюту из объекта payment. Средства поступают напрямую в настроенный кошелёк.

Используйте полный payment.amount. payment.qrData содержит QR data, а не изображение.
3

Дождитесь подтверждения платежа

BoltUtil

BoltUtil сопоставляет переводы по сети, валюте, кошельку и сумме, а затем отправляет уведомление связанному notifyUrl, когда требования подтверждения выполняются. Приемлемые исключения из платежей требуют проверки продавцом.

Подтверждение и доставка зависят от состояния блокчейна и сети. Перенаправление страницы не является подтверждением оплаты.
4

Проверить и выполнить

Ваш сервер

Проверьте подпись исходного тела и метку времени, затем свяжите событие с заказом. Проверьте сумму к оплате, оплаченную сумму и тип расчёта. Возвращайте HTTP 2xx после надёжного сохранения события и не повторяйте исполнение того же заказа.

Определяйте повторные события по eventId и не исполняйте один бизнес-заказ несколько раз. При вручную принятой недоплате оплаченная сумма может быть меньше суммы к оплате.

Сети и валюты

Проверьте поддерживаемые валюты, версии токенов и правила подтверждения платежей.

Просмотр поддерживаемых сетей →