<!-- Source: https://docs.infraio.xyz/ru/payment-links/overview -->
<!-- Last updated: 2026-10-04 -->

# Платёжные ссылки — Обзор

**Платёжная ссылка** — это распространяемый URL, который высаживает
покупателя в размещённый checkout, который вы уже настроили. Никакого
SDK, никакой серверной интеграции — выпустите её в панели, поделитесь,
и тот же webhook `payment.settled` сработает, когда средства
подтвердятся on-chain.

Под капотом платёжная ссылка **является** [CheckoutSession](https://docs.infraio.xyz/ru/concepts/sessions) —
«платёжная ссылка» это просто имя со стороны панели для сессии,
которая не была создана через инициированный покупателем поток SDK.
Тот же контракт webhook, тот же on-chain расчёт, те же комиссии.

Типичные применения:

- Выставление счёта разовому клиенту без написания кода
- Страницы продаж, где у вас нет кастомной корзины
- B2B follow-up: вставьте ссылку в email
- Страницы фиксированных чаевых в стиле «Buy me a coffee»

## Создание ссылки

Создавайте платёжные ссылки в панели:

1. Войдите в [панель мерчанта](https://app.infraio.xyz)
2. **Payments → Payment Links → + New link**
3. Выберите один из двух путей:
   - **New order** — введите позиции, валюту, информацию о клиенте и
     опциональные метаданные. Панель создаст Order и платёжную ссылку
     одним вызовом.
   - **Existing order** — выберите заказ в `PENDING`
     (например, покупатель забросил предыдущую ссылку). Переиздаёт
     свежую ссылку, обеспеченную тем же заказом, так что история
     заказа остаётся целой.
   - В **New order** можно переключиться на **Только сумма**, чтобы выставить фиксированную сумму без списка товаров.
4. Save → панель показывает URL
   `https://checkout.infraio.xyz/cst_…` с кнопкой копирования и
   скачиваемым QR-кодом. Test-mode ссылки используют
   `checkout-dev.infraio.xyz`, чтобы окружение было закодировано в
   имени хоста.

> **Note:**
>
> Каждая платёжная ссылка сегодня одноразовая: как только покупатель
> заплатил, сессия в `COMPLETED`. Если сессия истекает до оплаты (TTL
> по умолчанию 30 минут), откройте страницу деталей заказа и нажмите
> **Re-create link**, чтобы выпустить свежую против того же заказа.

## Что видит покупатель

1. Покупатель попадает на `checkout.infraio.xyz/<session_key>` — тот
   же размещённый UI checkout, который вы получили бы от сессии,
   созданной через SDK.
2. Проходит стандартный поток выбор актива → отправка средств →
   ожидание подтверждения, описанный в
   [Checkout — Обзор](https://docs.infraio.xyz/ru/checkout/overview).
3. `payment.settled` срабатывает на вашем webhook с заказом,
   intent'ом, квитанцией, on-chain tx hash и числом подтверждений —
   тот же payload, что и у любого другого рассчитанного платежа. См.
   [Webhooks](https://docs.infraio.xyz/ru/webhooks/overview) для схемы.

## Что даёт вам панель

Уровень платёжных ссылок сегодня поставляется с:

- **Список** — каждая ссылка, которую вы выпустили, с курсорной
  пагинацией, со статусом, суммой, номером родительского заказа,
  клиентом, истечением и однокликовым открытием URL покупателя.
- **Фильтры** — статус (`ACTIVE` / `COMPLETED` / `EXPIRED` /
  `CANCELED`), диапазон дат и полнотекстовый поиск по номеру заказа,
  имени клиента, email или external ref.
- **Экспорт CSV** — один клик, учитывает текущие фильтры.
- **KPI-полоса** — счётчики по статусам для текущего окружения
  (`live` или `test`), совпадающие с тем, что показывает таблица.
- **Страница деталей** — сводка заказа, история сессий (каждая
  попытка для этого заказа), история on-chain со ссылками на block
  explorer и действие **Re-create link** для сессий, истекших до
  оплаты.

## Ограничения сегодня

- **Нет программного API** — ссылки должны создаваться в панели. Вы
  можете создавать эквивалентные одноразовые сессии через
  `POST /b2b/v1/checkout-sessions/quick` (см.
  [Справочник API](https://docs.infraio.xyz/ru/api-reference)), но распространяемые ссылки
  создаются только в панели.
- **Нет per-buyer аутентификации** — любой с URL может заплатить.
  Каждая ссылка одноразовая, что это ограничивает.
- **Брендинг глобальный** — ссылка использует ваш общемерчантский
  логотип, фирменный цвет и border-radius из **Settings → Branding**.
  Переопределение брендинга per-link недоступно.

## См. также

- [Концепции → Сессии](https://docs.infraio.xyz/ru/concepts/sessions) — что происходит на
  уровне сессии и intent'а, пока покупатель платит.
- [Checkout → Обзор](https://docs.infraio.xyz/ru/checkout/overview) — что реально видит
  покупатель.
- [Webhooks → Обзор](https://docs.infraio.xyz/ru/webhooks/overview) — событие
  `payment.settled`, на которое реагирует ваш сервер.