Solomono Инструкции Подключение модулей оплаты МОДУЛЬ ОПЛАТЫ TRANZZO

МОДУЛЬ ОПЛАТЫ TRANZZO

 

Что будет настроено

  • Учётная запись в Tranzzo Space.

  • Проверка, что в Solomono включён модуль «Оплата картами».

  • Модуль Tranzzo в разделе «Модули Оплаты».

  • POS ID, API Key, Endpoints Key и Secret Key в настройках Tranzzo.

  • Статус заказа при создании и статус после успешной оплаты.

  • Проверка callback URL, которые нужны для изменения статуса заказа после оплаты.

Что подготовить

  • Доступ к Tranzzo Space или новый email для регистрации.

  • Активированный проект в Tranzzo: тестовый или боевой.

  • POS ID, API Key, Endpoints Key и Secret Key именно из того проекта, который будет использовать магазин.

  • Доступ администратора к магазину Solomono.

  • Доступ к firewall / Cloudflare / хостингу, если сайт защищён дополнительными правилами.

Внимание. Ключи Tranzzo являются секретными данными. Не добавляйте их на скриншоты, в чаты или инструкции. В документе они должны быть замаскированы.


 

1. Зарегистрируйтесь или войдите в Tranzzo Space

  1. Откройте https://space.tranzzo.com/login?lang=en.

  2. Если аккаунта ещё нет, перейдите на вкладку Register и создайте учётную запись.

  3. Если аккаунт уже создан, откройте вкладку Log In, введите email и пароль.

  4. При необходимости пройдите reCAPTCHA или другую проверку безопасности.

Рисунок 1. Страница входа и регистрации Tranzzo Space

Внимание. В Tranzzo Space reCAPTCHA может появляться даже при правильном пароле. Это нормальная проверка безопасности, её нужно проходить вручную.

2. Найдите ключи проекта в Tranzzo

В Tranzzo нужно взять ключи из конкретного проекта. Для боевой оплаты используйте ключи боевого проекта. Для проверки в test mode используйте ключи тестового проекта.

Данные

Куда вставляются в Solomono

POS ID

Tranzzo POS ID

API Key

Tranzzo API Key

Endpoints Key

Tranzzo Endpoints Key

Secret Key

Tranzzo Secret Key


 

Результат. Официальная документация Tranzzo описывает аутентификацию через POS_ID, API_KEY/подпись и ENDPOINTS_KEY. В модуле Solomono эти значения заполняются отдельными полями.

Рисунок 2. Официальная документация Tranzzo по аутентификации

3. Убедитесь, что включена «Оплата картами»

  1. Войдите в админ-панель Solomono.

  2. Откройте Модули → Solo модули.

  3. Найдите строку «Оплата картами (13 способов)».

  4. Убедитесь, что переключатель в этой строке включён.

Рисунок 3. Включённый модуль «Оплата картами» в Solo модулях

4. Установите или откройте модуль Tranzzo

  1. В админ-панели откройте Модули → Оплата.

  2. В списке «Модули Оплаты» найдите Tranzzo.

  3. Если вместо карандаша рядом с Tranzzo отображается кнопка с плюсом, нажмите её, чтобы установить модуль.

  4. Если модуль уже установлен, нажмите иконку карандаша, чтобы открыть настройки.

Рисунок 4. Модуль Tranzzo в списке способов оплаты

5. Заполните настройки Tranzzo в Solomono

  1. Включите переключатель Allow Tranzzo module.

  2. Вставьте Tranzzo POS ID.

  3. Вставьте Tranzzo API Key.

  4. Вставьте Tranzzo Endpoints Key.

  5. Вставьте Tranzzo Secret Key.

  6. В поле Paid order status выберите статус, который заказ должен получить после успешной оплаты, например «Оплачено».

  7. В поле Default order status выберите статус, который будет установлен сразу после перехода покупателя к оплате, например «Ожидает рассмотрения».

  8. Остальные поля можно оставить без изменений или настроить позже при необходимости.

Рисунок 5. Настройки модуля Tranzzo в Solomono

Внимание. Если используется Tranzzo test mode (XTS), в полях ключей должны быть ключи из тестового проекта Tranzzo. На checkout Tranzzo будет использовать тестовую валюту XTS.

Пояснение полей модуля

Поле

Что означает

Allow Tranzzo module

Включает или выключает способ оплаты Tranzzo в магазине.

Tranzzo POS ID

