Solomono Instrukcje Przykłady łączenia modułów płatności MODUŁ PŁATNOŚCI TRANZZO

MODUŁ PŁATNOŚCI TRANZZO

Co zostanie skonfigurowane

Konto Tranzzo Space.
Sprawdzenie, czy moduł Credit cards jest włączony w Solomono.
Moduł płatności Tranzzo w sekcji Payment Modules.
POS ID, API Key, Endpoints Key i Secret Key w ustawieniach modułu Tranzzo.
Domyślny status zamówienia oraz status po pomyślnej płatności.
Callback URL, które muszą być dostępne dla automatycznej aktualizacji statusu zamówienia.

Co przygotować

Dostęp do Tranzzo Space lub adres e-mail do rejestracji.
Aktywny projekt Tranzzo: testowy lub produkcyjny.
POS ID, API Key, Endpoints Key i Secret Key z tego samego projektu Tranzzo.
Dostęp administratora do sklepu Solomono.
Dostęp do ustawień firewall, Cloudflare lub hostingu, jeśli strona jest chroniona dodatkowymi regułami.

Uwaga. Klucze Tranzzo są poufne. Nie umieszczaj ich na zrzutach ekranu, w czatach ani w publicznych instrukcjach. W dokumentacji powinny być zamaskowane.

1. Zarejestruj się lub zaloguj do Tranzzo Space

Otwórz https://space.tranzzo.com/login?lang=en.
Jeśli nie masz jeszcze konta, przejdź do Register i utwórz konto.
Jeśli konto już istnieje, użyj Log In i wprowadź adres e-mail oraz hasło.
Wykonaj reCAPTCHA lub inną kontrolę bezpieczeństwa, jeśli Tranzzo o to poprosi.

Rysunek 1. Strona logowania i rejestracji Tranzzo Space

Uwaga. Tranzzo Space może pokazać reCAPTCHA nawet wtedy, gdy hasło jest poprawne. To standardowa kontrola bezpieczeństwa i trzeba ją wykonać ręcznie.

2. Znajdź dane projektu w Tranzzo

Używaj danych z jednego konkretnego projektu Tranzzo. Do płatności rzeczywistych użyj projektu produkcyjnego. Do testów użyj danych projektu testowego.

Dane	Pole w Solomono
POS ID	Tranzzo POS ID
API Key	Tranzzo API Key
Endpoints Key	Tranzzo Endpoints Key
Secret Key	Tranzzo Secret Key

Rezultat. Dokumentacja Tranzzo opisuje uwierzytelnianie API przy użyciu POS_ID, API_KEY/podpisu i ENDPOINTS_KEY. Moduł Solomono udostępnia osobne pola dla tych wartości.

Rysunek 2. Dokumentacja Tranzzo: uwierzytelnianie API

3. Sprawdź, czy płatności kartą są włączone

Zaloguj się do panelu administracyjnego Solomono.
Otwórz Moduły → Solo modules.
Znajdź moduł Credit cards.
Upewnij się, że przełącznik jest włączony.

Rysunek 3. Moduł Credit cards włączony w Solo modules

4. Zainstaluj lub otwórz moduł Tranzzo

W panelu administracyjnym otwórz Moduły → Payment.
Znajdź Tranzzo na liście Payment Modules.
Jeśli obok Tranzzo widzisz przycisk z plusem, kliknij go, aby zainstalować moduł.
Jeśli moduł jest już zainstalowany, kliknij ikonę ołówka, aby otworzyć jego ustawienia.

Rysunek 4. Tranzzo na liście modułów płatności

5. Wypełnij ustawienia Tranzzo w Solomono

Włącz przełącznik Allow Tranzzo module.
Wprowadź Tranzzo POS ID.
Wprowadź Tranzzo API Key.
Wprowadź Tranzzo Endpoints Key.
Wprowadź Tranzzo Secret Key.
W polu Paid order status wybierz status dla pomyślnie opłaconego zamówienia, na przykład Paid.
W polu Default order status wybierz status przypisywany w momencie przekierowania klienta do płatności, na przykład Awaiting for review.
Pozostałe pola są opcjonalne i można je zmienić później, jeśli będzie taka potrzeba.

