---
title: "Jak zintegrować Tpay z Magento"
url: https://dh-pomoc.redzioch.pl/baza-wiedzy/jak-zintegrowac-tpay-z-magento/
modified: 2026-05-25
group: "WordPress i sklepy"
category: "Tpay"
type: "Instrukcja"
description: "Integracja Tpay z Magento 2 opiera się na instalacji modułu przez Composer, uruchomieniu go komendami Magento oraz uzupełnieniu konfiguracji w panelu administracyjnym sklepu w sekcji Stores, Configuration, Sales i Payment Methods. Do poprawnego wdrożenia potrzebujesz aktywnego konta Tpay, sklepu Magento…"
language: pl
---

# Jak zintegrować Tpay z Magento

Integracja Tpay z Magento 2 opiera się na instalacji modułu przez Composer, uruchomieniu go komendami Magento oraz uzupełnieniu konfiguracji w panelu administracyjnym sklepu w sekcji Stores, Configuration, Sales i Payment Methods. Do poprawnego wdrożenia potrzebujesz aktywnego konta Tpay, sklepu Magento 2, obsługi waluty PLN oraz włączonego dostępu do Open API w Panelu Akceptanta.

## Co przygotować przed wdrożeniem

Dokumentacja Tpay wskazuje, że moduł działa na Magento 2.x, wymaga zainstalowanego Composera oraz aktywnego konta w Tpay. Dodatkowo sklep musi obsługiwać polskiego złotego, a w panelu Tpay trzeba mieć dostęp do sekcji kluczy Open API, ponieważ bez niej nie skonfigurujesz nowego sposobu integracji.

Przed startem warto też sprawdzić ustawienia powiadomień w Panelu Akceptanta. Tpay zaleca włączenie opcji pozwalającej na nadpisywanie adresu URL powiadomień, ponieważ jest to potrzebne do poprawnego odbioru statusów transakcji przez moduł Magento.

## Instalacja modułu

Instalacja odbywa się po stronie serwera i wymaga użycia Composera. Najpierw doinstalowujesz biblioteki Tpay PHP oraz Tpay Open API PHP, potem sam moduł Magento 2 Basic, a następnie uruchamiasz moduł komendami Magento odpowiedzialnymi za aktywację, aktualizację, kompilację i wdrożenie statycznych plików.

Po zakończeniu instalacji logujesz się do panelu Magento i przechodzisz do ustawień płatności. Właśnie tam aktywujesz moduł i wybierasz sposób działania płatności zgodny z potrzebami sklepu, na przykład szybkie przelewy online, płatności kartą przez panel Tpay albo wariant on-site.

## Konfiguracja płatności

W ustawieniach głównych modułu wpisujesz ID sprzedawcy oraz kod bezpieczeństwa z Panelu Akceptanta Tpay. ID sprzedawcy to identyfikator nadany przy rejestracji, a kod bezpieczeństwa znajdziesz w sekcji Ustawienia, Powiadomienia i Bezpieczeństwo.

Jeżeli korzystasz z płatności standardowych przez Open API, musisz dodatkowo uzupełnić Client ID i Secret z sekcji Integracja, API i Klucze do nowego Open API. W przypadku konfiguracji Origin API albo płatności kartowych on-site potrzebne będą z kolei klucz API i hasło API ze starego API.

## Dodatkowe możliwości

Tpay udostępnia w Magento 2 także obsługę wielu walut, ale dla walut innych niż PLN jest ona realizowana przez płatności kartowe z użyciem Origin API i wymaga osobnego konta Tpay obsługującego daną walutę oraz aktywnej funkcji Multistore w Magento.

Moduł wspiera również realizację zwrotów z poziomu Magento przez sekcję Sales, Invoices i opcję Credit memo, ale działa to tylko przy poprawnie skonfigurowanym module. Dlatego najpierw warto doprowadzić do pełnej poprawności podstawowej integracji, a dopiero później uruchamiać funkcje dodatkowe.
