---
title: "Jak zintegrować Tpay z WordPress i WooCommerce"
url: https://dh-pomoc.redzioch.pl/baza-wiedzy/jak-zintegrowac-tpay-z-wordpress-i-woocommerce/
modified: 2026-05-25
group: "WordPress i sklepy"
category: "Tpay"
type: "Instrukcja"
description: "Integracja Tpay z WordPress i WooCommerce polega na zainstalowaniu wtyczki płatności, aktywowaniu jej w ustawieniach WooCommerce oraz uzupełnieniu danych z Panelu Akceptanta Tpay, takich jak ID sprzedawcy, kod bezpieczeństwa i w niektórych przypadkach klucze API. To najprostsza droga do uruchomienia…"
language: pl
---

# Jak zintegrować Tpay z WordPress i WooCommerce

Integracja Tpay z WordPress i WooCommerce polega na zainstalowaniu wtyczki płatności, aktywowaniu jej w ustawieniach WooCommerce oraz uzupełnieniu danych z Panelu Akceptanta Tpay, takich jak ID sprzedawcy, kod bezpieczeństwa i w niektórych przypadkach klucze API. To najprostsza droga do uruchomienia płatności online w sklepie opartym o WooCommerce, ponieważ nie wymaga samodzielnego programowania integracji.

## Co przygotować przed startem

Zanim zaczniesz, sklep powinien działać na WordPressie z aktywną wtyczką WooCommerce, a Ty musisz mieć aktywne konto w Tpay. W materiałach Tpay pojawia się też wymaganie odpowiedniej wersji PHP, przy czym instrukcja WooCommerce wskazuje minimum PHP 5.3, a wersja Open API minimum PHP 7.0, dlatego w praktyce najlepiej upewnić się, że serwer korzysta z nowszej wersji zgodnej z aktualnym WordPressem i WooCommerce.

W przypadku wdrożenia opartego o Open API sklep powinien mieć ustawioną walutę PLN, a na koncie Tpay trzeba mieć uruchomiony dostęp do Open API w sekcji Integracja i API w Panelu Akceptanta. To ważne, bo bez aktywnego dostępu do właściwych kluczy część metod płatności albo funkcji dodatkowych po prostu nie zadziała.

## Instalacja wtyczki

Instalację zaczynasz w panelu WordPressa, przechodząc do sekcji Wtyczki i Dodaj nową. Następnie możesz wgrać pobraną wtyczkę Tpay przez opcję wyślij wtyczkę na serwer, zainstalować ją i aktywować, a analogicznie wcześniej lub równolegle zadbać o aktywną wtyczkę WooCommerce.

W materiałach Tpay opisano też prosty scenariusz, w którym po aktywacji WooCommerce i bramki Tpay przechodzisz od razu do konfiguracji płatności w sklepie. Dzięki temu cały proces jest zrozumiały nawet dla osoby nietechnicznej, bo większość ustawień uzupełnia się z poziomu panelu administracyjnego WordPressa.

## Konfiguracja w WooCommerce

Po instalacji przejdź do WooCommerce, potem Ustawienia i Płatności, włącz metodę płatności Tpay, a następnie kliknij Zarządzaj lub dokończ konfigurację, zależnie od wersji modułu. W tym miejscu wpisujesz podstawowe dane integracyjne, przede wszystkim ID sprzedawcy oraz kod bezpieczeństwa pobrany z konta Tpay.

Jeżeli chcesz uruchomić płatności BLIK na stronie sklepu lub korzystać ze zwrotów, potrzebne będą także klucz API i hasło API. Tpay wskazuje, że klucz należy utworzyć w Panelu Akceptanta w sekcji Integracja lub API, z odpowiednimi uprawnieniami do transakcji i zwrotów oraz z aktywnym statusem klucza.

## Na co uważać

Jednym z najczęstszych błędów jest wpisanie nieprawidłowego kodu bezpieczeństwa albo pomylenie go z innymi danymi z panelu, co może powodować błędy integracji i komunikaty o niepoprawnych parametrach. Dlatego po zapisaniu ustawień warto od razu wykonać testową płatność i sprawdzić, czy zamówienie otrzymuje poprawny status.

Dobrą praktyką jest również sprawdzenie, czy wybrane metody płatności są faktycznie włączone i czy sklep zapisuje poprawnie statusy zamówień po opłaceniu. Gotowe moduły sklepowe Tpay weryfikują powiadomienia o płatności przed zmianą statusu zamówienia, co pomaga ograniczyć błędy po stronie sklepu.
