Integracje POS

Strona ustawień Integracje łączy uprawniony serwer HandyCafe z terminalem Ödeal D2D. Dostępność jest sprawdzana przez HandyCafe Cloud. Menu i strona są całkowicie ukryte, gdy kafejka nie ma prawa korzystać z Ödeal.

Zanim zaczniesz

Potrzebujesz aktywnej subskrypcji HandyCafe Cloud, klucza sprzedawcy Ödeal oraz klucza tajnego Ödeal. Musisz też utworzyć terminal w obszarze Cihazlarım w Ödeal. Dokładna nazwa nadana temu terminalowi jest jego wartością externalDeviceKey. Zacznij od środowiska Stage. Przejdź na środowisko produkcyjne dopiero po zatwierdzeniu przez Ödeal produkcyjnych danych uwierzytelniających oraz konfiguracji wywołań zwrotnych.

Konfiguracja Ödeal

1. Otwórz Ustawienia i wybierz Integracje.
2. W sekcji Konto Ödeal wpisz klucz sprzedawcy i klucz tajny otrzymane od Ödeal. HandyCafe wysyła te wartości bezpośrednio do HandyCafe Cloud. Są tam szyfrowane, nie są zapisywane w lokalnej bazie danych ani ponownie wyświetlane.
3. Wybierz Test połączenia. Gdy podano nowe klucze, HandyCafe zapisuje je bezpiecznie przed sprawdzeniem połączenia z API Ödeal. Ten test weryfikuje wyłącznie konto Ödeal. Nie dowodzi, że terminal jest sparowany albo online.
4. Dodaj terminal. Wpisz czytelną lokalną nazwę urządzenia. W polu Nazwa urządzenia Ödeal (externalDeviceKey) wpisz dokładną nazwę urządzenia utworzoną w Ödeal. Następnie podaj opcjonalny PaxID, środowisko, czas oczekiwania na płatność, miasto klienta, dzielnicę klienta, stawkę VAT dla sesji oraz stawkę VAT dla zamówień.
5. Włącz opcję Integracja POS aktywna i wybierz Zapisz.
6. Wykonaj w środowisku Stage jeden paragon gotówkowy i jedną płatność kartą, aby sprawdzić sparowanie terminala oraz obie ścieżki rozliczenia.

W tej wersji obsługiwany jest tylko jeden aktywny terminal Ödeal na serwer. Zapobiega to skierowaniu płatności na niewłaściwy terminal, zanim pojawi się wybór terminala po stronie kasjera.

HandyCafe zapisuje listę terminali lokalnie, zanim Cloud zweryfikuje nową parę danych uwierzytelniających. Odrzucenie danych uwierzytelniających przez Ödeal nie kasuje nazwy terminala ani pól parowania. Terminal, który wymaga nowych danych uwierzytelniających, jest zapisywany jako nieaktywny do czasu ich weryfikacji dla wybranego środowiska.

Strona Integracje odczytuje listę terminali bezpośrednio z lokalnej bazy SQLite i wyświetla ją bez czekania na Cloud. Żądania do Cloud są potrzebne jedynie do sprawdzenia statusu zaszyfrowanych danych uwierzytelniających oraz zdalnego uprawnienia dostawcy.

Jeśli Ödeal odrzuci konfigurację, HandyCafe wyświetla zwrócone przez Ödeal wyjaśnienie. Odpowiedź o nieznalezieniu profilu organizacji oznacza, że para klucza sprzedawcy i klucza tajnego nie należy do żadnej organizacji w wybranym środowisku (Stage lub produkcyjnym).

Zachowanie płatności

Gdy aktywna metoda płatności to gotówka albo karta, zamknięcie sesji komputerowej, zamknięcie sesji konsolowej oraz zamknięcie samodzielnego zamówienia wysyłają do Ödeal idempotentny koszyk. Gotówka jest wysyłana jako udokumentowana przez Ödeal opcja płatności CASH. Terminal rejestruje płatność gotówkową i drukuje paragon fiskalny lub paragon e-Archive bez otwierania ekranu pobierania płatności kartą. Karta jest wysyłana jako CREDITCARD, a HandyCafe czeka na wynik wywołania zwrotnego, podczas gdy klient finalizuje płatność na terminalu. Rozliczenie zawierające jednocześnie gotówkę i kartę wysyła obie opcje płatności z odpowiadającymi im kwotami.

Klient może wybrać na terminalu opcję ratalną, jeśli pozwala na to karta oraz umowa z operatorem. HandyCafe zapisuje zgłoszoną liczbę rat przy lokalnej sprzedaży. Lokalna sprzedaż jest zatwierdzana dopiero po potwierdzeniu transakcji przez Ödeal. Jeśli lokalne zatwierdzenie nie powiedzie się po tym potwierdzeniu, HandyCafe żąda anulowania tego samego dnia. Nieudane anulowanie powoduje błąd wymagający ręcznego uzgodnienia i musi zostać sprawdzone w raporcie transakcji Ödeal. Metody płatności inne niż gotówka i karta są nadal obsługiwane przez dotychczasowy proces rozliczeniowy HandyCafe.

