
Suawave и NOWPayments: переход платёжного API
Источники проверены
Краткий вывод
| Suawave: Выбирайте, если... | NOWPayments: Выбирайте, если... |
|---|---|
| Вы хотите показывать адрес приёма на своей странице оплаты и переводить каждое допустимое поступление на один адрес выплат. | Вам нужна ссылка на счёт для покупателя, которую формирует провайдер. POST /v1/invoice в NOWPayments возвращает invoice_url для покупателя. [n-invoice] |
При выборе альтернативы NOWPayments сравните, что нужно вашей странице оплаты: адрес приёма, который показываете вы, или ссылка на размещённый у провайдера счёт. Suawave предоставляет адрес и подписанные callback; заказом и страницей оплаты управляет ваше приложение.
Разрабатывайте с SuawaveРазличия API
| Возможности и ограничения | Suawave | NOWPayments |
|---|---|---|
| Создание адреса | GET /{ticker}/create/ с address и callback; аутентификация не требуется. | NOWPayments создаёт прямые платежи через POST /v1/payment с JSON и заголовком x-api-key. [n-create] |
| Идентификатор заказа | Добавьте идентификатор заказа и nonce в callback и сохраните полученный address_in. | При создании платежа NOWPayments принимает price_amount, price_currency, pay_currency, ipn_callback_url и order_id. [n-fields] |
| Ответ create | Сохраните address_in вместе с тикером, адресом выплат, callback и провайдером. | NOWPayments возвращает payment_id и pay_address при создании прямого платежа. [n-result] |
| Страница покупателя | Показывайте полученный адрес, выбранный актив, сеть, сумму и QR-код на своей странице оплаты. | POST /v1/invoice в NOWPayments возвращает invoice_url для покупателя. [n-invoice] |
| Сверка платежей | GET /{ticker}/logs/ использует сохранённый callback URL. | NOWPayments предоставляет GET /v1/payment/{payment_id} для получения статуса платежа. [n-status] |
| Проверка callback | Проверяйте RSA-SHA256 для исходного URL или исходного тела POST с помощью публичного ключа Suawave. | NOWPayments проверяет IPN с помощью x-nowpayments-sig и HMAC-SHA512 для отсортированного JSON с секретом IPN. [n-signature] |
Перестройте платёжный адаптер вокруг пары тикер и callback Suawave. Сумма заказа остаётся в состоянии приложения: create возвращает адрес приёма, а не жизненный цикл счёта. Замените сопоставление статусов с выполнением заказа на проверенные callback по каждому поступлению и учитывайте частичные платежи с помощью точной десятичной арифметики.
Поддерживаемые активы: bep20/usdc (BSC), bep20/usdt (BSC), trc20/usdt (TRON). Актуальные форматы запросов и ответов смотрите в документации. Тикеры и сети · Справочник API
Этапы перехода
Определите процесс оплаты и учёта сумм
Выберите точный актив и сеть, в которой покупатель отправит платёж, из сгенерированного списка тикеров Suawave. Прочитайте минимум. Показывайте собственную страницу оплаты и сохраняйте ожидаемую сумму в заказе. Если нужна валютная котировка, изучите отдельную документацию по конвертации; котировка не обменивает поступившие средства.
Создавайте новые заказы с адресом выплат и callback
Передайте address и URL-кодированный HTTPS callback в GET /{ticker}/create/. Добавьте в callback URL идентификатор заказа и непредсказуемый nonce и сохраните их на сервере. Сохраните полученный address_in вместе с провайдером и тикером. Не используйте адрес приёма другого провайдера.
Замените проверку callback и логику выполнения заказа
Проверяйте x-ca-signature ключом из эндпоинта Suawave GET /pubkey/. Для GET callback сохраняйте полный исходный URL; для POST сохраняйте исходное тело до разбора. Проверяйте заказ, nonce, актив, адрес и сумму, затем исключайте дубли по uuid. Выполняйте заказ только при pending, равном 0, и подтверждайте получение ответом HTTP 200 с *ok*.
Переключите новые заказы и сверьте старые
Сохраните привязку существующих заказов к исходному провайдеру и оставьте его обработчик callback активным. Направляйте в Suawave только новые заказы. До открытия оплаты покупателям проверьте верные и поддельные подписи, повторные доставки, pending после confirmed, частичные платежи и сбои callback. Используйте журналы Suawave как резервный способ опроса.
Используйте эти руководства при замене адаптера: Быстрый старт · Контракт callback · Примеры проверки подписей
Комиссии и минимумы
NOWPayments публикует комиссию сервиса на странице тарифов. [n-fees]
Изучите приведённые ниже тарифы провайдера и нашу документацию по комиссиям для выбранного актива и ожидаемой суммы поступления. Комиссии и минимумы
Вопросы и ответы
Возвращает ли Suawave ссылку на счёт?
Ответ create в Suawave содержит адрес приёма для вашей страницы оплаты. Приложение показывает реквизиты и управляет жизненным циклом заказа. Процесс работы с адресом и QR-кодом описан в руководстве по быстрому старту.
Можно ли перенести существующие адреса приёма вместе с интеграцией?
Создавайте через Suawave новый адрес приёма для каждой новой пары тикер и callback. Сохраните действующие реквизиты оплаты и незавершённые заказы у исходного провайдера до окончания сверки.
Когда магазин должен отмечать заказ оплаченным?
После проверки подписи Suawave и совпадения заказа, nonce, актива, адреса и суммы обработайте confirmed callback, где pending равен 0. Сохраните uuid до выполнения заказа, чтобы повторные попытки не повторяли работу.
Как сравнить полную стоимость?
Изучите тарифы провайдера по ссылке и раздел Suawave о комиссиях и минимумах для конкретного актива и ожидаемой суммы поступления. Учитывайте комиссию сервиса, сетевую комиссию и минимумы, а не только заявленную процентную ставку.
Источники и методика
Это сравнение документации, опубликованное Suawave. Рекомендации по выбору основаны на описанных возможностях; сравнение не измеряет производительность платежей. Каждая сноска ведёт на публичную документацию или страницу тарифов самого провайдера и содержит дату проверки.
- [n-invoice] NOWPayments: Описание API и эндпоинтов. Источники проверены .
- [n-create] NOWPayments: Описание API и эндпоинтов. Источники проверены .
- [n-fields] NOWPayments: Описание API и эндпоинтов. Источники проверены .
- [n-result] NOWPayments: Описание API и эндпоинтов. Источники проверены .
- [n-status] NOWPayments: Описание API и эндпоинтов. Источники проверены .
- [n-signature] NOWPayments: IPN и его настройка. Источники проверены .
- [n-fees] NOWPayments: Тарифы. Источники проверены .
Сети и комиссии для платежей USDT · Плагины для магазинов и инструменты разработчика · Руководства по интеграции платежей