Suawave и Plisio: API счетов и адресов приёма

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

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

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

Plisio описывает txn_id и invoice_url в ответе на создание счёта. [p-invoice]

При выборе альтернативы Plisio начните с данных, которые использует ваша страница оплаты. Suawave возвращает адрес приёма и предоставляет эндпоинт QR-кода. Храните сумму заказа, его идентификатор и состояние выполнения в своём приложении.

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

Различия API

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

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

  1. Замените логику счёта и страницу оплаты

    Выберите поддерживаемый актив и сеть Suawave из сгенерированного списка тикеров и прочитайте минимум. Сохраните ожидаемую сумму в своём заказе. Показывайте полученный адрес и QR-код, не ожидая от Suawave ссылки на размещённый счёт. Создайте отдельный обработчик callback 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 · Примеры проверки подписей

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

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

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