Sylius

Sylius to nowoczesna platforma e-commerce typu headless, oparta na Symfony. Tpay oferuje integrację typu plugin, umożliwiającą elastyczne wdrożenie płatności w projektach szytych na miarę. Rozwiązanie wspiera API-first development oraz najpopularniejsze metody płatności takie jak: BLIK, karty, przelewy online, e-wallety oraz płatności ratalne i odroczone.

Zanim zaczniesz

Wymagania:

Sklep działający na platformie Sylius.
Sklep z ustawioną walutą Polski Złoty (PLN).
Aktywne konto w Tpay.

Uwaga

W celu poprawnego odbioru powiadomień o statusie transakcji konieczne jest zezwolenie na nadpisywanie adresu URL powiadomień. W Panelu Akceptanta przejdź w menu do Ustawienia → Powiadomienia → w sekcji URL do powiadomień, włącz opcję: Zezwól na nadpisanie adresu URL powiadomienia.

Zanim zaczniesz

Konfiguracja płatności

W panelu administratora przejdź do zakładki Metody płatności.
Wybierz metodę płatności i naciśnij Edytuj.
Po wyborze danej metody skonfiguruj danymi z konta Tpay.

Konfiguracja

Przekierowanie na Tpay

Przekierowanie klienta do Panelu Transakcyjnego Tpay, gdzie prezentowana jest pełna lista metod płatności udostępnianych przez sprzedawcę.

Przekierowania płatności

Pole konfiguracji	Opis pola
Client ID	Dostępny w Panelu Akceptanta w systemie Tpay w zakładce Integracje → API → sekcja Klucze do nowego Open Api w polu Client ID.
Secret	Dostępne w Panelu Akceptanta w systemie Tpay w zakładce Integracje → API → sekcja Klucze do nowego Open Api w polu Secret.
Merchant ID	Numer identyfikacyjny Sprzedawcy. Inaczej, numer ID do logowania do Panelu Akceptanta Tpay.
Kod bezpieczeństwa	Kod bezpieczeństwa, dostępny w Panelu Akceptanta w systemie Tpay w zakładce Ustawienia → Powiadomienia → sekcja Zabezpieczenia.
Tryb produkcyjny	Wybór środowiska, na którym ma działać Tpay. Do integracji środowiska Sandbox użyj danych z konta Sandbox.
Testuj połączenie	Weryfikacja poprawności danych konfiguracyjnych.

Karta

Przyjmowanie płatności kartowych bezpośrednio na stronie sklepu za pomocą zintegrowanego formularza, bez konieczności przechodzenia do zewnętrznych serwisów.

Konfiguracja

Pole konfiguracji	Opis pola
Client ID	Dostępny w Panelu Akceptanta w systemie Tpay w zakładce Integracje → API → sekcja Klucze do nowego Open Api w polu Client ID.
Secret	Dostępne w Panelu Akceptanta w systemie Tpay w zakładce Integracje → API → sekcja Klucze do nowego Open Api w polu Secret.
Klucz RSA	Klucz RSA, dostępny w Panelu Akceptanta w systemie Tpay w zakładce Płatności kartami → API → sekcja Klucz publiczny RSA dla acquirera Elavon (widoczny po włączeniu metody securesale), natomiast dla acquirera Pekao klucz znajduje się w zakładce Integracje → API.
Merchant ID	Numer identyfikacyjny Sprzedawcy. Inaczej, numer ID do logowania do Panelu Akceptanta Tpay.
Kod bezpieczeństwa	Kod bezpieczeństwa, dostępny w Panelu Akceptanta w systemie Tpay w zakładce Ustawienia → Powiadomienia → sekcja Zabezpieczenia.
Tryb produkcyjny	Wybór środowiska, na którym ma działać Tpay. Do integracji środowiska Sandbox użyj danych z konta Sandbox.
Testuj połączenie	Weryfikacja poprawności danych konfiguracyjnych.

BLIK

Implementacja formularza pozwalającego klientowi na wprowadzenie kodu BLIK i sfinalizowanie płatności na stronie sklepu.

Blik

