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

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

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

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

CoinPayments описывает кошельки с постоянными или временными адресами в новой платформе. [cp-wallet]

Прежде чем выбирать альтернативу CoinPayments, определите, какой API использует приложение. Рассматривайте прежний процесс cmd и новый JSON API как разные адаптеры. Целевая интеграция Suawave использует тикер, адрес выплат и callback URL.

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

Различия API

Поведение API по документации
Возможности и ограниченияSuawaveCoinPayments
Запросы прежнего APIИспользуйте поддерживаемые GET-маршруты напрямую, начиная с /{ticker}/create/.Прежние запросы CoinPayments используют POST /api.php с операциями cmd в формате form. [cp-legacy]
Создание платежа в новом APIGET /{ticker}/create/ возвращает address_in для страницы оплаты.CoinPayments описывает POST Invoice с JSON для нового процесса создания платежей. [cp-create]
Подпись запросовПубличным GET-эндпоинтам Suawave не нужна аутентификация; проверка callback выполняется отдельно.CoinPayments аутентифицирует защищённые запросы с помощью X-CoinPayments-Client, X-CoinPayments-Timestamp и X-CoinPayments-Signature, используя HMAC-SHA256. [cp-auth]
Идентификатор валютыВыберите тикер из сгенерированного списка активов Suawave и сохраните указанную в нём сеть.Новая платформа CoinPayments использует ID валют вместо символов. [cp-currency]
Модель адресовСоздайте постоянное соответствие тикера и callback, которое переводит допустимые поступления на один адрес выплат.CoinPayments описывает кошельки с постоянными или временными адресами в новой платформе. [cp-wallet]

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

Поддерживаемые активы: bep20/usdc (BSC), bep20/usdt (BSC), trc20/usdt (TRON). Актуальные форматы запросов и ответов смотрите в документации. Тикеры и сети · Справочник API

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

  1. Определите адаптер и замените платёжную логику

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

  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 · Примеры проверки подписей

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

CoinPayments указывает режимы обработки To Balance, ASAP и Nightly, причём для ASAP и Nightly отдельно приведены сетевые комиссии. [cp-fees]

Изучите приведённые ниже тарифы провайдера и нашу документацию по комиссиям для выбранного актива и ожидаемой суммы поступления. Комиссии и минимумы

Вопросы и ответы

Какая версия CoinPayments рассматривается в сравнении?

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

Копируется ли история кошелька при смене провайдера?

Это руководство описывает новые адреса приёма Suawave и обработку заказов. Сверяйте прошлые платежи с исходным провайдером; сохраняйте его идентификаторы и исторические записи вместе с этими заказами.

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

После проверки подписи Suawave и совпадения заказа, nonce, актива, адреса и суммы обработайте confirmed callback, где pending равен 0. Сохраните uuid до выполнения заказа, чтобы повторные попытки не повторяли работу.

Как сравнить полную стоимость?

Изучите тарифы провайдера по ссылке и раздел Suawave о комиссиях и минимумах для конкретного актива и ожидаемой суммы поступления. Учитывайте комиссию сервиса, сетевую комиссию и минимумы, а не только заявленную процентную ставку.

Источники и методика

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

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