Провайдеры платежей и касс в IZI

Провайдеры платежей и касс в IZI

Провайдеры в IZI — это интеграции с платёжными системами и фискальными кассами, которые работают на уровне всей организации. Настроите один раз — и все клубы сети смогут использовать одни и те же подключения. Раздел находится в меню Организация → Управление → Провайдеры и делится на два типа: платёжные провайдеры (приём денег от клиентов) и кассовые провайдеры (формирование фискальных чеков). Оба типа отображаются в единой таблице со столбцами «Название», «Тип», «Использование», «Статус» и «Обновлено». Провайдер может иметь статус «Активен» (учётные данные введены и проверены) или «Не настроен» (создан, но ключи ещё не заполнены или невалидны).

Чтобы добавить провайдера, нажмите кнопку в правом верхнем углу страницы, выберите тип интеграции и следуйте настройкам выбранного провайдера. Платёжный и кассовый провайдеры — независимые сущности: платёжный принимает деньги через эквайринг (узнать о платежах клиентов), кассовый отвечает за фискальные чеки согласно местному законодательству (подробнее — в разделе о налоговом учёте в ОАЭ и кассах в России). После создания провайдер на уровне организации привязывается к кассам конкретных клубов уже в их настройках.

---

Платёжные провайдеры

Платёжный провайдер — это эквайрер: сервис, через который клиент оплачивает картой, через Apple Pay или СБП. IZI поддерживает четыре провайдера, каждый со своими методами оплаты.

Поддерживаемые провайдеры и методы оплаты

Провайдер	Карта	Apple Pay	СБП	Регион применения
CloudPayments	Да	Нет	Да	Россия
Stripe	Да	Да	Нет	Международный
HyperPay	Да	Да (+ Mada)	Нет	Ближний Восток (ОАЭ, Саудовская Аравия)
MethodPay (Paygine)	Да	Нет	Нет	Россия

Как создать платёжного провайдера

1. Перейдите в Организация → Провайдеры, нажмите «Добавить».
2. В открывшемся окне выберите «Тип интеграции» → «Платёжный провайдер».
3. Присвойте интеграции Название (например, «Stripe основной» или «CloudPayments RU»).
4. В поле «Провайдер» выберите нужный сервис из списка.
5. Заполните учётные данные провайдера (см. ниже).
6. Нажмите «Сохранить». Система сгенерирует Webhook URL — скопируйте его и добавьте в личный кабинет выбранного провайдера.

Настройки CloudPayments

В форме появится блок «Настройки CloudPayments»:

• Public ID — публичный идентификатор магазина из личного кабинета CloudPayments.
• API Secret — секретный ключ для подписи запросов.

После сохранения скопируйте Webhook URL и укажите его в настройках уведомлений в личном кабинете CloudPayments.

Настройки Stripe

В форме появится блок «Настройки Stripe»:

• Publishable Key — публичный ключ (pk_live_...).
• Secret Key — секретный ключ (sk_live_...).
• Webhook Secret — секрет для проверки подписи вебхуков. Должен начинаться с whsec_ (это signing secret из раздела Webhooks в Stripe Dashboard, а не сам API-ключ).

Опционально — блок «Настройки Apple Pay»:

• Включите переключатель «Включить Apple Pay».
• Укажите Merchant ID из Apple Developer (начинается с merchant.).

Настройки HyperPay

В форме появится блок «Настройки HyperPay»:

• Access Token — токен доступа к API HyperPay.
• Entity ID — идентификатор торговой точки.
• Webhook Secret — строка из 64 hex-символов (ключ AES-256 для проверки вебхуков).
• API URL — адрес API HyperPay для вашего региона.

Опционально — блок «Настройки Apple Pay» (аналогично Stripe, но с поддержкой сети Mada для Саудовской Аравии).

Настройки MethodPay

В форме появится блок «Настройки MethodPay» с полями, предоставленными вашим менеджером MethodPay/Paygine. Провайдер поддерживает только оплату картой, Apple Pay и СБП недоступны.

---

Кассовые провайдеры

Кассовый провайдер отвечает за формирование и передачу фискальных чеков. IZI поддерживает два адаптера, каждый для своего региона.

Адаптеры и их регионы

