Переход с CryptAPI на Suawave: различия API

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

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

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

В документации CryptAPI описаны разделение выплат, выбор числа подтверждений клиентом, priority и multi_token. [c-options]

Здесь сравниваются CryptAPI на cryptapi.io и Suawave. Сходство названий маршрутов служит отправной точкой: перед изменением рабочей интеграции изучите параметры, форматы ответов и проверку callback.

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

Различия API

Поведение API по документации
Возможности и ограниченияSuawaveCryptAPI
Создание адресаGET /{ticker}/create/ принимает address и callback; неподдерживаемые query-параметры отклоняются.CryptAPI создаёт адреса оплаты через GET /{ticker}/create/ с параметрами address и callback. [c-create]
Идентификация адресаКаноническая пара тикер и callback определяет постоянный адрес; для изменения параметров выплат используйте новый callback.CryptAPI возвращает тот же address_in для того же callback URL и требует новый callback URL для изменения address_out. [c-reuse]
Настройки выплатОдин адрес выплат; нет разделения выплат, выбора числа подтверждений клиентом, выбора приоритета или приёма нескольких токенов.В документации CryptAPI описаны разделение выплат, выбор числа подтверждений клиентом, priority и multi_token. [c-options]
CallbackRSA-SHA256 с x-ca-signature; получите публичный ключ Suawave и сохраняйте исходные подписанные байты.CryptAPI описывает x-ca-signature как подпись RSA-SHA256 в base64 для полного GET URL или исходного тела POST. [c-signature]

CryptAPI требует подтверждённый домен callback для новых адресов оплаты; существующие адреса продолжают работать. [c-domain]

Suawave фиксирует параметры при первом вызове create для каждой пары тикер и callback. Удалите неподдерживаемые параметры, не рассчитывая, что API их проигнорирует. Обнаружение pending использует индексированные данные сети. Проверьте отображение QR-кода для покупателя вместе с серверным запросом, поскольку обработка data URI отличается.

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

Соответствие эндпоинтов

Каждому исходному маршруту соответствует описанный маршрут Suawave либо отметка об отсутствии аналога с ближайшей поддерживаемой альтернативой. Перед переходом изучите примечания.

Исходный маршрут и ограничения перехода на Suawave
CryptAPI: ДокументацияSuawave: МаршрутПроверка перед переходом
CryptAPI создаёт адреса оплаты через GET /{ticker}/create/ с параметрами address и callback. [c-create]GET /{ticker}/create/Проверьте каждый query-параметр; передайте один адрес выплат и URL-кодированный HTTPS callback.
CryptAPI предоставляет GET /{ticker}/logs/ с callback в качестве параметра поиска. [c-logs]GET /{ticker}/logs/Найдите соответствие в Suawave по callback, сохранённому для этого провайдера.
CryptAPI предоставляет GET /info/ для сведений о сервисе. [c-info]Аналога нет. Ближайшая альтернатива: GET /{ticker}/info/В Suawave нет общего эндпоинта info. Выберите поддерживаемый тикер из сгенерированного списка активов и запросите сведения о нём отдельно.
CryptAPI предоставляет GET /{ticker}/info/ для сведений о тикере. [c-ticker-info]GET /{ticker}/info/Прочитайте текущий минимум и используйте десятичные строки для сумм.
CryptAPI предоставляет GET /{ticker}/qrcode/ и описывает qr_code как изображение в base64 без префикса data URI. [c-qr]GET /{ticker}/qrcode/Suawave возвращает qr_code как полный data URI; не добавляйте префикс повторно.
CryptAPI предоставляет GET /{ticker}/estimate/ для оценки комиссии блокчейна без учёта комиссии сервиса. [c-estimate]GET /{ticker}/estimate/Suawave возвращает настроенную консервативную верхнюю оценку в нативной монете; это не удержание из поступления.
CryptAPI предоставляет GET /convert/ с параметрами value, from и to. [c-convert]GET /convert/Проверьте поддерживаемые пары конвертации и округление в Suawave; котировки конвертации не выполняют обмен средств.
CryptAPI предоставляет GET /{ticker}/convert/ с параметрами value и from. [c-ticker-convert]GET /{ticker}/convert/Используйте тикер Suawave и проверяйте возвращённую десятичную строку.
CryptAPI публикует ключ проверки callback по адресу GET /pubkey/. [c-pubkey]GET /pubkey/Замените кешированный ключ ключом Suawave; одинаковый алгоритм не делает ключи взаимозаменяемыми.

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

  1. Составьте список текущих параметров запросов

    Перечислите все параметры create, которые отправляет приложение. Удалите из запросов Suawave синтаксис разделения выплат, confirmations, priority и multi_token; также сверьте каждый необязательный параметр со справочником API Suawave. Проверьте актив в сгенерированном списке тикеров и прочитайте его минимум. Для Suawave не нужны регистрация, аккаунт и API-ключ.

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

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

CryptAPI указывает комиссии сервиса по обороту отдельно от комиссий блокчейна и сети. [c-fees]

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

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

Достаточно ли изменить только хост API?

Отдельно проверьте неподдерживаемые параметры, созданные адреса приёма, обработку data URI QR-кода и ключ проверки. Сохраняйте точные байты callback для проверки подписи и добавьте регрессионные проверки поддерживаемых полей ответа Suawave.

Можно ли перенести существующие адреса приёма вместе с интеграцией?

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

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

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

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

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

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

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

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