Крипто-процессинг и эквайринг для бизнеса

Оплата, эндпоинт за эндпоинтом

1. Предлагайте то, чем реально можно заплатить сейчас

   GET /v1/assets возвращает активы и сети, за которыми стоит провайдер. Кэшируйте на несколько минут и рисуйте из этого список «чем платить»: актив, который никто не обслуживает, не должен доходить до клиента.

2. Считайте корзину в активе зачисления

   Корзина — 149.00 USDT, клиент хочет заплатить в ETH. Котируйте с amount_to=149, и предложение ответит точной суммой FromAmount. rate_type=fixed удержит это число на время оплаты.

3. Создавайте ордер на ваш расчётный кошелёк

   to_address — адрес вашего казначейства, он не меняется от клиента к клиенту. client_order_id — номер заказа в магазине, именно его потом читает сверка. Передавайте Idempotency-Key: повторно отправленный чекаут не должен превращаться в два ордера.

4. Рисуйте экран оплаты

   DepositAddress, AmountFrom, сеть, QR-код и таймер. Больше ничего не нужно и ничего лишнего показывать не стоит: неверная сеть — самая частая причина пропавшего крипто-платежа.

5. Выдавайте товар по финальному статусу

   Опрашивайте GET /v1/partner/orders/{id} раз в 5–10 секунд. В DONE лежат зачисленная сумма AmountToReceived и хеш выплаты TxID — это и есть подтверждение оплаты.

Стриминг цены в чекаут

Чекаут, который ждёт самый медленный обменник, выглядит сломанным. Стримьте: предложения приходят по мере ответа провайдеров, первое обычно за 400 мс.

// Ваш бэкенд. Ключ не попадает в браузер — проксируйте поток клиенту.
const url = new URL("https://api.swapzilla.io/v1/partner/quotes-sse");
url.search = new URLSearchParams({
  from_asset: "ETH", from_network: "ERC20",
  to_asset: "USDT", to_network: "TRC20",
  amount_to: "149", rate_type: "fixed", timeout_ms: "5000",
});

const res = await fetch(url, {
  headers: { "X-API-Key": process.env.SWAPZILLA_KEY, Accept: "text/event-stream" },
});
// события: offer · provider_error · ping · done
// в `done` приходит { deviations: { "<offer_id>": 0.16 } } — итоговый рейтинг.

Дальше ордер, со всем, что понадобится сверке:

curl -s -X POST "https://api.swapzilla.io/v1/partner/orders" \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 6f1c0b52-6f2a-4d43-9f4a-1a0d64c1f3a2" \
  -d '{
    "offer_id": "0b0c8f0e-2c1a-4f3f-8f57-2a1d1c4e77aa",
    "to_address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
    "refund_address": "0x750c44dB01899176f2e64bD25A2fabAC1140d8e9",
    "client_order_id": "SHOP-88214",
    "expected_to_amount": 149
  }'

Сверка и поддержка

Чего API не делает

Кому подходит такой чекаут

• Магазинам и SaaS, которым нужен остаток в стейблкоине, а не портфель: клиенты платят пятьюдесятью активами, вы получаете один.
• Цифровым товарам и пополнениям, где неотзывный платёж убирает резерв под фрод целиком.
• Маркетплейсам, зачисляющим на кошелёк каждого продавца: платформа маршрутизирует платёж, ни разу его не удерживая.
• Сервисам, которым платят из сетей, поддерживать которые они не собирались: конвертацию делает сеть провайдеров, а не ваше казначейство.

Вопросы