Идентификатор POS/проекта в Tranzzo.

Tranzzo API Key

API-ключ для подписи/аутентификации запросов.

Tranzzo Endpoints Key

Ключ для обращения к API endpoint Tranzzo.

Tranzzo Secret Key

Секретный ключ для проверки подписей и безопасной работы callback.

Sort order

Порядок отображения способа оплаты среди других методов.

Paid order status

Статус, который Solomono установит после успешной оплаты.

Default order status

Статус нового заказа до подтверждения оплаты.

Zone

Географическая зона, для которой доступен способ оплаты. Если ограничение не нужно, оставьте «--нет--».

Checkout hint

Текст-подсказка, который покупатель видит возле способа оплаты.

Tranzzo test mode (XTS)

Режим тестирования с тестовой валютой XTS.


 

6. Проверьте callback URL

(если ваш сайт на собственном сервере)

Для корректного изменения статуса после оплаты должны быть доступны два URL вашего магазина:

https://<домен>/includes/callbacks/tranzzo_callback.php

https://<домен>/acquire_response.php

  1. Откройте эти URL в браузере или передайте их техническому специалисту для проверки доступности.

  2. Убедитесь, что firewall, Cloudflare или правила хостинга не блокируют POST-запросы на callback.

  3. Если используется allowlist по IP, добавьте IP Tranzzo из официальной документации или обратитесь в поддержку Tranzzo за актуальным списком.

Рисунок 6. Официальная документация Tranzzo по webhooks

Внимание. Tranzzo отправляет callback/webhook на сервер магазина. Если callback заблокирован, покупатель может оплатить, но статус заказа в админке не изменится автоматически.

7. Сохраните и протестируйте оплату

  1. Нажмите «Сохранить и закрыть».

  2. Перейдите на сайт магазина и оформите тестовый заказ.

  3. На шаге оплаты выберите Tranzzo.

  4. После перехода на страницу оплаты заказ будет создан в Default order status.

  5. После успешной оплаты Tranzzo должен вернуть callback, и заказ изменит статус на Paid order status.

  6. Если тестируете test mode, используйте тестовые карточные данные из документации Tranzzo.

Рисунок 7. Официальная документация Tranzzo с тестовыми картами


 

Типичные проблемы

Проблема

Что проверить

Tranzzo не видно на checkout

Включена «Оплата картами», включён Allow Tranzzo module, способ доступен для нужной зоны. Также проверьте настройки группы покупателей: в поле «Модули Оплаты» для нужной группы должен быть Tranzzo. Если в группе заполнены «Модули Доставки» или используется модуль Ship 2 Pay, убедитесь, что Tranzzo разрешён для выбранного способа доставки.

Ошибка после перехода к оплате

POS ID и все ключи взяты из одного и того же проекта Tranzzo.

В test mode не работает оплата

Использованы ключи тестового проекта, а не боевого; включён Tranzzo test mode (XTS).

Заказ создаётся, но статус не изменяется

Callback URL доступен, POST не блокируется firewall/Cloudflare, Secret Key корректный.

Оплата успешна, но покупателя не возвращает на сайт

Проверьте доступность https://<домен>/acquire_response.php.

Tranzzo возвращает ошибку авторизации

Проверьте POS ID, API Key, Endpoints Key, Secret Key и режим тест/боевой.

 

Контрольный список

  • □ Аккаунт Tranzzo создан или доступ к нему получен.
  • □ В Tranzzo выбран правильный проект: тестовый или боевой.
  • □ POS ID, API Key, Endpoints Key и Secret Key скопированы из одного проекта.
  • □ В Solomono включена «Оплата картами».
  • □ Модуль Tranzzo установлен или открыт для редактирования.
  • □ Allow Tranzzo module включён.
  • □ Статусы Default order status и Paid order status выбраны.
  • □ Callback URL доступен для POST-запросов.
  • □ Проведён тестовый заказ.

Официальные материалы Tranzzo

Tranzzo Space: https://space.tranzzo.com/login

Tranzzo Docs: https://docs.tranzzo.com/uk/

Создание аккаунта: https://docs.tranzzo.com/uk/docs/getting-started/create-account/

Аутентификация API: https://docs.tranzzo.com/uk/docs/api-usage/authentication/

Webhooks: https://docs.tranzzo.com/uk/docs/webhooks/setting/

Тестовые карты: https://docs.tranzzo.com/uk/docs/testing/cards/

Обновлено: 10/07/2026
icon