Терминалы и маршрутизация

A терминал - это настроенное соединение между вашей платформой и провайдером платежей. Каждый терминал имеет ровно одного провайдера, одну или несколько поддерживаемых валют и набор учетных данных. Умная маршрутизация автоматически выбирает лучший терминал для каждой транзакции.

---

Типы терминалов

Тип	Описание
payment	Принимает входящие платежи (pay-in)
payout	Отправка исходящих платежей (pay-out)
merchant	Уведомление — используется только для доставки веб-хуков, а не для реальных платежей

---

Создание терминала

С помощью Admin Console

1. Консоль администратора → Терминалы → Новый терминал
2. Выберите поставщика из каталога
3. Введите учетные данные поставщика (provider_params)
4. Тип набора, валюты и географический охват
5. активировать

Via Admin API

curl -X POST https://4pay.online/api/v1/terminal \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ADMIN_TOKEN" \
  -d '{
    "name": "Stripe EUR Payments",
    "partner_id": 42,
    "provider": "stripe",
    "type": "payment",
    "is_active": true,
    "env": "prod",
    "provider_params": {
      "api_key": "sk_live_...",
      "webhook_secret": "whsec_..."
    },
    "merchant_adapter": "merchant_default",
    "notify_url": "https://partner.example.com/webhooks"
  }'

---

Удостоверения провайдера (provider_params)

Каждому провайдеру нужны разные учетные данные. Каталог поставщиков требуемый provider_params на одного провайдера.

Общая схема:

поставщик	Необходимые парамы
полосатый	api_key, webhook_secret
Адьен	api_key, merchant_account, client_key
Checkout.com	secret_key, public_key
PayPal	client_id, client_secret

Ссылка на полный параметр: Каталог поставщиков

---

Уведомления о товаре (merchant_params)

Настройте, как платформа уведомляет вас и партнера о событиях транзакции:

{
  "merchant_params": {
    "tg_ids_to_notify": ["123456789", "987654321"]
  }
}

парам	Описание
tg_ids_to_notify	Идентификаторы пользователей Telegram для получения уведомлений о транзакциях

---

Умная маршрутизация

Интеллектуальная маршрутизация автоматически выбирает лучший терминал для каждой транзакции на основе правил, которые вы определяете.

Как работает маршрутизация

1. Транзакция приходит с currency, amount, typeи необязательно country
2. Маршрутизатор оценивает все активные терминалы для партнера
3. Терминалы оцениваются по вашим правилам маршрутизации
4. Транзакция отправляется в терминал с самым высоким рейтингом
5. Если терминал выходит из строя, пробуется следующий терминал в цепи отказоустойчивости.

Факторы маршрутизации

Фактор	Описание
Валютный матч	Терминал должен поддерживать валюту транзакции.
Тип сделки	Тип терминала должен совпадатьpayment / payout)
Географический охват	Терминал может быть ограничен определенными странами или регионами.
Приоритет	Явный номер приоритета — нижний = высший приоритет
Доступность	Рассматриваются только активные, недеградированные терминалы.

Настройка правил маршрутизации

In Admin Console → Маршрутизация → Правила:

Rule: EUR payments in Europe
  currency = EUR
  region = Europe
  type = payment
  terminal_priority = [stripe_eur, adyen_eur, checkout_eur]

---

неудача

Если терминал выходит из строя (ошибка провайдера, тайм-аут или сетевая проблема), платформа автоматически перезагружается на следующем терминале в цепочке отказоустойчивости.

Настройка отказоустойчивых цепей в Консоль администратора → Терминалы → Провал:

Primary: stripe_eur
Failover 1: adyen_eur
Failover 2: checkout_eur

---

Многовалютный и FX

Для операций в валюте, изначально не поддерживаемой терминалом, автоматический FX Конверсия может быть включена:

• Транзакция приходит в USD
• Терминалы поддерживают EUR
• FX преобразователи USD → EUR по рыночному курсу + сконфигурированный спред
• Транзакция обрабатывается в EUR
• Поселение находится в EUR с помощью FX Зарегистрированная сумма

конфигурировать FX спреды в Консоль администратора FX → Тарифы.

---

Отключение терминала

Чтобы временно отключить терминал (например, обслуживание провайдера):

1. Консоль администратора → Терминалы [Терминал] Деактивировать
2. Маршрутизатор автоматически пропустит этот терминал
3. Неудачные терминалы будут обрабатывать трафик

Никаких данных не потеряно. Реактивируйтесь в любое время.