integracja z płatnościami

Integracja z płatnościami umożliwia automatyczne informowanie klienta o statusie rozliczenia jego zamówienia.

Jak działa integracja systemu z płatnościami

Integracja z płatnościami to połączenie sklepu internetowego, aplikacji lub modułu obsługi zamówień z zewnętrznym operatorem płatności. System sprzedażowy przekazuje operatorowi informacje potrzebne do rozpoczęcia transakcji, na przykład identyfikator zamówienia, kwotę oraz walutę. Operator udostępnia następnie klientowi wybraną metodę zapłaty, taką jak szybki przelew, płatność kartą albo przelew online. Po zakończeniu operacji informacja o jej wyniku musi wrócić do systemu, który utworzył zamówienie.

Najważniejszym elementem takiego połączenia jest jednoznaczne powiązanie płatności z konkretnym zamówieniem. Zwykle wykorzystuje się do tego identyfikator transakcji lub identyfikator zamówienia przekazywany w żądaniu do operatora. Sama zmiana strony wyświetlanej klientowi po zapłacie nie powinna być jedynym źródłem informacji o wyniku operacji. Przeglądarka może zostać zamknięta, utracić połączenie albo nie wrócić do sklepu, dlatego system powinien obsługiwać również techniczne powiadomienie serwer-serwer o zmianie statusu.

Status transakcji i powiadomienia techniczne

Operator płatności może przekazywać statusy opisujące kolejne etapy obsługi transakcji. Przykładowo płatność może być rozpoczęta, oczekiwać na potwierdzenie, zakończona powodzeniem, odrzucona albo anulowana. Konkretne nazwy statusów zależą od dokumentacji danego operatora, dlatego aplikacja nie powinna zakładać, że każdy system używa tych samych wartości. Własny model zamówienia może mapować statusy operatora na lokalne stany, takie jak „oczekuje na płatność”, „opłacone” i „wymaga wyjaśnienia”.

Powiadomienie o transakcji, często nazywane webhookiem lub komunikatem zwrotnym, powinno być sprawdzane przed zapisaniem wyniku w bazie danych. Weryfikacja może obejmować podpis cyfrowy, token autoryzacyjny albo inne zabezpieczenie określone przez operatora. Należy również porównać kwotę, walutę i identyfikator zamówienia z wartościami zapisanymi w systemie. Dzięki temu komunikat dotyczący innej transakcji lub zmodyfikowanych danych nie zostanie omyłkowo uznany za potwierdzenie zapłaty. Po poprawnej walidacji system może zmienić status zamówienia i wysłać klientowi informację o rozliczeniu.

Obsługa błędów, powtórzeń i rozbieżności

Integracja płatnicza musi uwzględniać sytuacje, w których komunikat zostanie dostarczony więcej niż jeden raz. Ponowienie wysyłki może nastąpić po błędzie sieci, przekroczeniu czasu odpowiedzi albo chwilowej niedostępności aplikacji. Z tego powodu obsługa powiadomienia powinna być idempotentna, czyli wielokrotne przetworzenie tego samego komunikatu nie powinno wielokrotnie oznaczać zamówienia jako opłacone ani uruchamiać kilku identycznych działań następczych. Pomocne jest zapisywanie identyfikatora już obsłużonej transakcji i sprawdzanie go przed kolejną aktualizacją.

Trzeba także rozdzielić stan płatności od stanu realizacji zamówienia. Potwierdzenie przyjęcia pieniędzy może oznaczać, że płatność zakończyła się poprawnie, ale nie musi automatycznie oznaczać wydania produktu, wykonania usługi ani zakończenia całego zamówienia. W przypadku przerwanej płatności, zwrotu środków, częściowego rozliczenia lub ręcznej korekty status powinien być zapisany w sposób pozwalający odtworzyć historię zdarzeń. Logi powinny zawierać czas operacji, identyfikator zamówienia, identyfikator transakcji oraz wynik walidacji, bez zapisywania pełnych danych karty płatniczej.

Znaczenie poprawnego działania aplikacji na komputerze

Problemy z integracją płatności mogą wynikać nie tylko z konfiguracji operatora, lecz także z działania urządzenia, przeglądarki lub aplikacji używanej do obsługi zamówień. Nieaktualna przeglądarka, uszkodzona pamięć podręczna, rozszerzenie blokujące przekierowania albo błędy połączenia sieciowego mogą uniemożliwić powrót z bramki płatniczej do sklepu. W takiej sytuacji transakcja może być faktycznie zakończona, mimo że ekran zamówienia nadal pokazuje oczekiwanie na płatność. Weryfikację należy rozpocząć od porównania statusu widocznego w systemie z informacją dostępną u operatora płatności.

Warszawskie Pogotowie Komputerowe zajmuje się profesjonalną naprawą laptopów, komputerów PC oraz ich podzespołów, dlatego w przypadku problemów z działaniem przeglądarki, systemu operacyjnego, sieci lub aplikacji używanej do obsługi płatności można rozpocząć od diagnostyki komputera. Sama zmiana statusu transakcji wymaga jednak sprawdzenia konfiguracji aplikacji i dokumentacji operatora płatności. Prawidłowa diagnoza powinna ustalić, czy przyczyną jest urządzenie użytkownika, lokalne połączenie z internetem, błąd aplikacji, niepoprawne dane zamówienia, czy też problem po stronie zewnętrznego systemu płatniczego.