Nowość w Endora Commerce: wbudowany CRM z szansami sprzedażowymi Zobacz →
Endora Commerce

Integracja z tpay

Moduł tpay łączy kasę Endora Commerce z Merchant Open API operatora: kupujący płaci BLIK-iem, kartą albo przelewem z własnego banku, na stronie tpay lub bez wychodzenia z Twojej kasy.

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

  1. Zarejestrowane i zweryfikowane konto sprzedawcy w tpay.
  2. Klucze Open API wygenerowane w Panelu Akceptanta (Integracja, potem API). Sekret jest widoczny tylko raz, przy tworzeniu klucza.
  3. Włączone płatności kartą na koncie, jeśli chcesz je przyjmować.
  4. 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.

Sprawdźmy, co da się podłączyć u Ciebie

Umów bezpłatną konsultację. Przejdziemy przez Twój ERP, magazyn i procesy sprzedaży, i pokażemy, jak wygląda ścieżka integracji krok po kroku.

Michał Zabielski, założyciel i CEO Endory

Michał Zabielski

Założyciel i CEO Endory

Odpowiadamy w ciągu jednego dnia roboczego.