README_PL.md

Tpay

Biblioteka dla wszystkich metod płatności dostępnych w Tpay.

English version 🇬🇧 wersja angielska

Instalacja

Instalacja poprzez Composer:

composer require tpay-com/tpay-php

Instalacja poprzez Git z SSH:

git clone [email protected]:tpay-com/tpay-php.git

Instalacja poprzez Git z HTTPS:

git clone https://github.com/tpay-com/tpay-php.git

Ręczne pobieranie: https://github.com/tpay-com/tpay-php/archive/master.zip

Konfiguracja

Jedyne, co musisz zrobić, to ustawić dane dostępu do API za pomocą $this-> (zobacz przykłady). Klucze dostępu możesz wygenerować w panelu sprzedawcy Tpay.

Plik loader.php obsługuje ładowanie wszystkich wymaganych klas, więc możesz dołączyć ten plik do dowolnego pliku, który edytujesz. (pamiętaj o poprawnym skonfigurowaniu bieżącej ścieżki roboczej).

Wszystkie metody opisane w dokumentacji Tpay można łatwo wykonać poprzez rozszerzenie wymaganej klasy z katalogu głównego src (zobacz przykłady).

Podstawowe płatności i formularze wyboru banku

Przykłady użycia: podstawowy, formularz HTML wyboru banku, formularz API wyboru banku, formularz BLIK.

API transakcji / tworzenie, odbieranie, zwrot, zgłoszenie

Przykład użycia: utwórz transakcję, zwrot transakcji, zwrot statusu transakcji.

Karta podstawowa / Karta On-Site

Przykłady użycia: podstawowy formularz karty, bramka na stronie karty, konstruktor linków do płatności kartą, bramka karty na stronie z zapisanymi kartami.

Logi

Biblioteka posiada własny system logowania do zapisywania wszystkich potwierdzeń i powiadomień wysyłanych przez serwer Tpay.com, zapytań wychodzących oraz wyjątków. Upewnij się, że katalog src/Logs jest zapisywalny i dodaj regułę do Apache .htaccess lub NGINX, aby zabronić dostępu do tego obszaru z przeglądarki. Pliki logów są tworzone dla każdego dnia oddzielnie w katalogu Logs.

Logowanie jest domyślnie włączone, ale możesz wyłączyć tę funkcję za pomocą:

Logger::disableLogging();

Możesz także ustawić własną ścieżkę logowania za pomocą tego polecenia:

Logger::setLogPath('/my/own/path/Logs/');

Możesz też przekazać własny logger kompatybilny z Psr\Log\LoggerInterface:

Logger::setLogger(new CustomLogger());

Nazwy plików dzienników zostaną przypisane automatycznie.

Niestandardowa ścieżka szablonów

Możesz ustawić własną ścieżkę szablonów, dzięki czemu możesz kopiować i modyfikować pliki szablonów phtml z tej biblioteki.

Util::$customTemplateDirectory = '/my/own/templates/path/';

Język

Obecnie biblioteka obsługuje dwa języki (angielski i polski). Domyślnym językiem jest angielski. Przykład zmiany języka:

// Wszystkie konstruktory klas Tpay ładują klasę Lang
$tpay = new BankSelectionExample();

// Po tej linii wszystkie komunikaty statyczne (etykiety, tytuły przycisków itp.) będą wyświetlane w języku polskim
(new Util())->setLanguage('pl');

// Jeśli chcesz ręcznie uzyskać dostęp do tłumaczeń, użyj:
$language = new Lang();
$language->setLang('pl'); // do ustawienia języka
$language->l('pay'); // aby wyświetlić przetłumaczony klucz

Licencja

Ta biblioteka jest udostępniana na licencji MIT, ale korzysta z zewnętrznych bibliotek, które są rozpowszechniane na ich własnych warunkach (zobacz LICENSE-3RD-PARTY.md).