Download the PHP package sylapi/omnipay-tbibank without Composer
On this page you can find all versions of the php package sylapi/omnipay-tbibank. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download sylapi/omnipay-tbibank
More information about sylapi/omnipay-tbibank
Files in sylapi/omnipay-tbibank
Package omnipay-tbibank
Short Description TBIBank gateway for Omnipay payment processing library
License MIT
Informations about the package omnipay-tbibank
Omnipay: TBIBank
TBIBank eCommerce Platform integration for Omnipay payment processing library
Biblioteka umożliwiająca integrację z platformą kredytową TBI Bank poprzez framework Omnipay. Obsługuje aplikacje kredytowe, callbacki oraz anulowanie zamówień z pełnym szyfrowaniem RSA.
Instalacja
Szybki start
🔄 Przepływ pracy (Flow)
1. Aplikacja kredytowa
Krok 1: Sklep wysyła zaszyfrowane dane aplikacji kredytowej Krok 2: TBI API zwraca URL przekierowania (301/302) Krok 3: Klient kończy aplikację na portalu TBI Krok 4: TBI wysyła callback'a z wynikiem (zatwierdzenie/odrzucenie)
2. Detailowy flow
-
Przygotowanie danych
- Dane zamówienia i klienta
- Szyfrowanie RSA (danych wrażliwych)
- Wysłanie POST do
/Api/LoanApplication/Finalize
-
Odpowiedź TBI
- HTTP 301/302 z URL przekierowania
- Klient trafia na portal TBI Bank
-
Portal TBI
- Weryfikacja tożsamości klienta
- Ocena zdolności kredytowej
- Akceptacja/odrzucenie przez klienta
- Callback
- TBI wywołuje
notifyUrlz rezultatem - Dane są opcjonalnie zaszyfrowane
- Status: approved/rejected/cancelled
- TBI wywołuje
Konfiguracja
Środowisko testowe
Środowisko produkcyjne
💳 Aplikacja kredytowa
Podstawowy przykład
Wymagane parametry
| Parametr | Typ | Opis |
|---|---|---|
amount |
string | Kwota zamówienia (format: "1600.00") |
transactionReference |
string | Unikalny ID zamówienia |
customerFirstName |
string | Imię klienta |
customerLastName |
string | Nazwisko klienta |
customerEmail |
string | Email klienta |
customerPhone |
string | Telefon klienta |
notifyUrl |
string | URL callback'a |
Opcjonalne parametry
| Parametr | Typ | Opis |
|---|---|---|
description |
string | Opis zamówienia |
customerCnp |
string | CNP (Romanian Personal Code) |
billingAddress |
string | Adres rozliczeniowy |
billingCity |
string | Miasto |
billingCounty |
string | Województwo/Kraj |
items |
array | Lista produktów |
📞 Obsługa callback'ów
Callback'i są wysyłane przez TBI po zakończeniu procesu aplikacji kredytowej.
❌ Anulowanie zamówień
Możliwe przed zatwierdzeniem kredytu przez klienta.
🔐 Szyfrowanie RSA
Wbudowany klucz testowy
W trybie testowym używany jest wbudowany klucz publiczny TBI:
Własny klucz produkcyjny
Format kluczy
Klucze muszą być w formacie PEM:
Hasło do klucza prywatnego
Uwaga: Hasło (setPrivateKeyPassword) jest potrzebne TYLKO gdy klucz prywatny został wygenerowany z hasłem ochronnym.
Jeśli twój klucz nie ma hasła, nie ustawiaj setPrivateKeyPassword.
🌐 Endpointy API
Produkcja
- Aplikacja kredytowa:
https://ecommerce.tbibank.ro/Api/LoanApplication/Finalize - Anulowanie zamówienia:
https://ecommerce.tbibank.ro/Api/LoanApplication/CanceledByCustomer
Metody HTTP
- POST - wysłanie aplikacji kredytowej
- POST - anulowanie zamówienia
- POST/GET - callback (ustaw w panelu TBI)
📊 Struktura danych
Dane zamówienia (przed szyfrowaniem)
Odpowiedź TBI (sukces)
Callback data
🧪 Testowanie
Uruchomienie testów
PhpStan (Level 5)
⚠️ Wymagania
- PHP: 8.0+
- PHP Extensions: openssl, curl, json
- Dependencies: omnipay/common ^3.0
🔧 Configuration checklist
Pre-deployment
- [ ] Otrzymaj credentials od TBI Integration Team
- [ ] Skonfiguruj klucze RSA (publiczny/prywatny)
- [ ] Ustaw callback URL w panelu TBI
- [ ] Przetestuj w środowisku testowym
- [ ] Skonfiguruj logowanie błędów
Go-live
- [ ]
setTestMode(false) - [ ] Zmień credentials na produkcyjne
- [ ] Ustaw właściwą ścieżkę do kluczy
- [ ] Skonfiguruj monitoring callback'ów
- [ ] Testuj z prawdziwymi danymi (tylko małe kwoty!)
🆘 Troubleshooting
HTTP 500 Error
- Sprawdź credentials
- Zweryfikuj format danych
- Sprawdź klucz publiczny
HTTP 301/302 to błędny URL
- Skonfiguruj prawidłowy
notifyUrl - Sprawdź konfigurację w panelu TBI
Callback nie działa
- Zweryfikuj endpoint callback'a
- Sprawdź klucz prywatny do odszyfrowywania
- Sprawdź logi serwera
Błędy szyfrowania
- Sprawdź format klucza (PEM)
- Zweryfikuj uprawnienia do plików kluczy
- Testuj z wbudowanym kluczem testowym
📞 Wsparcie
W przypadku problemów technicznych skontaktuj się z:
- GitHub Issues: sylapi/omnipay-tbibank/issues
Licencja
MIT License. Zobacz LICENSE aby uzyskać więcej informacji.