Эквайринг-провайдеры в IZI: интеграции
Эквайринг-провайдеры в IZI: интеграции
Заголовок раздела «Эквайринг-провайдеры в IZI: интеграции»Платёжный провайдер — посредник между IZI и банковской системой. Клиент оплачивает в приложении, провайдер обрабатывает транзакцию, уведомляет IZI через webhook, IZI зачисляет деньги на баланс. Для офлайн-оплаты (POS-терминал) провайдер не нужен — терминал и CRM работают независимо.
Офлайн vs онлайн эквайринг
Заголовок раздела «Офлайн vs онлайн эквайринг»Перед выбором провайдера важно понимать разницу:
| Тип | Что это | Нужен провайдер в IZI? |
|---|---|---|
| POS-терминал (офлайн) | Физический терминал, карта прикладывается в кассе | Нет. Сумма вводится вручную |
| Онлайн-эквайринг (приложение) | Клиент платит в смартфоне | Да. Провайдер обрабатывает транзакцию |
POS-терминал подключается к банку напрямую по отдельному договору — IZI в этой цепочке не участвует. Онлайн-оплата через приложение требует настроенной интеграции в IZI.
Как устроена интеграция
Заголовок раздела «Как устроена интеграция»Стандартная схема работы онлайн-платежа в IZI:
- Клиент выбирает сумму в мобильном приложении и нажимает «Оплатить»
- IZI перенаправляет запрос к провайдеру через API
- Клиент вводит данные карты на странице провайдера (или использует сохранённую карту / Apple Pay / Google Pay)
- Провайдер обрабатывает платёж
- Провайдер отправляет webhook-уведомление на URL IZI
- IZI получает подтверждение и зачисляет деньги на баланс клиента
Весь цикл занимает несколько секунд при штатной работе.
Параметры интеграции
Заголовок раздела «Параметры интеграции»Для подключения любого провайдера в IZI потребуются:
- API-ключ (публичный) — для инициализации платёжной формы на стороне клиента
- Секретный ключ — для серверного взаимодействия (хранится в зашифрованном виде)
- Webhook URL — генерируется IZI автоматически, вводится в личном кабинете провайдера
- Тестовые ключи — для проверки до запуска в боевом режиме
Эти параметры вводятся в Настройки клуба → Способы оплаты → Онлайн-оплата.
Поддерживаемые провайдеры
Заголовок раздела «Поддерживаемые провайдеры»Список актуален на дату публикации. Уточняйте у поддержки IZI доступность конкретного провайдера для вашего региона.
CloudPayments Российский провайдер с поддержкой карт Visa/Mastercard/МИР, СБП, рекуррентных платежей. Хорошо подходит для клубов с большим объёмом онлайн-пополнений — есть специальные тарифы для высоких оборотов. Пошаговая инструкция подключения — в разделе CloudPayments в IZI: подключение.
ЮKassa (бывший Яндекс.Касса) Поддерживает карты, ЮMoney, СБП, рассрочку. Удобна для клубов с аудиторией, привыкшей к экосистеме Яндекс. Регистрация — через сайт ЮKassa, договор в электронном виде.
Тинькофф Эквайринг Карты, СБП, Tinkoff Pay. Если счёт клуба открыт в Тинькофф — процесс подключения быстрее. Комиссия зависит от оборота.
Сбербанк Эквайринг Для клубов с большой долей клиентов платящих через СберБанк Онлайн и SberPay. Интеграция требует прохождения технической проверки со стороны Сбера.
Международные / ОАЭ
Заголовок раздела «Международные / ОАЭ»Stripe Один из крупнейших международных провайдеров. Поддерживает карты Visa/Mastercard/Amex, Apple Pay, Google Pay, множество локальных методов. Доступен в большинстве стран кроме России. Документация API — одна из лучших на рынке.
PayTabs Ориентирован на рынки Ближнего Востока. Поддерживает местные карты, MADA (Саудовская Аравия), KNET (Кувейт). Популярен среди клубов в ОАЭ, Саудовской Аравии, Египте.
HyperPay Ещё один MENA-провайдер. Поддерживает иностранные карты и региональные методы оплаты.
Другие регионы
Заголовок раздела «Другие регионы»IZI работает в разных странах — список провайдеров для вашего рынка запрашивайте у поддержки. Общий принцип интеграции одинаков: API-ключи + webhook — провайдер-зависимы только детали формата.
Сравнение по ключевым параметрам
Заголовок раздела «Сравнение по ключевым параметрам»| Провайдер | Рынок | Методы | Особенности |
|---|---|---|---|
| CloudPayments | RU | Карты, МИР, СБП | Хорошая документация, 54-ФЗ |
| ЮKassa | RU | Карты, ЮMoney, СБП | Экосистема Яндекс |
| Тинькофф | RU | Карты, СБП, Tinkoff Pay | Быстро при счёте в Тинькофф |
| Stripe | International | Карты, Apple/Google Pay | Лучшее API, не работает в RU |
| PayTabs | MENA | Карты, MADA, KNET | Специализация MENA |
Комиссии — не приводятся как абсолютные числа: они зависят от оборота, типа карты и условий договора. Запрашивайте коммерческое предложение напрямую у провайдера.
Типичные ошибки при настройке
Заголовок раздела «Типичные ошибки при настройке»Неверный webhook URL
Заголовок раздела «Неверный webhook URL»Самая частая ошибка. Webhook URL генерируется IZI и должен быть вставлен в личный кабинет провайдера точно в том виде, в котором IZI его выдаёт. Лишний символ или неверный путь — и IZI не будет получать уведомления о платежах.
Боевые ключи вместо тестовых на старте
Заголовок раздела «Боевые ключи вместо тестовых на старте»Сначала всегда тестируйте в режиме sandbox. Каждый провайдер предоставляет тестовые ключи и тестовые карты. Тест занимает 10–15 минут, но страхует от реальных денег в нештатных ситуациях.
Смешение публичного и секретного ключей
Заголовок раздела «Смешение публичного и секретного ключей»Публичный ключ — в поле «Публичный ключ», секретный — в «Секретный ключ». Если перепутать, платёж инициализируется, но подтверждение не пройдёт.
Смена провайдера
Заголовок раздела «Смена провайдера»Если нужно сменить провайдера:
- Настройте нового провайдера в режиме sandbox и проверьте
- Убедитесь что все входящие webhook’и от старого провайдера обработаны (нет платежей в статусе «ожидание»)
- Замените ключи в настройках IZI на новые
- Обновите webhook URL в личном кабинете нового провайдера
- Проведите тестовый платёж в боевом режиме
Параллельная работа двух провайдеров не поддерживается — в IZI настраивается один активный провайдер для онлайн-канала.
См. также
Заголовок раздела «См. также»- CloudPayments в IZI: подключение — детальная инструкция
- Способы оплаты: настройка — где вводить ключи в CRM
- Пополнение через приложение — как работает онлайн-платёж
- Эквайринг — определение и общая логика
Частые вопросы
Обязательно ли подключать провайдера для работы IZI?
Нет. IZI работает без интеграции с провайдером — наличные и ручной ввод карт через POS-терминал доступны без API-ключей. Провайдер нужен только для онлайн-оплаты через мобильное приложение.
Сколько провайдеров можно подключить одновременно?
Обычно один провайдер на клуб для онлайн-канала. Если требуется несколько методов (например, карты + SBP), это зависит от возможностей конкретного провайдера — некоторые поддерживают несколько каналов через один договор.
IZI берёт дополнительную комиссию за эквайринг?
IZI не берёт комиссию сверх тарифа провайдера. Плата за обработку платежей идёт напрямую провайдеру по условиям вашего договора с ним.
Можно ли работать с иностранным провайдером?
Зависит от региона и требований провайдера к юридическому лицу. Stripe, например, работает во многих странах, но требует соответствия локальным требованиям. Уточните у поддержки IZI актуальный список для вашего рынка.
Что такое webhook и зачем он нужен?
Webhook — это URL адрес, на который провайдер отправляет уведомление о результате платежа (успех/ошибка). IZI генерирует этот URL автоматически при настройке интеграции. Без webhook'а баланс клиента не обновится автоматически — платёж пройдёт, но IZI об этом не узнает.
Как проверить что интеграция работает перед запуском?
Большинство провайдеров предоставляют режим sandbox (тестовая среда) с тестовыми ключами и тестовыми картами. Проведите тестовый платёж — убедитесь что транзакция появилась в истории IZI и баланс обновился.