
Suawave и CoinPayments: переход платёжного API
Источники проверены
Краткий вывод
| Suawave: Выбирайте, если... | CoinPayments: Выбирайте, если... |
|---|---|
| Вам нужен процесс оплаты по адресу приёма с указанием адреса выплат и callback URL для каждого нового заказа. | Вам нужна описанная в документации модель кошелька с постоянными или временными адресами. CoinPayments описывает кошельки с постоянными или временными адресами в новой платформе. [cp-wallet] |
Прежде чем выбирать альтернативу CoinPayments, определите, какой API использует приложение. Рассматривайте прежний процесс cmd и новый JSON API как разные адаптеры. Целевая интеграция Suawave использует тикер, адрес выплат и callback URL.
Разрабатывайте с SuawaveРазличия API
| Возможности и ограничения | Suawave | CoinPayments |
|---|---|---|
| Запросы прежнего API | Используйте поддерживаемые GET-маршруты напрямую, начиная с /{ticker}/create/. | Прежние запросы CoinPayments используют POST /api.php с операциями cmd в формате form. [cp-legacy] |
| Создание платежа в новом API | GET /{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
Этапы перехода
Определите адаптер и замените платёжную логику
Зафиксируйте провайдера и версию API для каждого незавершённого заказа. Для новых заказов Suawave выберите точный актив и сеть из сгенерированного списка тикеров и проверьте минимум. Свяжите внутренний идентификатор заказа с callback URL, не рассматривая идентификатор счёта провайдера как переносимый.
Создавайте новые заказы с адресом выплат и 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 · Примеры проверки подписей
Комиссии и минимумы
CoinPayments указывает режимы обработки To Balance, ASAP и Nightly, причём для ASAP и Nightly отдельно приведены сетевые комиссии. [cp-fees]
Изучите приведённые ниже тарифы провайдера и нашу документацию по комиссиям для выбранного актива и ожидаемой суммы поступления. Комиссии и минимумы
Вопросы и ответы
Какая версия CoinPayments рассматривается в сравнении?
В таблице отдельно обозначены прежний формат запросов и новый платёжный процесс. Перед планированием изменений сопоставьте строку с адаптером, который действительно используете; целевой процесс Suawave одинаков в обоих случаях.
Копируется ли история кошелька при смене провайдера?
Это руководство описывает новые адреса приёма Suawave и обработку заказов. Сверяйте прошлые платежи с исходным провайдером; сохраняйте его идентификаторы и исторические записи вместе с этими заказами.
Когда магазин должен отмечать заказ оплаченным?
После проверки подписи Suawave и совпадения заказа, nonce, актива, адреса и суммы обработайте confirmed callback, где pending равен 0. Сохраните uuid до выполнения заказа, чтобы повторные попытки не повторяли работу.
Как сравнить полную стоимость?
Изучите тарифы провайдера по ссылке и раздел Suawave о комиссиях и минимумах для конкретного актива и ожидаемой суммы поступления. Учитывайте комиссию сервиса, сетевую комиссию и минимумы, а не только заявленную процентную ставку.
Источники и методика
Это сравнение документации, опубликованное Suawave. Рекомендации по выбору основаны на описанных возможностях; сравнение не измеряет производительность платежей. Каждая сноска ведёт на публичную документацию или страницу тарифов самого провайдера и содержит дату проверки.
- [cp-wallet] CoinPayments: Переход с прежнего API. Источники проверены .
- [cp-legacy] CoinPayments: Переход с прежнего API. Источники проверены .
- [cp-create] CoinPayments: Переход с прежнего API. Источники проверены .
- [cp-auth] CoinPayments: Аутентификация. Источники проверены .
- [cp-currency] CoinPayments: Переход с прежнего API. Источники проверены .
- [cp-fees] CoinPayments: Комиссии за обработку платежей. Источники проверены .
Сети и комиссии для платежей USDT · Плагины для магазинов и инструменты разработчика · Руководства по интеграции платежей