Документация

Частые вопросы

Ответы на вопросы о приёме криптоплатежей с Suawave: от создания адреса оплаты до обработки callback о подтверждённом платеже.

Начало работы

Как принимать платежи в USDT TRC20 без аккаунта?

Suawave позволяет принимать платежи в USDT TRC20 без регистрации, без аккаунта и без API-ключа. Вызовите GET /trc20/usdt/create/ с вашим адресом выплат и публичным HTTPS callback URL, затем покажите плательщику полученные address_in и minimum_transaction_coin вместе с активом и сетью выбранного тикера.

Открыть документацию
Как создать отдельный адрес оплаты для каждого заказа?

Для каждого заказа Suawave используйте уникальный callback URL с идентификатором заказа и непредсказуемым nonce. Повторный create с тем же тикером и callback возвращает тот же адрес приёма и сохраняет исходные параметры; храните точный callback URL на своём сервере.

Открыть документацию

Монеты и сети

Какие монеты и сети поддерживает Suawave?

Suawave поддерживает следующие активные платёжные маршруты: USDC в сети BNB Smart Chain BEP20 (bep20/usdc); USDT в сети BNB Smart Chain BEP20 (bep20/usdt); USDT в сети TRON TRC20 (trc20/usdt). Используйте точный тикер выбранного токена и сети в нижнем регистре; один адрес кошелька не определяет стандарт токена.

Открыть документацию
Что происходит, если покупатель отправляет другой токен или выбирает другую сеть?

Suawave обрабатывает только токен и сеть, выбранные для заказа. Другие токены не переводятся и не создают публичных callback или записей в журнале; не рассчитывайте, что платёж в другой сети удастся восстановить или принять.

Открыть документацию

Комиссии и минимумы

Какую комиссию Suawave берёт за платёж?

Suawave рассчитывает комиссию для каждого поступления отдельно: комиссия сервиса с установленным минимумом плюс сетевая комиссия в токене платежа. Уровни комиссии сервиса по обороту в USD за предыдущие 30 дней: Менее $250,000: 0.50%; От $250,000 до $999,999: 0.45%; От $1,000,000 до $2,499,999: 0.40%; От $2,500,000 до $4,999,999: 0.35%; От $5,000,000 до $9,999,999: 0.30%; От $10,000,000 до $19,999,999: 0.20%; От $20,000,000: 0.13%. Опубликованные комиссии в токенах: BNB Smart Chain BEP20 USDC: минимальная комиссия сервиса 0.05 USDC, сетевая комиссия 0.05 USDC; BNB Smart Chain BEP20 USDT: минимальная комиссия сервиса 0.05 USDT, сетевая комиссия 0.05 USDT; TRON TRC20 USDT: минимальная комиссия сервиса 0.05 USDT, сетевая комиссия 1.00 USDT. Комиссии определяются для каждого поступления; fee_coin и value_forwarded_coin содержат фактическую комиссию и сумму выплаты.

Открыть документацию
Какой минимальный криптоплатёж принимает Suawave?

В Suawave для каждого токена и сети установлен отдельный минимум: BNB Smart Chain BEP20 USDC: 1.00 USDC; BNB Smart Chain BEP20 USDT: 1.00 USDT; TRON TRC20 USDT: 10.00 USDT. Перед показом реквизитов оплаты проверьте minimum_transaction_coin в ответе create или info; применимый минимум фиксируется при первом обнаружении каждого поступления.

Открыть документацию
Могут ли несколько поступлений ниже минимума сложиться в допустимый платёж?

Нет. Suawave проверяет минимум отдельно для каждого поступления, поэтому несколько сумм ниже минимума не складываются в допустимый платёж. Такое поступление не переводится и не выплачивается, не вызывает callback и отсутствует в публичных журналах.

Открыть документацию

Подтверждения и финальность

Когда можно отметить платёж Suawave как оплаченный?

Отмечайте заказ оплаченным только после проверки callback Suawave о подтверждённом платеже с pending, равным 0, а также заказа, токена, адреса и суммы. Это событие означает, что допустимое поступление переведено и транзакция перевода подтверждена; одного pending callback недостаточно для выполнения заказа.

