Suawave и NOWPayments: переход платёжного API

Источники проверены

Краткий вывод

Выбирайте по нужному процессу оплаты
Suawave: Выбирайте, если...NOWPayments: Выбирайте, если...
Вы хотите показывать адрес приёма на своей странице оплаты и переводить каждое допустимое поступление на один адрес выплат.Вам нужна ссылка на счёт для покупателя, которую формирует провайдер.

POST /v1/invoice в NOWPayments возвращает invoice_url для покупателя. [n-invoice]

При выборе альтернативы NOWPayments сравните, что нужно вашей странице оплаты: адрес приёма, который показываете вы, или ссылка на размещённый у провайдера счёт. Suawave предоставляет адрес и подписанные callback; заказом и страницей оплаты управляет ваше приложение.

Разрабатывайте с Suawave

Различия API

Поведение API по документации
Возможности и ограниченияSuawaveNOWPayments
Создание адреса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

Этапы перехода

  1. Определите процесс оплаты и учёта сумм

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

  2. Создавайте новые заказы с адресом выплат и callback

    Передайте address и URL-кодированный HTTPS callback в GET /{ticker}/create/. Добавьте в callback URL идентификатор заказа и непредсказуемый nonce и сохраните их на сервере. Сохраните полученный address_in вместе с провайдером и тикером. Не используйте адрес приёма другого провайдера.

  3. Замените проверку callback и логику выполнения заказа

    Проверяйте x-ca-signature ключом из эндпоинта Suawave GET /pubkey/. Для GET callback сохраняйте полный исходный URL; для POST сохраняйте исходное тело до разбора. Проверяйте заказ, nonce, актив, адрес и сумму, затем исключайте дубли по uuid. Выполняйте заказ только при pending, равном 0, и подтверждайте получение ответом HTTP 200 с *ok*.

  4. Переключите новые заказы и сверьте старые

    Сохраните привязку существующих заказов к исходному провайдеру и оставьте его обработчик 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. Рекомендации по выбору основаны на описанных возможностях; сравнение не измеряет производительность платежей. Каждая сноска ведёт на публичную документацию или страницу тарифов самого провайдера и содержит дату проверки.

Сети и комиссии для платежей USDT · Плагины для магазинов и инструменты разработчика · Руководства по интеграции платежей