{"id":16019,"date":"2026-05-25T18:46:13","date_gmt":"2026-05-25T16:46:13","guid":{"rendered":"https:\/\/dhosting.pl\/pomoc\/?post_type=manual_kb&#038;p=16019"},"modified":"2026-05-25T18:46:13","modified_gmt":"2026-05-25T16:46:13","slug":"jak-zintegrowac-tpay-z-magento","status":"publish","type":"manual_kb","link":"https:\/\/dhosting.pl\/pomoc\/baza-wiedzy\/jak-zintegrowac-tpay-z-magento\/","title":{"rendered":"Jak zintegrowa\u0107 Tpay z Magento"},"content":{"rendered":"<p>Integracja Tpay z Magento 2 opiera si\u0119 na instalacji modu\u0142u przez Composer, uruchomieniu go komendami Magento oraz uzupe\u0142nieniu konfiguracji w panelu administracyjnym sklepu w sekcji Stores, Configuration, Sales i Payment Methods. Do poprawnego wdro\u017cenia potrzebujesz aktywnego konta Tpay, sklepu Magento 2, obs\u0142ugi waluty PLN oraz w\u0142\u0105czonego dost\u0119pu do Open API w Panelu Akceptanta.<\/p>\n<div id=\"ez-toc-container\" class=\"ez-toc-v2_0_83 ez-toc-wrap-left counter-flat ez-toc-counter ez-toc-custom ez-toc-container-direction\">\n<div class=\"ez-toc-title-container\">\n<p class=\"ez-toc-title\" style=\"cursor:inherit\">Spis tre\u015bci<\/p>\n<span class=\"ez-toc-title-toggle\"><\/span><\/div>\n<nav><ul class='ez-toc-list ez-toc-list-level-1 ' ><li class='ez-toc-page-1'><a class=\"ez-toc-link ez-toc-heading-1\" href=\"https:\/\/dhosting.pl\/pomoc\/baza-wiedzy\/jak-zintegrowac-tpay-z-magento\/#Co_przygotowac_przed_wdrozeniem\" >Co przygotowa\u0107 przed wdro\u017ceniem<\/a><\/li><li class='ez-toc-page-1'><a class=\"ez-toc-link ez-toc-heading-2\" href=\"https:\/\/dhosting.pl\/pomoc\/baza-wiedzy\/jak-zintegrowac-tpay-z-magento\/#Instalacja_modulu\" >Instalacja modu\u0142u<\/a><\/li><li class='ez-toc-page-1'><a class=\"ez-toc-link ez-toc-heading-3\" href=\"https:\/\/dhosting.pl\/pomoc\/baza-wiedzy\/jak-zintegrowac-tpay-z-magento\/#Konfiguracja_platnosci\" >Konfiguracja p\u0142atno\u015bci<\/a><\/li><li class='ez-toc-page-1'><a class=\"ez-toc-link ez-toc-heading-4\" href=\"https:\/\/dhosting.pl\/pomoc\/baza-wiedzy\/jak-zintegrowac-tpay-z-magento\/#Dodatkowe_mozliwosci\" >Dodatkowe mo\u017cliwo\u015bci<\/a><\/li><\/ul><\/nav><\/div>\n<h2><span class=\"ez-toc-section\" id=\"Co_przygotowac_przed_wdrozeniem\"><\/span>Co przygotowa\u0107 przed wdro\u017ceniem<span class=\"ez-toc-section-end\"><\/span><\/h2>\n<p>Dokumentacja Tpay wskazuje, \u017ce modu\u0142 dzia\u0142a na Magento 2.x, wymaga zainstalowanego Composera oraz aktywnego konta w Tpay. Dodatkowo sklep musi obs\u0142ugiwa\u0107 polskiego z\u0142otego, a w panelu Tpay trzeba mie\u0107 dost\u0119p do sekcji kluczy Open API, poniewa\u017c bez niej nie skonfigurujesz nowego sposobu integracji.<\/p>\n<p>Przed startem warto te\u017c sprawdzi\u0107 ustawienia powiadomie\u0144 w Panelu Akceptanta. Tpay zaleca w\u0142\u0105czenie opcji pozwalaj\u0105cej na nadpisywanie adresu URL powiadomie\u0144, poniewa\u017c jest to potrzebne do poprawnego odbioru status\u00f3w transakcji przez modu\u0142 Magento.<\/p>\n<div id=\"dhost-3225719248\" class=\"dhost-inpost dhost-entity-placement\"><a href=\"https:\/\/dhosting.pl\/opieka-stron.html?utm_source=pomoc&utm_medium=artykul&utm_campaign=pomoc\" target=\"_blank\">\r\n\t<img decoding=\"async\" src=\"https:\/\/dhosting.pl\/pomoc\/wp-content\/uploads\/2025\/01\/baner-opieka.png\" alt=\"opieka stron www\">\r\n<\/a>\r\n<br \/>\r\n<br \/><\/div><h2><span class=\"ez-toc-section\" id=\"Instalacja_modulu\"><\/span>Instalacja modu\u0142u<span class=\"ez-toc-section-end\"><\/span><\/h2>\n<p>Instalacja odbywa si\u0119 po stronie serwera i wymaga u\u017cycia Composera. Najpierw doinstalowujesz biblioteki Tpay PHP oraz Tpay Open API PHP, potem sam modu\u0142 Magento 2 Basic, a nast\u0119pnie uruchamiasz modu\u0142 komendami Magento odpowiedzialnymi za aktywacj\u0119, aktualizacj\u0119, kompilacj\u0119 i wdro\u017cenie statycznych plik\u00f3w.<\/p>\n<p>Po zako\u0144czeniu instalacji logujesz si\u0119 do panelu Magento i przechodzisz do ustawie\u0144 p\u0142atno\u015bci. W\u0142a\u015bnie tam aktywujesz modu\u0142 i wybierasz spos\u00f3b dzia\u0142ania p\u0142atno\u015bci zgodny z potrzebami sklepu, na przyk\u0142ad szybkie przelewy online, p\u0142atno\u015bci kart\u0105 przez panel Tpay albo wariant on-site.<\/p>\n<h2><span class=\"ez-toc-section\" id=\"Konfiguracja_platnosci\"><\/span>Konfiguracja p\u0142atno\u015bci<span class=\"ez-toc-section-end\"><\/span><\/h2>\n<p>W ustawieniach g\u0142\u00f3wnych modu\u0142u wpisujesz ID sprzedawcy oraz kod bezpiecze\u0144stwa z Panelu Akceptanta Tpay. ID sprzedawcy to identyfikator nadany przy rejestracji, a kod bezpiecze\u0144stwa znajdziesz w sekcji Ustawienia, Powiadomienia i Bezpiecze\u0144stwo.<\/p>\n<p>Je\u017celi korzystasz z p\u0142atno\u015bci standardowych przez Open API, musisz dodatkowo uzupe\u0142ni\u0107 Client ID i Secret z sekcji Integracja, API i Klucze do nowego Open API. W przypadku konfiguracji Origin API albo p\u0142atno\u015bci kartowych on-site potrzebne b\u0119d\u0105 z kolei klucz API i has\u0142o API ze starego API.<\/p>\n<h2><span class=\"ez-toc-section\" id=\"Dodatkowe_mozliwosci\"><\/span>Dodatkowe mo\u017cliwo\u015bci<span class=\"ez-toc-section-end\"><\/span><\/h2>\n<p>Tpay udost\u0119pnia w Magento 2 tak\u017ce obs\u0142ug\u0119 wielu walut, ale dla walut innych ni\u017c PLN jest ona realizowana przez p\u0142atno\u015bci kartowe z u\u017cyciem Origin API i wymaga osobnego konta Tpay obs\u0142uguj\u0105cego dan\u0105 walut\u0119 oraz aktywnej funkcji Multistore w Magento.<\/p>\n<p>Modu\u0142 wspiera r\u00f3wnie\u017c realizacj\u0119 zwrot\u00f3w z poziomu Magento przez sekcj\u0119 Sales, Invoices i opcj\u0119 Credit memo, ale dzia\u0142a to tylko przy poprawnie skonfigurowanym module. Dlatego najpierw warto doprowadzi\u0107 do pe\u0142nej poprawno\u015bci podstawowej integracji, a dopiero p\u00f3\u017aniej uruchamia\u0107 funkcje dodatkowe.<\/p>\n","protected":false},"author":6,"featured_media":10957,"parent":0,"menu_order":0,"template":"","format":"standard","manualknowledgebasecat":[7280,7281],"manual_kb_tag":[7308,7310,7305,7293,145,7304,7306,7297,7309,7307,7312,4395,7311],"class_list":["post-16019","manual_kb","type-manual_kb","status-publish","format-standard","has-post-thumbnail","hentry","manualknowledgebasecat-platnosci-on-line","manualknowledgebasecat-tpay","manual_kb_tag-bramka-platnosci-magento","manual_kb_tag-composer-magento","manual_kb_tag-integracja-tpay-magento","manual_kb_tag-konfiguracja-tpay","manual_kb_tag-magento","manual_kb_tag-magento-2","manual_kb_tag-modul-tpay-magento-2","manual_kb_tag-open-api-tpay","manual_kb_tag-origin-api-tpay","manual_kb_tag-platnosci-magento","manual_kb_tag-platnosci-online-magento","manual_kb_tag-tpay","manual_kb_tag-zwroty-magento-tpay"],"_links":{"self":[{"href":"https:\/\/dhosting.pl\/pomoc\/wp-json\/wp\/v2\/manual_kb\/16019","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/dhosting.pl\/pomoc\/wp-json\/wp\/v2\/manual_kb"}],"about":[{"href":"https:\/\/dhosting.pl\/pomoc\/wp-json\/wp\/v2\/types\/manual_kb"}],"author":[{"embeddable":true,"href":"https:\/\/dhosting.pl\/pomoc\/wp-json\/wp\/v2\/users\/6"}],"version-history":[{"count":1,"href":"https:\/\/dhosting.pl\/pomoc\/wp-json\/wp\/v2\/manual_kb\/16019\/revisions"}],"predecessor-version":[{"id":16020,"href":"https:\/\/dhosting.pl\/pomoc\/wp-json\/wp\/v2\/manual_kb\/16019\/revisions\/16020"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/dhosting.pl\/pomoc\/wp-json\/wp\/v2\/media\/10957"}],"wp:attachment":[{"href":"https:\/\/dhosting.pl\/pomoc\/wp-json\/wp\/v2\/media?parent=16019"}],"wp:term":[{"taxonomy":"manualknowledgebasecat","embeddable":true,"href":"https:\/\/dhosting.pl\/pomoc\/wp-json\/wp\/v2\/manualknowledgebasecat?post=16019"},{"taxonomy":"manual_kb_tag","embeddable":true,"href":"https:\/\/dhosting.pl\/pomoc\/wp-json\/wp\/v2\/manual_kb_tag?post=16019"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}