
Интеграция с клиентом JavaScript
Типизированный клиент без зависимостей во время выполнения. Вызывает API из Node или браузера и проверяет callback в Node.
Быстрый старт с APIТребования
- Node 20+ или браузер с fetch. Для проверки подписей callback требуется Node с использованием node:crypto.
- Базовый URL шлюза, кошелёк выплат и публичный callback URL. Публичным вызовам не нужен API-ключ.
Установка и настройка
- Установите @suawave/gateway-client в приложении. Пакет предоставляет ESM, CommonJS и объявления типов без зависимостей во время выполнения.
- Создайте GatewayClient с вашим baseUrl и вызывайте publicCreate с тикером, адресом выплат и уникальным callback URL для каждого заказа.
- Используйте publicQrCode, publicLogs, publicInfo, publicEstimate и методы конвертации по мере необходимости для построения процесса оплаты.
- На сервере Node импортируйте verifyCallbackSignature из @suawave/gateway-client/verify. Получите и кешируйте publicCallbackKey, затем проверяйте точный полный GET URL или исходное тело POST перед применением callback.
Что видит покупатель
Приложение показывает полученный адрес приёма, сумму токенов и QR-код. Клиент не добавляет способ оплаты в магазин и не обновляет заказы автоматически; страницу оплаты и обработчик callback реализуете вы.
Обработка платежей
- Суммы представлены десятичными строками. Для целочисленной арифметики используйте встроенные функции работы с минимальными единицами актива вместо значений JavaScript number.
- Каждая операция принимает сигнал отмены, а таймаут запросов настраивается. Функции проверки подписи находятся в отдельной точке входа verify только для Node, поэтому основной клиент можно включать в браузерную сборку.
Сети и комиссии для платежей USDT · Руководства по интеграции платежей