Открыть документацию
Сколько подтверждений нужно Suawave и можно ли изменить их число?

Suawave следует правилам финальности выбранной сети, а не числу подтверждений, заданному клиентом. Для TRON ожидаются данные о solidification, а для BNB Smart Chain используются финализированные заголовки блоков; публичный эндпоинт create не принимает своё число подтверждений или настройку приоритета. Индексация и перевод требуют времени, поэтому интервал между блоками не определяет срок завершения оплаты.

Открыть документацию
Означает ли pending webhook, что покупатель оплатил заказ?

Callback Suawave с pending, равным 1, означает, что индексатор обнаружил допустимое поступление, но перевод ещё не подтверждён. Чтобы получать это необязательное событие, укажите pending=1 при первом вызове create; события pending и confirmed могут приходить не по порядку и имеют разные UUID.

Открыть документацию

Callback и проверка подписей

Может ли Suawave отправлять webhook как JSON или form POST?

Да. По умолчанию Suawave отправляет callback методом GET, при post=1 использует form POST, а при json=1 использует JSON POST; если заданы оба параметра, JSON имеет приоритет. Первый вызов create фиксирует эти параметры для пары тикер и callback, а ваши query-параметры остаются в callback URL.

Открыть документацию
Как проверить подпись webhook от Suawave?

Проверьте заголовок x-ca-signature как подпись RSA-SHA256 PKCS#1 v1.5 в base64 с помощью публичного ключа Suawave из GET /pubkey/. Для GET callback подписывается полный исходный URL запроса, для POST callback подписывается тело запроса без изменений. Проверяйте подпись до разбора полей или доверия к ним, кешируйте ключ и при неудаче один раз обновите его перед отклонением запроса.

Открыть документацию
Как подтвердить получение webhook и повторяет ли Suawave доставку?

Для подтверждения callback Suawave верните HTTP 200 с *ok* в течение 30 секунд; обычное ok также принимается без учёта регистра. Всего предусмотрено попыток: 8. После первой отправки используются задержки 30 с, 2 мин, 10 мин, 30 мин, 2 ч, 6 ч, 24 ч с добавлением случайного отклонения до 10%. Повторные попытки сохраняют тот же uuid, поэтому храните его, чтобы не выполнять работу повторно.

Открыть документацию
Как проверить платёж, если webhook не приходит?

Используйте GET /trc20/usdt/logs/ в Suawave с исходным callback URL для сверки допустимых поступлений. Значение pending означает, что перевод не подтверждён, sent означает подтверждённый перевод без подтверждения получения итогового callback, а done означает, что получение callback подтверждено. Пустой журнал не доказывает отсутствие перевода: поступления ниже минимума, неподдерживаемые и поздние переводы могут в нём отсутствовать.

Открыть документацию

Недоплата, переплата и поздние платежи

Что делать, если покупатель платит меньше суммы заказа?

Магазин сам определяет, достаточно ли подтверждённой суммы для оплаты заказа; публичный эндпоинт create в Suawave не принимает сумму счёта. Суммируйте допустимые подтверждённые поступления по value_coin при учёте суммы до комиссий или по value_forwarded_coin при учёте чистой суммы и исключайте дубли по UUID callback. Каждое дополнительное поступление должно соответствовать своему минимуму и облагается комиссией отдельно.

Открыть документацию
Что происходит, если покупатель отправляет слишком много криптовалюты?

Suawave переводит допустимое поступление за вычетом комиссий, включая сумму сверх стоимости заказа. Публичный API не возвращает переплату автоматически; магазин сам сверяет суммы и организует возврат со своего кошелька.

Открыть документацию
Что происходит, если покупатель платит после истечения срока действия адреса?

Поступление Suawave вне допустимого срока заказа удерживается для проверки, не переводится и не создаёт публичных callback или записей в журнале. Допустимость определяется по фактическому времени перевода и сохранённому сроку действия с настроенным льготным периодом, поэтому своевременный перевод может финализироваться позже. Не показывайте адреса с истёкшим сроком и сверяйте поздние платежи вручную; автоматический возврат плательщику не гарантируется.

