Skip to Content
Начало работыВведение
View as Markdown

Введение

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

Мерчант, интегрирующий 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 — см. Сети и активы), лежащий в основе PaymentIntent переходит в SETTLED, а родительский Order — в PAID.

В TRON, Solana и TON нет депозитного адреса. Кошелёк покупателя платит напрямую на ваш кошелёк Казначейства (TronLink, QR Solana Pay или TON Connect), а InfraIO Pay распознаёт этот платёж. См. Сети и активы.

Платежи поступают прямо на ваши кошельки Казначейства — 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-кошельков из кранов

Мы не храним средства мерчанта. Переводы 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- средства из крана.

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

Есть вопросы или нужна помощь? Напишите на [email protected].

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

  • Не кастодиан. Средства движутся от покупателя на ваш кошелёк Казначейства on-chain напрямую. Мы никогда не храним ваш баланс.
  • Не требует кошелька. Клиенты платят из собственного кошелька (в размещённом checkout есть встроенная опция WalletConnect). InfraIO Wallet — отдельный некастодиальный кошелёк на passkey, и он не обязателен.
  • Не фиатный рамп. Покупатели платят тем крипто-активом, что у них есть; мы не конвертируем.
  • Не gateway для Bitcoin. Стейблкоины в 8 EVM-сетях, а также TRON, Solana и TON (скоро); без Bitcoin и Lightning. См. Сети и активы для актуальной матрицы.

Что дальше

Добро пожаловатьБыстрый старт