Rysunek 5. Ustawienia modułu Tranzzo w Solomono

Uwaga. Jeśli używasz Tranzzo test mode (XTS), wprowadź klucze z projektu testowego Tranzzo. Checkout Tranzzo będzie używać testowej waluty XTS.

Wyjaśnienie pól modułu

Pole	Znaczenie
Allow Tranzzo module	Włącza lub wyłącza Tranzzo jako metodę płatności w sklepie.
Tranzzo POS ID	Identyfikator POS/projektu w Tranzzo.
Tranzzo API Key	Klucz API używany do uwierzytelniania/podpisywania zapytań.
Tranzzo Endpoints Key	Klucz używany przy wywoływaniu endpointów API Tranzzo.
Tranzzo Secret Key	Sekretny klucz używany do podpisów i bezpiecznego przetwarzania callback.
Sort order	Kolejność wyświetlania wśród innych metod płatności.
Paid order status	Status przypisywany po pomyślnej płatności.
Default order status	Początkowy status zamówienia przed potwierdzeniem płatności.
Zone	Strefa geograficzna, w której metoda jest dostępna. Pozostaw --none--, jeśli ograniczenie nie jest potrzebne.
Checkout hint	Tekst wyświetlany klientowi obok metody płatności.
Tranzzo test mode (XTS)	Tryb testowy z testową walutą XTS.

6. Sprawdź callback URL

(jeśli Twoja witryna znajduje się na Twoim własnym serwerze)

Do automatycznej aktualizacji statusu zamówienia te adresy URL muszą być dostępne:

https://<domain>/includes/callbacks/tranzzo_callback.php

https://<domain>/acquire_response.php

Otwórz te adresy URL w przeglądarce lub poproś specjalistę technicznego o ich sprawdzenie.
Upewnij się, że firewall, Cloudflare ani reguły hostingu nie blokują żądań POST do callback.
Jeśli używasz allowlisty IP, dodaj IP Tranzzo z oficjalnej dokumentacji lub poproś wsparcie Tranzzo o aktualną listę.

Rysunek 6. Dokumentacja Tranzzo: webhooks

Uwaga. Tranzzo wysyła callback/webhook do serwera sklepu. Jeśli callback jest zablokowany, klient może zapłacić pomyślnie, ale status zamówienia w panelu administracyjnym nie zaktualizuje się automatycznie.

7. Zapisz i przetestuj płatność

Kliknij Save and close.
Otwórz storefront i złóż zamówienie testowe.
Na etapie płatności wybierz Tranzzo.
Po przekierowaniu na stronę płatności zamówienie zostanie utworzone ze statusem Default order status.
Po pomyślnej płatności Tranzzo wyśle callback, a zamówienie zmieni status na Paid order status.
Jeśli testujesz w trybie testowym, użyj danych kart testowych z dokumentacji Tranzzo.

Rysunek 7. Dokumentacja Tranzzo: karty testowe

Typowe problemy

Problem	Co sprawdzić
Tranzzo nie jest widoczne na checkout	Credit cards są włączone, Allow Tranzzo module jest włączony, a metoda jest dostępna dla wybranej strefy. Sprawdź także ustawienia grupy klientów: Tranzzo musi być uwzględnione w Payment Modules dla wymaganej grupy. Jeśli dla grupy skonfigurowano Shipping Modules lub używany jest Ship 2 Pay, upewnij się, że Tranzzo jest dozwolone dla wybranej metody dostawy.
Błąd po przekierowaniu do płatności	POS ID i wszystkie klucze muszą pochodzić z tego samego projektu Tranzzo.
Tryb testowy nie działa	Użyj kluczy projektu testowego i włącz Tranzzo test mode (XTS).
Zamówienie zostaje utworzone, ale status się nie zmienia	Callback URL jest dostępny, POST nie jest blokowany przez firewall/Cloudflare, a Secret Key jest poprawny.
Płatność jest pomyślna, ale klient nie wraca do sklepu	Sprawdź, czy https://<domain>/acquire_response.php jest dostępny.
Tranzzo zwraca błąd autoryzacji	Sprawdź POS ID, API Key, Endpoints Key, Secret Key oraz tryb testowy/produkcyjny.