Открыть документацию

Выплаты и переводы

Как Suawave переводит платежи на мой кошелёк?

Suawave переводит каждое допустимое поступление отдельно на единственный адрес выплат, переданный при create, после удержания комиссий и проверок сети. Callback о подтверждённом платеже содержит txid_out и value_forwarded_coin, чтобы сервер мог определить транзакцию перевода и полученную чистую сумму.

Открыть документацию
Можно ли изменить адрес выплат или разделить платёж между кошельками?

Suawave закрепляет один адрес выплат за каждой парой тикер и callback, и изменить его для существующей пары нельзя. Для другого адреса выплат создайте новый заказ с новым callback URL; публичный API не поддерживает распределение долей и несколько получателей.

Открыть документацию

Безопасность и хранение средств

Хранит ли Suawave криптовалюту перед переводом?

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

Открыть документацию
Почему нужно хранить полный callback URL в секрете?

Полный callback URL в Suawave даёт доступ к журналам заказа через публичный API, поэтому храните его на сервере и добавляйте непредсказуемый nonce. Подпись входящих callback всё равно нужно проверять; после успешной проверки также сопоставляйте событие с сохранённым заказом, ожидаемыми токеном, адресом и суммой.

Открыть документацию

Плагины, SDK и MCP

Можно ли принимать криптоплатежи через WooCommerce, Magento, OpenCart или PrestaShop?

Suawave предлагает интеграции для WooCommerce, Magento 2, OpenCart и PrestaShop. Следуйте руководству для своей платформы, чтобы установить и настроить плагин, показывать адрес оплаты и QR-код и обрабатывать подписанные callback о платежах.

Открыть документацию
Какие SDK доступны для интеграции с Suawave?

У Suawave есть SDK на Go и JavaScript/TypeScript для публичного API. Вы также можете напрямую обращаться к HTTP-эндпоинтам и использовать примеры проверки подписей на Go, JavaScript, PHP или C# в своём обработчике callback.

Открыть документацию
Может ли AI-ассистент работать с Suawave через MCP?

Да. Сервер MCP от Suawave предоставляет инструменты публичного платёжного API, включая создание адресов приёма и проверку журналов платежей. Для публичного платёжного процесса не нужен ключ продавца, и административные операции недоступны; не включайте callback URL и их секретные nonce в общие промпты и публичный вывод.

Открыть документацию

Переход с CryptAPI

Как перенести интеграцию с CryptAPI на Suawave?

Замените базовый адрес API на Suawave, создавайте новые заказы и адреса приёма и проверяйте callback собственным ключом Suawave из /pubkey/. Перед переходом изучите доступные тикеры, сроки действия, повторные попытки callback и неподдерживаемые параметры; не используйте ключ или список разрешённых IP-адресов CryptAPI.

Открыть документацию

Лимиты, срок действия и возвраты

Ограничивает ли Suawave число API-запросов или новых адресов оплаты?

Да. Suawave ограничивает запросы по IP клиента и хосту callback, а также отдельно устанавливает квоты на создание новых пар тикер и callback. При HTTP 429 увеличьте интервал между запросами и учитывайте Retry-After, если он указан; повторное использование существующей пары не расходует квоту новых пар, но учитывается в лимите запросов.

Открыть документацию
Может ли Suawave автоматически вернуть криптоплатёж?

В публичном API Suawave нет эндпоинта возврата плательщику, и переплаты или поздние платежи не возвращаются автоматически. Если допустимый платёж уже переведён, магазин организует возврат со своего кошелька; удержанный поздний перевод требует ручной сверки и не означает автоматического возврата.

Открыть документацию
Продлевает ли повторное создание того же адреса Suawave срок его действия?

Нет. Повторный create для существующей пары тикер и callback возвращает исходные адрес приёма и expires_at без продления заказа. Показывайте полученный срок в UTC при оплате, убирайте адрес после его истечения и используйте новый callback URL для нового заказа.

Открыть документацию