
Переход с CryptAPI на Suawave: различия API
Источники проверены
Краткий вывод
| Suawave: Выбирайте, если... | CryptAPI: Выбирайте, если... |
|---|---|
| Вам нужен один адрес выплат на заказ, и вы можете реализовать обработку платежей для поддерживаемых тикеров Suawave. | Вам нужны документированные возможности разделения выплат или выбора числа подтверждений клиентом. В документации CryptAPI описаны разделение выплат, выбор числа подтверждений клиентом, priority и multi_token. [c-options] |
Здесь сравниваются CryptAPI на cryptapi.io и Suawave. Сходство названий маршрутов служит отправной точкой: перед изменением рабочей интеграции изучите параметры, форматы ответов и проверку callback.
Разрабатывайте с SuawaveРазличия API
| Возможности и ограничения | Suawave | CryptAPI |
|---|---|---|
| Создание адреса | 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] |
| Callback | RSA-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 либо отметка об отсутствии аналога с ближайшей поддерживаемой альтернативой. Перед переходом изучите примечания.
| 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; одинаковый алгоритм не делает ключи взаимозаменяемыми. |
Этапы перехода
Составьте список текущих параметров запросов
Перечислите все параметры create, которые отправляет приложение. Удалите из запросов Suawave синтаксис разделения выплат, confirmations, priority и multi_token; также сверьте каждый необязательный параметр со справочником API Suawave. Проверьте актив в сгенерированном списке тикеров и прочитайте его минимум. Для Suawave не нужны регистрация, аккаунт и API-ключ.
Создавайте новые заказы с адресом выплат и 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 · Примеры проверки подписей
Комиссии и минимумы
CryptAPI указывает комиссии сервиса по обороту отдельно от комиссий блокчейна и сети. [c-fees]
Изучите приведённые ниже тарифы провайдера и нашу документацию по комиссиям для выбранного актива и ожидаемой суммы поступления. Комиссии и минимумы
Вопросы и ответы
Достаточно ли изменить только хост API?
Отдельно проверьте неподдерживаемые параметры, созданные адреса приёма, обработку data URI QR-кода и ключ проверки. Сохраняйте точные байты callback для проверки подписи и добавьте регрессионные проверки поддерживаемых полей ответа Suawave.
Можно ли перенести существующие адреса приёма вместе с интеграцией?
Создавайте через Suawave новый адрес приёма для каждой новой пары тикер и callback. Сохраните действующие реквизиты оплаты и незавершённые заказы у исходного провайдера до окончания сверки.
Когда магазин должен отмечать заказ оплаченным?
После проверки подписи Suawave и совпадения заказа, nonce, актива, адреса и суммы обработайте confirmed callback, где pending равен 0. Сохраните uuid до выполнения заказа, чтобы повторные попытки не повторяли работу.
Как сравнить полную стоимость?
Изучите тарифы провайдера по ссылке и раздел Suawave о комиссиях и минимумах для конкретного актива и ожидаемой суммы поступления. Учитывайте комиссию сервиса, сетевую комиссию и минимумы, а не только заявленную процентную ставку.
Источники и методика
Это сравнение документации, опубликованное Suawave. Рекомендации по выбору основаны на описанных возможностях; сравнение не измеряет производительность платежей. Каждая сноска ведёт на публичную документацию или страницу тарифов самого провайдера и содержит дату проверки.
- [c-options] CryptAPI: Создание нового адреса оплаты. Источники проверены .
- [c-create] CryptAPI: Создание нового адреса оплаты. Источники проверены .
- [c-reuse] CryptAPI: Создание нового адреса оплаты. Источники проверены .
- [c-signature] CryptAPI: Проверка подписей webhook. Источники проверены .
- [c-logs] CryptAPI: Проверка журналов адреса оплаты. Источники проверены .
- [c-info] CryptAPI: Сведения о сервисе CryptAPI. Источники проверены .
- [c-ticker-info] CryptAPI: Получение сведений о тикере. Источники проверены .
- [c-qr] CryptAPI: Генератор QR-кодов для оплаты. Источники проверены .
- [c-estimate] CryptAPI: Оценка комиссий блокчейна. Источники проверены .
- [c-convert] CryptAPI: Конвертация цены. Источники проверены .
- [c-ticker-convert] CryptAPI: Конвертация цен по тикеру. Источники проверены .
- [c-pubkey] CryptAPI: Проверка подписей webhook. Источники проверены .
- [c-domain] CryptAPI: Создание нового адреса оплаты. Источники проверены .
- [c-fees] CryptAPI: Комиссии. Источники проверены .
Сети и комиссии для платежей USDT · Плагины для магазинов и инструменты разработчика · Руководства по интеграции платежей