HandyCafe Docs
owner it-admin

Dostawcy płatności

Dostawcy płatności to zewnętrzne usługi, którym HandyCafe przekazuje sprzedaż w punkcie sprzedaży. Dostawca fiskalny wystawia paragon zgodny z przepisami, a w niektórych krajach także obciąża kartę na własnym terminalu. Dostawca płatności przyjmuje od członków płatności online kartą i portfelem cyfrowym.

Wszystkich dostawców konfiguruje się w jednym miejscu: Ustawienia > Metody płatności. Strona składa się z kart. Pierwsza karta, Metody, to własna lista metod płatności kafejki. Każda kolejna karta to jeden dostawca.

Ta strona opisuje karty dostawców. Kartę Metody, stawki prowizji i opłaty stałe opisano w Metodach płatności.


Gdzie to znaleźć

  1. Otwórz Ustawienia.
  2. W grupie Przychody wybierz Metody płatności.
  3. Wybierz kartę dostawcy, którego chcesz skonfigurować.

Ustawienia są dostępne tylko dla kasjerów z rolą Administrator.


Które karty są widoczne

Karty dostawców nie są takie same w każdej kafejce. Lista pochodzi z katalogu dostawców HandyCafe Cloud dla Twojej licencji, uzupełnionego o jednego dostawcę dodawanego lokalnie.

Karta Rodzaj Kiedy się pojawia
Ödeal Urządzenie fiskalne z terminalem kart Tylko w kafejkach, na które pozwala katalog w Chmurze. Ödeal działa wyłącznie w Turcji.
Checkbox Kasa fiskalna (ukraińskie PRRO) Gdy krajem w Ustawienia > Ogólne jest Ukraina. Jest dodawana na samym serwerze, więc pozostaje dostępna podczas awarii Chmury.
Stripe Płatności online Oferowana we wszystkich krajach wymienionych w katalogu. Tam, gdzie Stripe nie obsługuje jeszcze Twojego kraju, karta pojawia się z odpowiednim komunikatem.

Jeśli Chmura jest nieosiągalna, HandyCafe nadal pokazuje ostatnią zweryfikowaną listę dostawców. Używana karta nie znika z powodu chwilowego problemu z siecią.

Karta, która zniknie z katalogu (na przykład po zmianie subskrypcji lub kraju), zostaje usunięta z paska kart. Strona wraca wtedy do karty Metody.

Stany kart

Stan Co widać
Oznaczenie Chmura z kłódką Dostawca wymaga aktywnej subskrypcji HandyCafe Cloud. Karta pokazuje Wymaga subskrypcji Chmury i przycisk Wykup subskrypcję Chmury, który otwiera w przeglądarce stronę planów w panelu HandyCafe.
Oznaczenie Niedostępne tutaj Dostawca nie obsługuje jeszcze kafejek w Twoim kraju. Karta pokazuje Jeszcze niedostępne w Twoim kraju. Aktywuje się sama, gdy Twój kraj zostanie obsłużony.
Brak oznaczenia Dostawca jest gotowy do konfiguracji.

Ödeal (Turcja)

Ödeal to terminal fiskalny D2D. Przy płatności HandyCafe wysyła koszyk do terminala. Terminal drukuje paragon fiskalny lub paragon e-Archiwum, a przy płatności kartą obciąża kartę. Oznaczenie regionu i krótki opis u góry karty Ödeal są zawsze wyświetlane po turecku.

Karta składa się z trzech części.

Konto Ödeal

Wpisz Klucz sprzedawcy i Klucz tajny przekazane Twojej firmie przez Ödeal. Oba klucze trzeba wpisać jednocześnie. Po zapisaniu klucze są przechowywane w postaci zaszyfrowanej i nie są już wyświetlane. Sekcja pokazuje Skonfigurowano i zamaskowaną podpowiedź każdego klucza.

Test połączenia sprawdza konto Ödeal i dostęp do API. Nie drukuje paragonu, nie obciąża karty i nie potwierdza, że terminal jest sparowany.

Urządzenia fiskalne

Kliknij Dodaj urządzenie, aby dodać terminal. Na jednym serwerze można dodać tylko jeden terminal Ödeal. Przycisk Dodaj urządzenie jest nieaktywny, gdy terminal już istnieje.

Pole Co wpisać
Nazwa urządzenia Nazwa lokalna, na przykład „Lada 1”.
Nazwa urządzenia Ödeal (externalDeviceKey) Nazwa urządzenia utworzona podczas konfiguracji Ödeal, dokładnie taka jak w Ödeal.
PaxID PaxID terminala, jeśli Ödeal go przekazał.
Środowisko Stage do testów, Production do sprzedaży na żywo.
Czas oczekiwania na wynik płatności (s) Jak długo HandyCafe czeka na zgłoszenie wyniku przez terminal. Od 10 do 600 sekund.
Miasto klienta i Dzielnica klienta Wysyłane razem z paragonem.
Sesja: stawka VAT (%) Stawka VAT za czas sesji. Domyślnie 20.
Zamówienie: stawka VAT (%) Stawka VAT za zamówienia z kafeterii. Domyślnie 20.