Адаптер	Поддерживаемые страны	Особенности
Принтер	ОАЭ (AE), Марокко (MA), Саудовская Аравия (SA)	VAT 5%, TRN при включённом VAT, указание юридического лица обязательно
ККМ	Россия (RU)	Обязательный налоговый режим для каждой категории операций

Как создать кассового провайдера

1. Нажмите «Добавить» → выберите «Кассовый провайдер».
2. Введите Название интеграции.
3. Выберите Адаптер (Принтер или ККМ).
4. Укажите Страну.
5. Заполните поле Кассир — имя или идентификатор кассира, который будет фигурировать в чеках.
6. Настройте Настройки налогообложения (зависят от адаптера).
7. Нажмите «Сохранить».

Налоговые настройки — Принтер (ОАЭ / Марокко / Саудовская Аравия)

• VAT — переключатель. Если включён, ставка 5% применяется к чекам.
• TRN (Tax Registration Number) — налоговый номер плательщика НДС. Обязателен при включённом VAT. Не должен превышать допустимую длину символов.
• Юридическое лицо — наименование юрлица, которое печатается в чеке. Для адаптера «Принтер» поле обязательно.

Налоговые настройки — ККМ (Россия)

Для адаптера ККМ нужно указать налоговый режим отдельно для трёх категорий операций:

Категория	Что включает	Когда формируется чек
Пополнение баланса	Клиент вносит деньги на счёт — зачисляются как депозит	При пополнении
Услуги	Покупка игровых тарифов и времени (списание с баланса)	При покупке тарифа
Товары	Покупка позиций бара и мерча (списание с баланса)	При покупке товара

Для каждой категории выбирается свой налоговый режим из списка. IZI поддерживает все актуальные режимы: ПСН (патент), УСН (доход), УСН (доход-расход), АУСН (доход) 8%, АУСН (доход-расход) 20%, ОСНО с различными ставками НДС (0%, 10%, 20%, 22% и расчётные ставки), а также УСН с пониженными региональными ставками 5% и 7%.

---

Управление провайдерами

Таблица провайдеров

Все созданные провайдеры отображаются в единой таблице. Кликните на строку, чтобы открыть форму редактирования. В колонке «Использование» видно, к скольким кассам привязан каждый провайдер — это помогает понять, насколько критично вносить изменения.

Редактирование

Учётные данные можно обновить в любой момент — например, при ротации ключей. После сохранения изменений провайдер продолжает работу без перерыва. Если вы обновляете Webhook Secret или Webhook URL, не забудьте синхронно обновить его и на стороне провайдера.

Удаление

Удаление провайдера необратимо. Перед удалением убедитесь, что он не привязан ни к одной кассе клуба — иначе кассы потеряют связь с эквайрером или фискальной системой. Количество привязанных касс видно в колонке «Использование».

---

Часто задаваемые вопросы

Нужно ли настраивать оба типа провайдеров?

Это зависит от требований вашего рынка. Платёжный провайдер нужен, если клиенты оплачивают картой через терминал или мобильное приложение. Кассовый провайдер нужен, если законодательство вашей страны требует выдавать фискальные чеки — как, например, в России (54-ФЗ) или ОАЭ (VAT). Клубы, работающие только с наличными без фискализации, могут не настраивать кассового провайдера.

Можно ли использовать один платёжный провайдер для нескольких клубов?

Да. Провайдер создаётся один раз на уровне организации и затем привязывается к кассам любого количества клубов в сети. Это позволяет управлять ключами в одном месте.

Как IZI использует Webhook URL?

После создания платёжного провайдера система автоматически генерирует уникальный Webhook URL. По этому адресу платёжная система отправляет уведомления о статусах транзакций (успех, отклонение, возврат). Без корректно настроенного вебхука IZI не будет получать подтверждения платежей в реальном времени.

Что делать, если провайдер показывает статус «Не настроен» после сохранения?

Проверьте правильность введённых ключей. Распространённые ошибки: для Stripe Webhook Secret указан API-ключ вместо signing secret (должен начинаться с whsec_); для HyperPay Webhook Secret указана строка не из 64 hex-символов; для Apple Pay в Stripe или HyperPay Merchant ID не начинается с merchant..