<!-- Source: https://docs.infraio.xyz/ru/get-started/introduction -->
<!-- Last updated: 2026-10-04 -->

# Введение

## Форма платежа

Мерчант, интегрирующий InfraIO Pay, имеет дело с четырьмя движущимися
частями:

### Сессия checkout

Вы создаёте сессию на сервере с позициями и суммами. Ответ несёт
`session_key` (`cst_…`) и `checkout_url`. Сессии ограничены по времени (по умолчанию
30 минут) и одноразовые.

### Размещённая страница checkout

Вы загружаете наш браузерный SDK и открываете сессию — popup, redirect
или встроенный iframe. Покупатель выбирает сеть × актив (USDT на
Polygon, ETH на Base, …), видит сгенерированный отдельный депозитный адрес для заказа (CREATE2) + QR
и отправляет средства из своего кошелька.

### Подтверждение платежа

InfraIO Pay наблюдает за соответствующей сетью на предмет входящих
переводов, совпадающих с депозитным адресом сессии. После того как
число подтверждений достигает настроенного (например, 12 на Ethereum
mainnet, 5 на Polygon — см. [Сети и активы](https://docs.infraio.xyz/ru/concepts/chains)),
лежащий в основе PaymentIntent переходит в `SETTLED`, а родительский
Order — в `PAID`.

В TRON, Solana и TON нет депозитного адреса. Кошелёк покупателя платит напрямую на ваш кошелёк Казначейства (TronLink, QR Solana Pay или TON Connect), а InfraIO Pay распознаёт этот платёж. См. [Сети и активы](https://docs.infraio.xyz/ru/concepts/chains).

> Платежи поступают прямо на ваши кошельки Казначейства — InfraIO Pay никогда не хранит ваши средства.

### Webhook

Мы делаем POST подписанного события `payment.settled` на ваш
зарегистрированный webhook URL. Ваш сервер проверяет подпись, находит
заказ и обрабатывает его.

## Модель данных на одной диаграмме

```
CheckoutSession  ←  1:1  →  Order  ←  1:N  →  PaymentIntent
   (ограничена по времени)   (постоянный)      (один на попытку оплаты)
```

Вы думаете в терминах **Order** для обработки заказа, создаёте
**Session**, чтобы принять оплату, а система управляет **PaymentIntent**
за кулисами для повторов и выбора сети.

## С чем справляемся мы vs с чем справляетесь вы

| InfraIO Pay справляется | Вы справляетесь |
| --- | --- |
| Размещённый UI checkout (депозитный адрес, QR, селектор актива) | Каталог + создание Order в вашей БД |
| Мониторинг сети + логика подтверждений на 8 EVM-сетях, а также TRON, Solana и TON (скоро) | Приёмник webhook + проверка подписи |
| Мультиактивный checkout стейблкоинов (USDT, USDC на каждой сети) | Маппинг нашего `order_id` ↔ вашего ID заказа через `external_ref` |
| Учёт возвратов (state-машина, панель, API) | Подписание + трансляция on-chain tx возврата |
| Test-mode ключи + изолированные test-webhooks | Пополнение testnet-кошельков из кранов |

> **Note:**
>
> Мы не храним средства мерчанта. Переводы buyer-to-merchant
> происходят **напрямую** on-chain; мы — слой индексации и
> reconciliation, который сообщает вам, когда перевод прошёл.

## Test-mode vs live-mode

Каждый аккаунт начинается в **test-mode**. Test-ключи имеют префиксы
`pk_test_` / `sk_test_`. Live-ключи (`pk_live_` / `sk_live_`)
доступны после того, как вы завершите верификацию аккаунта и добавите
кошелёк Казначейства для каждой сети, на которой хотите принимать (вы
подписываете сообщение, доказывающее, что вы контролируете его).

Один и тот же базовый URL обслуживает оба — окружение определяется
префиксом ключа, а не URL. Test-mode работает против **реальных
testnet'ов** (Sepolia, Base Sepolia, BSC Testnet и т. д.) — мок-сети
нет. Чтобы запустить тестовый платёж, вам нужны реальные testnet-
средства из крана.

## Контакты / поддержка

Есть вопросы или нужна помощь? Напишите на [contact@lartech.xyz](mailto:contact@lartech.xyz).

## Чем InfraIO Pay не является

- **Не кастодиан.** Средства движутся от покупателя на ваш кошелёк
  Казначейства on-chain напрямую. Мы никогда не храним ваш баланс.
- **Не требует кошелька.** Клиенты платят из собственного кошелька (в
  размещённом checkout есть встроенная опция WalletConnect).
  [InfraIO Wallet](https://docs.infraio.xyz/ru/wallet/overview) — отдельный некастодиальный
  кошелёк на passkey, и он не обязателен.
- **Не фиатный рамп.** Покупатели платят тем крипто-активом, что у
  них есть; мы не конвертируем.
- **Не gateway для Bitcoin.** Стейблкоины в 8 EVM-сетях, а также TRON, Solana и TON (скоро); без Bitcoin и Lightning. См. [Сети и активы](https://docs.infraio.xyz/ru/concepts/chains) для актуальной матрицы.

## Что дальше

- [Быстрый старт](https://docs.infraio.xyz/ru/get-started/quickstart) — скопируйте и вставьте
  вашу первую интеграцию за ~10 минут.
- [Концепции → Сессии](https://docs.infraio.xyz/ru/concepts/sessions) — модель данных в
  деталях.
- [SDK → JavaScript](https://docs.infraio.xyz/ru/sdks/javascript) — единственный опубликованный
  SDK на сегодня.
- [Цены и комиссии](https://docs.infraio.xyz/ru/concepts/pricing) — уровни по объёму и скидки.
- [Приложение для мерчантов](https://docs.infraio.xyz/ru/get-started/merchant-app) — управляйте бизнесом с телефона.