Przełącznik w nagłówku urządzenia włącza terminal. Terminal nie może być aktywny bez zapisanych kluczy dla wybranego środowiska. Jeśli włączysz go bez nich, zostanie zapisany jako nieaktywny, o czym poinformuje ostrzeżenie. Zmiana środowiska wymaga ponownego wpisania obu kluczy.

Kliknij Zapisz na dole karty, aby zapisać zmiany. Anuluj je odrzuca.

Nieuzgodnione rozliczenia Ödeal

Pod listą urządzeń sekcja Nieuzgodnione rozliczenia Ödeal wymienia płatności, które Ödeal potwierdził, ale HandyCafe nie mogło ich zapisać ani wycofać. Stanowisko z takim rekordem ma zablokowane nowe płatności kartą. Sprawdź płatność w panelu Ödeal, a następnie użyj opcji Wyczyść ten rekord w wierszu i wpisz Notatkę o rozliczeniu. Wyczyszczenie usuwa blokadę stanowiska.

Przepływ płatności gotówką, kartą i płatności mieszanych przez terminal opisano w Integracjach POS. Ta strona opisuje też zasady zdalnego włączania i wyłączania.


Checkbox (Ukraina)

Checkbox to ukraińska kasa fiskalna w chmurze (PRRO). Podpisuje każdy paragon i rejestruje go w Państwowej Służbie Podatkowej. HandyCafe komunikuje się z Checkbox bezpośrednio z serwera. Klucz licencyjny i dane logowania kasjera pozostają zaszyfrowane na tej maszynie i nigdy nie przechodzą przez HandyCafe Cloud. Checkbox nie wymaga subskrypcji HandyCafe Cloud.

Sam Checkbox nie obciąża kart, robi to terminal POS. Terminale połączone przez AirCheck i przez Desktop PayLink pojawiają się w sekcji Terminal kart w ustawieniach Checkbox. Desktop PayLink musi być uruchomiony. Jeśli działa na innym komputerze, wpisz tam jego adres. Wybierz swój terminal: płatności kartą będą do niego wysyłane, paragon zostanie wystawiony dopiero po obciążeniu karty, a zwroty wrócą przez ten sam terminal. Jeśli terminal odrzuci płatność, paragon nie zostanie wystawiony. Oczekującą płatność anuluje się na samym terminalu. Bez wybranego terminala płatność kartą jest tylko zapisywana na paragonie, więc najpierw obciąż kartę na swoim terminalu.

Dane dostępowe Checkbox

Pole Co wpisać
Klucz licencyjny Jeden klucz licencyjny na kasę, z Twojego konta Checkbox.
Logowanie kasjera Wybierz Login i hasło lub Kod PIN.
Login kasjera i Hasło kasjera Widoczne przy logowaniu loginem i hasłem.
PIN kasjera Widoczny przy logowaniu kodem PIN.

Wartości są tylko do zapisu. Po zapisaniu sekcja pokazuje Skonfigurowano oraz zamaskowane podpowiedzi zapisanej licencji i kasjera.

Test połączenia zapisuje nowe dane dostępowe, loguje kasjera i wczytuje stawki podatkowe z Twojej organizacji w Checkbox. Po powodzeniu pokazuje imię kasjera i numer fiskalny kasy. Jeśli kasjer jest poprawny, ale służba podatkowa nie odpowiada, ostrzeżenie informuje, że paragonów nie da się zarejestrować, dopóki nie będzie ona osiągalna.

Zmiana

Checkbox odrzuca sprzedaż, gdy zmiana jest zamknięta. HandyCafe samo otwiera zmianę przy pierwszej sprzedaży danego dnia. Możesz też zarządzać nią ręcznie:

  • Otwórz zmianę otwiera zmianę od razu.
  • Zamknij zmianę przesyła raport Z do służby podatkowej. Zostaniesz poproszony o potwierdzenie, ponieważ tej operacji nie można cofnąć.
  • Odśwież ponownie wczytuje stan zmiany.

Sekcja pokazuje też liczbę Pozostałe numery fiskalne offline. Liczba zmienia kolor na bursztynowy, gdy zostaje ich mniej niż 10.

Autotest kasy

Autotest prosi kasę o udowodnienie, że działa, zanim otworzysz lokal. Dopóki test nie przejdzie, pierwszy prawdziwy paragon jest wstrzymywany.

  • Uruchom autotest sprawdza logowanie kasjera, kasę, tabelę stawek podatkowych, służbę podatkową, kody paragonów offline i zmianę. Nie wystawia żadnych dokumentów.
  • Przetestuj też paragon wykonuje te same kontrole, a następnie wystawia prawdziwy paragon na 1 UAH w Twoich księgach i go zwraca. Najpierw zostaniesz poproszony o potwierdzenie.