Testy i operacje na terminalu

Test połączenia weryfikuje wyłącznie dane uwierzytelniające sprzedawcy Ödeal oraz dostęp do API. Nie drukuje paragonu, nie obciąża karty i nie dowodzi, że externalDeviceKey jest sparowany z terminalem.

Dostarczona dokumentacja API D2D nie definiuje osobnych punktów końcowych Wydruk paragonu testowego ani Testowe obciążenie. Testy akceptacyjne wykonuje się na zwykłych koszykach w środowisku Stage: wyślij koszyk gotówkowy i sprawdź wydrukowany paragon, a następnie wyślij koszyk kartowy i zrealizuj na terminalu transakcję jednorazową albo ratalną. Używaj wyłącznie danych testowych kart udostępnionych przez Ödeal.

Przypadki akceptacyjne Ödeal obejmują zamknięcie dnia oraz ponowny wydruk ostatniego paragonu, ale są to operacje wykonywane na terminalu. D2D nie dokumentuje dla nich zdalnych wywołań API, dlatego HandyCafe nie udostępnia ich jako zdalnych przycisków.

Zdalne włączanie i wyłączanie

Administratorzy HandyCafe sterują Ödeal z sekcji Admin > Ustawienia administratora > Dostawcy POS w Dashboardzie. Przełącznik globalny jest nadrzędny wobec pozostałych ustawień. Ustawienia domyślne krajów używają dwuliterowych kodów ISO, takich jak TR. Ustawienia kafejki mogą jawnie otworzyć albo zamknąć Ödeal dla jednej licencji. Decyzja dla konkretnej kafejki ma pierwszeństwo przed ustawieniem domyślnym kraju. Zresetowanie decyzji kafejki sprawia, że ponownie podąża ona za ustawieniem swojego kraju.

Kolejność decyzji to przełącznik globalny, decyzja dla kafejki, a następnie ustawienie domyślne kraju. Wyłączony przełącznik globalny zamyka Ödeal dla każdej kafejki. Jawne zamknięcie dla kafejki ukrywa stronę nawet wtedy, gdy jej kraj jest otwarty. Jawne otwarcie dla kafejki udostępnia stronę nawet wtedy, gdy jej kraju nie ma na liście domyślnej. Wyłączenie dostępu natychmiast blokuje tworzenie nowych koszyków. Istniejące oczekujące transakcje można nadal sprawdzić albo anulować, więc trwająca płatność nie zostaje porzucona.

Serwer sprawdza dostępność przez HandyCafe Cloud i buforuje ostatnią poprawnie zweryfikowaną decyzję dla kraju lub kafejki. Katalog dostawców zwraca HTTP 200 wraz z ustrukturyzowanym polem error.code, gdy jego dane uwierzytelniające są nieprawidłowe. Aplikacja na komputerze obsługuje taką odpowiedź, odświeżając dane uwierzytelniające i ponawiając próbę. Chwilowy błąd uwierzytelnienia albo sieci nie zmienia interpretacji włączonej decyzji administratora na wyłączoną, dzięki czemu menu Integracje pozostaje stabilne. Późniejsza poprawna odpowiedź natychmiast aktualizuje bufor, również w przypadku decyzji administratora o wyłączeniu. Gdy nie ma wcześniej zweryfikowanej decyzji, nieznany kraj kafejki, nieaktywna subskrypcja albo wyłączony dostawca powodują, że strona pozostaje ukryta. Nowe operacje Ödeal są zawsze autoryzowane ponownie przez Cloud, nawet gdy korzysta się z buforowanej widoczności. Gdy zsynchronizowany profil kafejki nie ma kraju, używany jest kraj zapisany na licencji.

Bezpieczeństwo i odzyskiwanie

Dane uwierzytelniające Ödeal są szyfrowane w HandyCafe Cloud kluczem sejfu wdrożenia. Żądania wywołań zwrotnych są uwierzytelniane skonfigurowanym kluczem żądania albo nagłówkami klucza sprzedawcy i klucza tajnego Ödeal. Kody referencyjne koszyka są stałe dla każdego zamówienia lub sesji. Powtórzenie tego samego rozliczenia nie tworzy drugiego obciążenia.

Anulowanie w Ödeal jest dostępne wyłącznie zgodnie z zasadami tego samego dnia, przed zamknięciem partii na terminalu. Oczekujący koszyk można usunąć osobno, zanim płatność zostanie zakończona. Ödeal D2D nie udostępnia ogólnej operacji zwrotu. Gdy okno anulowania minęło, skorzystaj z zaplecza Ödeal oraz raportu transakcji.

Ödeal D2D nie udostępnia udokumentowanej zdalnej operacji raportu Z ani zamknięcia dnia. Zamknięcie dnia wykonaj na terminalu. HandyCafe może odczytywać raporty transakcji na potrzeby uzgodnień i rejestruje wywołania zwrotne payback z Ödeal.