Частые вопросы
Ответы на вопросы о приёме криптоплатежей с 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 для нового заказа.
Открыть документацию