
Suawave и Plisio: API счетов и адресов приёма
Источники проверены
Краткий вывод
| Suawave: Выбирайте, если... | Plisio: Выбирайте, если... |
|---|---|
| Вы хотите показывать адрес приёма на своей странице оплаты и отслеживать заказы по callback URL. | Вам нужна ссылка на счёт, которую возвращает провайдер. Plisio описывает txn_id и invoice_url в ответе на создание счёта. [p-invoice] |
При выборе альтернативы Plisio начните с данных, которые использует ваша страница оплаты. Suawave возвращает адрес приёма и предоставляет эндпоинт QR-кода. Храните сумму заказа, его идентификатор и состояние выполнения в своём приложении.
Разрабатывайте с SuawaveРазличия API
| Возможности и ограничения | Suawave | Plisio |
|---|---|---|
| Запросы | Публичные GET-эндпоинты не требуют аутентификации и возвращают JSON. | Plisio описывает GET-запросы с api_key в query-параметрах и JSON-ответы по пути /api/v1. [p-auth] |
| Создание адреса | GET /{ticker}/create/ принимает address и callback. | Plisio описывает GET /api/v1/invoices/new с order_name, order_number и api_key. [p-create] |
| Идентификация по ответу | Сохраните address_in вместе с тикером, callback и внутренним идентификатором заказа. | Plisio описывает txn_id и invoice_url в ответе на создание счёта. [p-invoice] |
| Уведомления | По умолчанию callback отправляются методом GET; post=1 выбирает form POST, а json=1 выбирает JSON POST. | Plisio отправляет обновления счетов методом POST и позволяет callback_url переопределять настроенный Status URL. [p-callback] |
В Suawave callback URL служит частью идентификатора постоянного соответствия, а не только адресом уведомлений. Добавьте в него идентификатор заказа и nonce и сохраните точный URL. Первый вызов create фиксирует параметры для пары тикер и callback. Для нового заказа нужен новый callback URL.
Поддерживаемые активы: bep20/usdc (BSC), bep20/usdt (BSC), trc20/usdt (TRON). Актуальные форматы запросов и ответов смотрите в документации. Тикеры и сети · Справочник API
Этапы перехода
Замените логику счёта и страницу оплаты
Выберите поддерживаемый актив и сеть Suawave из сгенерированного списка тикеров и прочитайте минимум. Сохраните ожидаемую сумму в своём заказе. Показывайте полученный адрес и QR-код, не ожидая от Suawave ссылки на размещённый счёт. Создайте отдельный обработчик callback 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 · Примеры проверки подписей
Комиссии и минимумы
Plisio указывает Gateway API и White Label как отдельные тарифные варианты. [p-fees]
Изучите приведённые ниже тарифы провайдера и нашу документацию по комиссиям для выбранного актива и ожидаемой суммы поступления. Комиссии и минимумы
Вопросы и ответы
Можно ли сохранить свой номер заказа?
Да. Храните его в приложении и включайте в URL-кодированный callback вместе с непредсказуемым nonce. Suawave возвращает ваши query-параметры в callback; сверяйте их с сохранённым заказом.
Обязательно ли использовать GET для callback Suawave?
Нет. При создании соответствия задайте post=1 для form POST или json=1 для JSON POST. Если указаны оба параметра, JSON имеет приоритет. Сохраняйте исходное тело POST для проверки подписи.
Можно ли перенести существующие адреса приёма вместе с интеграцией?
Создавайте через Suawave новый адрес приёма для каждой новой пары тикер и callback. Сохраните действующие реквизиты оплаты и незавершённые заказы у исходного провайдера до окончания сверки.
Как сравнить полную стоимость?
Изучите тарифы провайдера по ссылке и раздел Suawave о комиссиях и минимумах для конкретного актива и ожидаемой суммы поступления. Учитывайте комиссию сервиса, сетевую комиссию и минимумы, а не только заявленную процентную ставку.
Источники и методика
Это сравнение документации, опубликованное Suawave. Рекомендации по выбору основаны на описанных возможностях; сравнение не измеряет производительность платежей. Каждая сноска ведёт на публичную документацию или страницу тарифов самого провайдера и содержит дату проверки.
- [p-invoice] Plisio: Создание счёта. Источники проверены .
- [p-auth] Plisio: Введение. Источники проверены .
- [p-create] Plisio: Создание счёта. Источники проверены .
- [p-callback] Plisio: Обновления счетов и входящие платежи. Источники проверены .
- [p-fees] Plisio: Тарифы. Источники проверены .
Сети и комиссии для платежей USDT · Плагины для магазинов и инструменты разработчика · Руководства по интеграции платежей