Pole konfiguracji	Opis pola
Client ID	Dostępny w Panelu Akceptanta w systemie Tpay w zakładce Integracje → API → sekcja Klucze do nowego Open Api w polu Client ID.
Secret	Dostępne w Panelu Akceptanta w systemie Tpay w zakładce Integracje → API → sekcja Klucze do nowego Open Api w polu Secret.
Merchant ID	Numer identyfikacyjny Sprzedawcy. Inaczej, numer ID do logowania do Panelu Akceptanta Tpay.
Kod bezpieczeństwa	Kod bezpieczeństwa, dostępny w Panelu Akceptanta w systemie Tpay w zakładce Ustawienia → Powiadomienia → sekcja Zabezpieczenia.
Tryb produkcyjny	Wybór środowiska, na którym ma działać Tpay. Do integracji środowiska Sandbox użyj danych z konta Sandbox.
Testuj połączenie	Weryfikacja poprawności danych konfiguracyjnych.

Przekierowanie do banku

Prezentuje listę wszystkich dostępnych kanałów płatności na stronie sklepu, a po dokonaniu wyboru przez klienta następuje bezpośrednie przekierowanie do serwisu bankowego z pominięciem Panelu Tpay.

Bank redirect

Pole konfiguracji	Opis pola
Client ID	Dostępny w Panelu Akceptanta w systemie Tpay w zakładce Integracje → API → sekcja Klucze do nowego Open Api w polu Client ID.
Secret	Dostępne w Panelu Akceptanta w systemie Tpay w zakładce Integracje → API → sekcja Klucze do nowego Open Api w polu Secret.
Merchant ID	Numer identyfikacyjny Sprzedawcy. Inaczej, numer ID do logowania do Panelu Akceptanta Tpay.
Kod bezpieczeństwa	Kod bezpieczeństwa, dostępny w Panelu Akceptanta w systemie Tpay w zakładce Ustawienia → Powiadomienia → sekcja Zabezpieczenia.
Tryb produkcyjny	Wybór środowiska, na którym ma działać Tpay. Do integracji środowiska Sandbox użyj danych z konta Sandbox.
Testuj połączenie	Weryfikacja poprawności danych konfiguracyjnych.

Przekierowanie na kanał płatniczy

Wyświetlania na stronie sklepu tylko jednej, konkretnej metody płatności (np. przelewu dla danego banku), która przekieruje klienta bezpośrednio, pomijająć Panel Transakcyjny Tpay.

Redirect channel

Pole konfiguracji	Opis pola
Client ID	Dostępny w Panelu Akceptanta w systemie Tpay w zakładce Integracje → API → sekcja Klucze do nowego Open Api w polu Client ID.
Secret	Dostępne w Panelu Akceptanta w systemie Tpay w zakładce Integracje → API → sekcja Klucze do nowego Open Api w polu Secret.
ID kanału Tpay	Po użyciu przycisku Testuj połączenie, zostanie zwrócona lista wszystkich dostępnych kanałów. Wybierz jeden kanał.
Merchant ID	Numer identyfikacyjny Sprzedawcy. Inaczej, numer ID do logowania do Panelu Akceptanta Tpay.
Kod bezpieczeństwa	Kod bezpieczeństwa, dostępny w Panelu Akceptanta w systemie Tpay w zakładce Ustawienia → Powiadomienia → sekcja Zabezpieczenia.
Tryb produkcyjny	Wybór środowiska, na którym ma działać Tpay. Do integracji środowiska produkcyjnego użyj danych z Panelu Akceptanta. Do integracji środowiska Sandbox użyj danych z konta Sandbox.
Testuj połączenie	Weryfikacja poprawności danych konfiguracyjnych.

Google Pay

Implementacja przycisku Google Pay, umożliwiająca realizację transakcji bezpośrednio na stronie sklepu.

Google pay

