
Интеграция с клиентом Go
Только стандартная библиотека. Создаёт адреса для приёма платежей и проверяет подпись каждого callback.
Быстрый старт с APIТребования
- Go 1.24 или новее. Клиент использует только стандартную библиотеку.
- Базовый URL шлюза, кошелёк выплат и публичный callback URL. Публичным вызовам не нужен API-ключ.
Установка и настройка
- Добавьте github.com/Suawave-Payment-System/suawave/sdk/go в свой модуль и импортируйте как suawave.
- Создайте клиент через suawave.New с базовым URL шлюза и пустыми учётными данными для публичных операций.
- Вызовите PublicCreate с тикером, адресом выплат и уникальным callback URL для каждого заказа. Покажите AddressIn и требуемую сумму токенов в приложении.
- Один раз получите PublicCallbackKey и кешируйте его. VerifyRequest проверяет исходные байты callback; сохраняйте UUID callback в одной транзакции с изменением заказа и подтверждайте сохранённые события через AckPublicCallback.
Что видит покупатель
Ваше приложение строит страницу оплаты по полученному адресу и суммам. Клиент предоставляет вызовы API и проверку callback; готовая страница оплаты и автоматическое обновление заказов магазина в него не входят.
Обработка платежей
- PublicInfo, PublicLogs, PublicEstimate, PublicQRCode и вспомогательные функции конвертации покрывают публичный API. Суммы остаются десятичными строками.
- Выполняйте заказ только после проверенного callback о подтверждённом платеже. Встроенный ReplayGuard хранится в памяти одного процесса; для надёжной обработки заказов нужна проверка уникальности каждого UUID callback в базе данных.
Сети и комиссии для платежей USDT · Руководства по интеграции платежей