Please ensure Javascript is enabled for purposes of website accessibility

Instrukcja instalacji i konfiguracji Tpay - płatności kartami w Shopify

Ostatnia aktualizacja: 28.07.2025

Wymagania:

  • Sklep na platformie Shopify.
  • Sklep z ustawioną walutą Polski Złoty (PLN).
  • Aktywne konto w Tpay.
  • Aktywne płatności kartami. Jeśli ich nie posiadasz, skontaktuj się z Biurem Obsługi Klienta.

Niezbędne ustawienia do prawidłowego działania aplikacji:

Domyślne ustawienia formularza zamówienia w Shopify w polu Kontakt zezwalają na użycie numeru telefonu lub adresu mailowego. Konieczna jest zmiana tych ustawień. W przypadku braku podania adresu mailowego kupujący nie będzie miał możliwości opłacenia zamówienia za pośrednictwem bramki płatniczej Tpay.

W Panelu administratora sklepu przejdź w menu do UstawieniaRealizacja zakupu → w sekcji Metoda kontaktu z klientem zmień opcje na: E-mail.

shopify-cards-tpay-krok1

W celu poprawnego wygenerowania i odbioru powiadomień o statusie transakcji konieczne jest zezwolenie na nadpisywanie adresu URL powiadomień.

W Panelu Akceptanta Tpay przejdź w menu do UstawieniaPowiadomienia → w sekcji URL do powiadomień włącz opcje: Zezwól na nadpisanie adresu URL powiadomienia.

shopify-cards-tpay-krok2
Instalacja modułu za pośrednictwem Shopify App Store

1. Wejdź na stronę Shopifty - płatności kartami Tpay.
2. Naciśnij przycisk Zainstaluj.

shopify-cards-tpay-krok3

3. Zostaniesz przekierowany na panel administracyjny wybranego sklepu, ponownie wybierz Zainstaluj.

shopify-cards-tpay-krok4

4. Zostaniesz przekierowany do panelu konfiguracyjnego.

Konfiguracja aplikacji Tpay - szybkie przelewy i płatności:

1. W panelu konfiguracyjnym aplikacji, skopiuj dane ze swojego konta Tpay.

shopify-cards-tpay-krok5

Client ID - Identyfikator API klienta, dostępny w Panelu Akceptanta w systemie Tpay w zakładce Integracja → API → sekcja Klucze do nowego Open Api w polu Client ID.
Secret - sekret API, dostępny w Panelu Akceptanta w systemie Tpay w zakładce Integracja → API → sekcja Klucze do nowego Open Api w polu Secret.
Kod bezpieczeństwa - kod bezpieczeństwa, dostępny w Panelu Akceptanta w systemie Tpay w zakładce Ustawienia → Powiadomienia → sekcja Bezpieczeństwo.
Klucz RSA:

  • Operator kart ELAVON: klucz dostępny w Panelu Akceptanta w systemie Tpay w Płatności kartami → API → sekcja Klucz publiczny RSA (widoczny po włączeniu metody securesale).
  • Operator kart BANK PEKAO: klucz dostępny w Panelu Akceptanta w systemie Tpay w Integracja → API → sekcja Cards API.

Algorytm podpisu - algorytm używany do szyfrowania danych karty, dostępny w Panelu Akceptanta w systemie Tpay w Płatności kartami → API → Algorytm podpisu.

2. Zapisz zmiany i aktywuj płatności “Tpay - płatności kartami”.

shopify-cards-tpay-krok6

Tryb testowy - jeśli twój sklep jest uruchomiony w trybie testowym/developerskim, włącz tę opcję, by móc zasymulować proces płatności przez bramkę Tpay.
Ikony płatności - możesz włączyć lub wyłączyć ikony płatności, które będą widoczne przy metodzie płatności w formularzu koszyka sklepu.

Chcesz o coś zapytać?

Odpowiemy na Twoje pytanie najszybciej jak to możliwe.