Pole konfiguracji	Opis pola
Client ID	Dostępny w Panelu Akceptanta w systemie Tpay w zakładce Integracje → API → sekcja Klucze do nowego Open Api w polu Client ID.
Secret	Dostępne w Panelu Akceptanta w systemie Tpay w zakładce Integracje → API → sekcja Klucze do nowego Open Api w polu Secret.
Merchant ID	Numer identyfikacyjny Sprzedawcy. Inaczej, numer ID do logowania do Panelu Akceptanta Tpay.
Kod bezpieczeństwa	Kod bezpieczeństwa, dostępny w Panelu Akceptanta w systemie Tpay w zakładce Ustawienia → Powiadomienia → sekcja Zabezpieczenia.
Identyfikator sprzedawcy Google	Jest to integracja płatności bezpośrednio w Twoim sklepie. W tym celu musisz mieć uruchomiony tryb produkcyjny w Google Pay API w Google Pay Business Console. W polu wpisujesz identyfikator nadany przez Google. Szczegółowe informacje znajdziesz w dokumentacji Tpay dla płatności Google Pay on-site.
Tryb produkcyjny	Wybór środowiska, na którym ma działać Tpay. Do integracji środowiska produkcyjnego użyj danych z Panelu Akceptanta. Do integracji środowiska Sandbox użyj danych z konta Sandbox.
Testuj połączenie	Weryfikacja poprawności danych konfiguracyjnych.

Apple Pay

Implementacja przycisku Apple Pay, umożliwiająca realizację transakcji bezpośrednio na stronie sklepu.

Apple pay

Pole konfiguracji	Opis pola
Client ID	Dostępny w Panelu Akceptanta w systemie Tpay w zakładce Integracje → API → sekcja Klucze do nowego Open Api w polu Client ID.
Secret	Dostępne w Panelu Akceptanta w systemie Tpay w zakładce Integracje → API → sekcja Klucze do nowego Open Api w polu Secret.
Merchant ID	Numer identyfikacyjny Sprzedawcy. Inaczej, numer ID do logowania do Panelu Akceptanta Tpay.
Kod bezpieczeństwa	Kod bezpieczeństwa, dostępny w Panelu Akceptanta w systemie Tpay w zakładce Ustawienia → Powiadomienia → sekcja Zabezpieczenia.
Identyfikator sprzedawcy Apple Pay	Jest to integracja płatności bezpośrednio w Twoim sklepie. W tym celu musisz mieć zweryfikowaną domenę przez Apple i utworzone konto developerskie w Apple Developer. W polu wpisujesz identyfikator nadany przez Apple. Szczegółowe informacje znajdziesz w dokumentacji Tpay dla płatności Apple Pay on-site.
Tryb produkcyjny	Wybór środowiska, na którym ma działać Tpay. Do integracji środowiska Sandbox użyj danych z konta Sandbox.
Testuj połączenie	Weryfikacja poprawności danych konfiguracyjnych.

Visa Mobile

Udostępnienie formularza na stronie sklepu, który pozwala na realizację płatności Visa Mobile poprzez podanie numeru telefonu.

Visa mobile

Pole konfiguracji	Opis pola
Client ID	Dostępny w Panelu Akceptanta w systemie Tpay w zakładce Integracje → API → sekcja Klucze do nowego Open Api w polu Client ID.
Secret	Dostępne w Panelu Akceptanta w systemie Tpay w zakładce Integracje → API → sekcja Klucze do nowego Open Api w polu Secret.
Merchant ID	Numer identyfikacyjny Sprzedawcy. Inaczej, numer ID do logowania do Panelu Akceptanta Tpay.
Kod bezpieczeństwa	Kod bezpieczeństwa, dostępny w Panelu Akceptanta w systemie Tpay w zakładce Ustawienia → Powiadomienia → sekcja Zabezpieczenia.
Tryb produkcyjny	Wybór środowiska, na którym ma działać Tpay. Do integracji środowiska Sandbox użyj danych z konta Sandbox.
Testuj połączenie	Weryfikacja poprawności danych konfiguracyjnych.

Sylius

Zanim zaczniesz

Konfiguracja płatności

Przekierowanie na Tpay

Karta

BLIK

Przekierowanie do banku

Przekierowanie na kanał płatniczy

Google Pay

Apple Pay

Visa Mobile

FAQ

Czy plugin Sylius działa ze środowiskiem Sandbox?

Po opłaceniu transakcji status zamówienia na sklepie wciąż pozostaje na Oczekujący na płatność.

Jak wykonać zwrot całkowity lub częściowy kwoty z poziomu platformy sprzedażowej Sylius?

Mój sklep obsługuje walutę euro, czy mogę korzystać z modułu?