CloudPayments в IZI: подключение

CloudPayments в IZI: подключение

CloudPayments — российский платёжный провайдер, который позволяет клиентам клуба пополнять игровой баланс онлайн через мобильное приложение IZI. Поддерживает карты Visa, Mastercard, МИР и СБП. Подключение занимает несколько шагов: регистрация у провайдера, получение ключей, настройка в IZI, тест.

Шаг 1. Зарегистрируйтесь в CloudPayments

Перейдите на cloudpayments.ru и создайте аккаунт.

При регистрации потребуется:

• ИНН организации или ИП
• Реквизиты банковского счёта для выплат
• Данные о сайте/приложении (укажите что работаете с IZI)

После проверки документов CloudPayments активирует аккаунт и предоставит доступ к личному кабинету.

Шаг 2. Создайте проект в личном кабинете

В личном кабинете CloudPayments создайте проект для вашего клуба:

1. Перейдите в раздел Проекты → Создать проект.
2. Укажите название (например, «Клуб Арена»).
3. Тип проекта — Сайт или Мобильное приложение (выберите по ситуации).
4. Укажите URL вашего домена (если есть) или домен IZI.

После создания проект получит Public ID и API Secret — это ваши ключи для интеграции.

Шаг 3. Получите API-ключи

В настройках проекта найдите:

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

Скопируйте оба — они понадобятся в следующем шаге. Секретный ключ не показывается повторно в некоторых версиях интерфейса — сохраните его сразу.

Шаг 4. Настройте интеграцию в IZI

Перейдите в Настройки клуба → Способы оплаты → CloudPayments.

Введите:

• Public ID из CloudPayments
• API Secret из CloudPayments

Сохраните настройки. IZI автоматически сгенерирует Webhook URL — скопируйте его, он понадобится на следующем шаге.

Шаг 5. Настройте webhook в CloudPayments

Webhook — адрес, на который CloudPayments отправляет уведомление после каждого платежа. Без него IZI не узнает что клиент заплатил.

В личном кабинете CloudPayments:

1. Перейдите в Настройки проекта → Уведомления.
2. В поле URL для уведомлений вставьте Webhook URL, который сгенерировал IZI.
3. Убедитесь что URL начинается с https:// — CloudPayments требует защищённого соединения.
4. Сохраните.

Дополнительно рекомендуется включить уведомления для событий:

• pay — успешный платёж
• fail — неуспешный платёж
• refund — возврат

Шаг 6. Протестируйте в режиме sandbox

Прежде чем принимать реальные деньги, проведите тест.

В личном кабинете CloudPayments переключитесь в Тестовый режим. В нём используются тестовые карты (номера публикуются в документации CloudPayments).

Проведите тестовый платёж через мобильное приложение IZI:

1. Откройте приложение и перейдите к пополнению баланса.
2. Введите минимальную тестовую сумму.
3. Используйте тестовую карту из документации CloudPayments.
4. Проверьте что транзакция появилась в истории IZI.
5. Проверьте что баланс клиента обновился.

Если тест прошёл успешно — переключайтесь на боевые ключи.

Шаг 7. Переключитесь на боевой режим

В настройках CloudPayments переключите проект в Боевой режим (Production).

В IZI убедитесь что введены боевые API-ключи (не тестовые). Тестовые и боевые ключи у CloudPayments разные — не перепутайте.

Проведите один реальный тестовый платёж с минимальной суммой, убедитесь что деньги зачислились на баланс клиента в IZI.

Особенности работы с 54-ФЗ

Если ваш клуб работает в России и вы обязаны применять онлайн-кассу — каждый онлайн-платёж через CloudPayments должен сопровождаться фискальным чеком.

CloudPayments поддерживает это через протокол ФФД (Формат фискальных данных). Настройка:

1. В личном кабинете CloudPayments перейдите в Фискализация.
2. Подключите онлайн-кассу (поддерживаются Атол Онлайн, OFD.ru и другие операторы).
3. Настройте параметры чека (наименование товара, НДС, предмет расчёта).

Детали настройки 54-ФЗ зависят от вашего оператора фискальных данных — обратитесь в поддержку CloudPayments за актуальной инструкцией.

Диагностика частых проблем

Платёж прошёл, баланс не обновился

1. Проверьте Webhook URL в CloudPayments — должен точно совпадать с URL из настроек IZI (регистр, слэш в конце, протокол https).
2. Проверьте в истории CloudPayments: платёж зафиксирован? статус «Оплачен»?
3. Проверьте логи webhook в CloudPayments — была ли попытка отправки уведомления?
4. Убедитесь что IZI-сервер доступен по webhook URL (не блокирует IP CloudPayments).

Карта отклонена

Проверьте:

• Карта поддерживается CloudPayments (МИР, Visa, Mastercard — да; UnionPay — нет в стандартной конфигурации)
• Не превышен лимит транзакции (CloudPayments имеет суточные лимиты по умолчанию)
• Карта не заблокирована банком для интернет-платежей

Ошибка 401 / Authentication failed

Неверный API Secret. Пересохраните ключ — убедитесь что скопировали его полностью без лишних пробелов.

Возвраты через CloudPayments

При проведении возврата в IZI:

1. IZI отправляет запрос на возврат в CloudPayments через API.
2. CloudPayments обрабатывает возврат и возвращает деньги на карту клиента.
3. Срок зачисления — 3–10 рабочих дней (зависит от банка клиента).
4. В истории транзакций IZI появится запись «Возврат».

Возвраты работают автоматически если API Secret введён корректно и у проекта CloudPayments нет ограничений на рефанды.

Что делать дальше

После успешного подключения:

• Убедитесь что кнопка онлайн-оплаты появилась в мобильном приложении у клиентов
• Настройте бонус при пополнении — он срабатывает и для онлайн-платежей
• Расскажите клиентам о возможности пополнять баланс самостоятельно — это снижает нагрузку на кассира в часы пик

См. также

• Эквайринг-провайдеры: интеграции — другие поддерживаемые провайдеры
• Способы оплаты: настройка — где вводить ключи в CRM
• Пополнение через приложение — как клиент видит процесс
• Возврат денег клиенту — как проводить возврат онлайн-платежей
• Эквайринг — общая логика приёма безналичных платежей