Jedno API, trzy grupy metod
tpay to polski operator płatności online. Integracja korzysta z jego aktualnego interfejsu, Merchant Open API, w którym platforma uwierzytelnia się parą kluczy w standardzie OAuth 2.0. Przez to jedno połączenie przechodzą wszystkie obsługiwane metody:
- BLIK, także w wariancie BLIK One Click,
- karty płatnicze, z możliwością zapisania karty na kolejne zakupy,
- przelewy bankowe z banku kupującego.
Kasę ustawiasz na jeden z dwóch sposobów: z przekierowaniem na stronę płatności tpay albo z formularzem płatności, który zostaje w Twojej kasie.
BLIK: z kodem i bez kodu
W wariancie na stronie sklepu kupujący wpisuje sześciocyfrowy kod z aplikacji banku bezpośrednio w kasie. Kod jest ważny dwie minuty, więc sensownie jest prosić o niego dopiero na ostatnim kroku.
BLIK One Click rozszerza ten wariant o zapamiętanie sklepu. Po udanej płatności kupujący dostaje w aplikacji banku prośbę o potwierdzenie, a kolejne zamówienia zatwierdza już samym powiadomieniem, bez przepisywania kodu. W B2B przydaje się to tam, gdzie ta sama osoba regularnie domawia drobne pozycje i płaci z góry.
Jedna rzecz po stronie operatora, o której warto wiedzieć: kupujący może zapamiętać sklep w więcej niż jednej aplikacji bankowej. tpay nie obciąża wtedy żadnej z nich automatycznie, tylko zwraca listę aplikacji do wyboru. Mechanizm opisuje dokumentacja BLIK w tpay.
Karty i waluta rozliczenia
Zapisana karta oznacza, że powracający kupujący nie wpisuje jej danych od nowa. tpay obsługuje karty Visa i Mastercard.
Dwa ograniczenia operatora mają znaczenie przy sprzedaży hurtowej:
- Waluty inne niż PLN. Według dokumentacji tpay płatności kartą w obcej walucie są dostępne tylko u jednego z agentów rozliczeniowych, z którymi operator współpracuje. Jeśli prowadzisz kanał eksportowy w EUR, sprawdź to w umowie przed startem.
- PCI DSS. Formularz karty osadzony we własnej kasie nie zwalnia sprzedawcy z wymagań standardu. tpay zaleca zacząć od kwestionariusza samooceny.
Co dzieje się po płatności
O wyniku transakcji tpay informuje powiadomieniem wysyłanym na adres sklepu. Każde powiadomienie niesie podpis JWS, a moduł weryfikuje go, zanim zmieni status zamówienia. Adres powiadomień jest publiczny i tpay nie udostępnia listy adresów IP do filtrowania, więc podpis jest jedynym zabezpieczeniem przed sfałszowanym „opłacono”.
Gdy sklep nie potwierdzi odbioru, tpay ponawia powiadomienie wielokrotnie, w rosnących odstępach, przez ponad dobę. Krótka przerwa w działaniu sklepu nie oznacza więc utraconej płatności. Szczegóły są w dokumentacji powiadomień tpay.
Po stronie platformy:
- dla metody płatności ustawiasz, jaki status dostaje zamówienie w trakcie płatności, po jej powodzeniu i po niepowodzeniu,
- kupujący może ponowić nieudaną płatność z poziomu zamówienia, bez składania go od nowa,
- administrator widzi przy zamówieniu historię prób płatności i również może ją ponowić,
- platforma emituje zdarzenia rozliczenia, niepowodzenia i zwrotu płatności, które da się przekazać webhookiem do ERP albo systemu księgowego.
Zwroty wychodzą z reklamacji
Zwrotu nie zlecasz w panelu tpay. Wychodzi z modułu reklamacji, gdy rozliczasz zgłoszenie zwrotem pieniędzy, więc towar i pieniądze mają jeden wspólny rekord. Kwota dla pozycji domyślnie odpowiada temu, co kupujący zapłacił za zwracaną ilość, i nie może tego przekroczyć.
Dwa praktyczne zastrzeżenia:
- tpay realizuje zwrot ze środków na koncie sprzedawcy. Saldo musi pokryć kwotę zwrotu wraz z opłatą operatora, inaczej zlecenie się nie powiedzie.
- Jeśli moduł tpay jest wyłączony, rozliczenie reklamacji zwrotem zostaje odrzucone, a zgłoszenie zachowuje status do czasu ponownego włączenia modułu. Wymiana i naprawa działają bez zmian.
Przed uruchomieniem
- Zarejestrowane i zweryfikowane konto sprzedawcy w tpay.
- Klucze Open API wygenerowane w Panelu Akceptanta (Integracja, potem API). Sekret jest widoczny tylko raz, przy tworzeniu klucza.
- Włączone płatności kartą na koncie, jeśli chcesz je przyjmować.
- Testy w środowisku sandbox tpay, które ma własne certyfikaty do podpisu powiadomień.
Klucze wpisujesz w panelu administracyjnym platformy. Pola tajne są szyfrowane w spoczynku i nie da się ich odczytać z powrotem przez API.
Komu pokazać tpay w kasie
Bramka online rzadko jest w hurcie domyślnym sposobem płatności. Stali odbiorcy płacą przelewem z terminem albo w ciężar limitu kupieckiego, a oba sposoby są częścią otwartego rdzenia. Moduł tpay, podobnie jak inne bramki płatności online, jest modułem płatnym.
Metody płatności przypisujesz do kanałów sprzedaży i do konkretnych organizacji. tpay może więc być widoczny w kanale detalicznym oraz dla nowych klientów bez limitu, a ukryty dla odbiorców kontraktowych.
Płacisz stawkę tpay i nic ponad to: Endora nie dolicza własnej marży pośrednika. Wybór między tpay a PayU zależy zwykle od tego, z kim masz już umowę. Stripe pasuje lepiej, gdy płacą głównie klienci zagraniczni. Jeśli sprzedajesz wyłącznie na fakturę, zacznij od KSeF, a resztę znajdziesz w katalogu integracji.