Każdy krok pokazuje, czy przeszedł, nie powiódł się, czy został pominięty. Gdy kasa przejdzie test, sekcja pokazuje Ta kasa jest gotowa do wystawiania paragonów.

Kasy fiskalne

Kliknij Dodaj kasę, aby dodać kasę. Można dodać tylko jedną kasę Checkbox. Nadaj jej nazwę i wybierz:

  • Stawka VAT za czas sesji
  • Stawka VAT za jedzenie i napoje

Obie listy pochodzą z Twojej organizacji w Checkbox. Pozostają nieaktywne, dopóki Test połączenia ich nie wczyta. Pierwszą opcją jest zawsze Nie podlega VAT.

Przełącznik w nagłówku kasy ją włącza. Kasy nie można włączyć przed zapisaniem danych dostępowych. Kliknij Zapisz na dole karty, aby zapisać zmiany.


Stripe (płatności online)

Karta Stripe łączy Stripe przez HandyCafe, aby członkowie mogli płacić kartą, portfelem cyfrowym i lokalnymi metodami płatności. Wypłaty trafiają na Twoje konto bankowe zgodnie z harmonogramem Stripe. HandyCafe pobiera niewielką prowizję platformy od każdej transakcji.

Konfiguracja Stripe nie odbywa się w aplikacji desktopowej. Kliknij Połącz Stripe. W przeglądarce otworzy się strona płatności w panelu HandyCafe, gdzie dokończysz bezpieczną konfigurację Stripe. W HandyCafe nie wpisuje się żadnych danych kart ani sekretów Stripe.

Karta Stripe wymaga aktywnej subskrypcji HandyCafe Cloud. Bez niej pokazuje komunikat Wymaga subskrypcji Chmury.


Krok po kroku

Konfiguracja terminala Ödeal

  1. Otwórz Ustawienia > Metody płatności i wybierz kartę Ödeal.
  2. Wpisz Klucz sprzedawcy i Klucz tajny.
  3. Kliknij Test połączenia.
  4. Kliknij Dodaj urządzenie i uzupełnij nazwę urządzenia, Nazwa urządzenia Ödeal (externalDeviceKey), Środowisko oraz stawki VAT.
  5. Włącz przełącznik urządzenia.
  6. Kliknij Zapisz.
  7. W środowisku Stage przeprowadź jedną sprzedaż gotówkową i jedną kartą, aby potwierdzić, że terminal jest sparowany.

Konfiguracja kasy Checkbox

  1. Upewnij się, że Ustawienia > Ogólne > Kraj to Ukraina.
  2. Otwórz Ustawienia > Metody płatności i wybierz kartę Checkbox.
  3. Wpisz Klucz licencyjny, wybierz tryb Logowanie kasjera i wpisz dane kasjera.
  4. Kliknij Test połączenia.
  5. Kliknij Dodaj kasę, nadaj jej nazwę i wybierz obie stawki podatkowe.
  6. Włącz przełącznik kasy i kliknij Zapisz.
  7. Kliknij Uruchom autotest i poczekaj, aż wszystkie kroki przejdą.

Połączenie ze Stripe

  1. Otwórz Ustawienia > Metody płatności i wybierz kartę Stripe.
  2. Kliknij Połącz Stripe.
  3. Dokończ konfigurację Stripe w panelu HandyCafe w przeglądarce.

Uprawnienia i wymagania

  • Tylko kasjerzy z rolą Administrator mogą otwierać Ustawienia.
  • Ödeal i Stripe wymagają aktywnej subskrypcji HandyCafe Cloud. Karta Ödeal zależy też od tego, czy Chmura dopuszcza Ödeal w Twojej kafejce.
  • Checkbox nie wymaga subskrypcji Chmury. Wymaga ustawienia Ukrainy jako kraju serwera i własnego konta Checkbox.

Rozwiązywanie problemów

Brakuje oczekiwanej karty dostawcy. Ödeal pojawia się tylko wtedy, gdy katalog w Chmurze dopuszcza go w Twojej kafejce. Checkbox pojawia się tylko wtedy, gdy krajem w Ustawienia > Ogólne jest Ukraina.

Przełącznik terminala lub kasy wyłączył się sam po zapisaniu. Nie zapisano jeszcze dla niego danych dostępowych (dla Ödeal: dla wybranego środowiska). Wpisz dane dostępowe, zapisz, a następnie włącz go ponownie.

Listy stawek podatkowych Checkbox są puste i nieaktywne. Uruchom Test połączenia, aby wczytać stawki podatkowe.

Pierwszy paragon Checkbox został odrzucony. Kasa nie przeszła jeszcze autotestu. Kliknij Uruchom autotest i usuń przyczyny nieudanych kroków.

Przycisk Połącz Stripe nic nie robi. HandyCafe nie mogło otworzyć przeglądarki i wyświetla komunikat. Otwórz panel HandyCafe samodzielnie i przejdź do strony płatności.


Powiązane strony