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. На чекауті 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