Adyen
Przegląd
Wtyczka Resto.Front.Api.AdyenPaymentPlugin łączy Syrve POS z terminalami PIN Adyen. Wtyczka stale monitoruje status terminala PIN.
Jeśli połączenie między terminalem PIN a POS zostanie utracone podczas powtarzania płatności, wtyczka automatycznie zakończy poprzednią nieudaną transakcję na podstawie ostatniego statusu terminala PIN. Jeśli transakcja zostanie pomyślnie zakończona na terminalu PIN, ale nie na POS, zostanie ona przeprowadzona bez użycia terminala PIN.
Aby zainstalować wtyczkę, Twoja wersja Syrve musi wynosić co najmniej 8.0, a wersja API — v8p1.
Zanim zaczniesz
Zanim zaczniesz, przeczytaj proszę następujące przewodniki użytkownika i dokonaj odpowiednich ustawień:
- https://docs.adyen.com/point-of-sale/choose-your-architecture/local#protect-communications
- https://docs.adyen.com/point-of-sale/choose-your-architecture/local?tab=windows_environment_2#install-root-cert
Jeśli używasz serwera zdarzeń wtyczki, uruchom okno konsoli w trybie administratora i wykonaj następujące polecenie:
netsh http add urlacl url=http://+:%PORT%/ user=%USER%
gdzie
%PORT% — port serwera zdarzeń (EventServicePort) oraz
%USER% — uprawniona nazwa użytkownika systemu operacyjnego, pod którą uruchamiany jest Syrve POS
Instalacja
Utwórz katalog o nazwie Resto.Front.Api.AdyenPaymentPlugin w folderze [Syrve POSFront]\Plugins. Przenieś wszystkie pliki archiwum do tego folderu.
Konfiguracja
Aby skonfigurować wtyczkę, otwórz plik AdyenPaymentPlugin.dll.config i dokonaj następujących ustawień:
| Parametr | Wartość | Opis |
|---|---|---|
| DebugMode | boolean | (True/False)Włączenie trybu debugowania wtyczki płatności (wymagane tylko podczas testów lub w przypadku awarii bądź nieprawidłowego działania |
| TerminalIpAddress | string | Adres IP terminala PIN pad |
| TerminalPort | int | Port terminala |
| MerchantAccount | string | https://docs.adyen.com/point-of-sale/determine-account-structure#request-merchant-accounts |
| KeyIdentifier | string | |
| KeyPassphrase | string | https://docs.adyen.com/point-of-sale/choose-your-architecture/local?tab=general_instructions_1#set-up-shared-key |
| KeyVersion | int | |
| HttpTimeoutSec | int | Limit czasu komunikacji z PIN pad (zalecana wartość 120) https://docs.adyen.com/point-of-sale/choose-your-architecture/local#build-payment-flow |
| Currency | 3-znakowy kod waluty w formacie ISO-4217 | |
| PrinterIiko | int | Gdzie drukować paragon z PIN padKod Opis-1 Drukuj na wirtualnej drukarce paragonów (do testów)0 Brak druku 1 Do drukarki paragonów 2 Do drukarki rachunków 3 Do drukarki raportów |
| ModelNamePinPad | string | Nazwa PIN pad |
| SerialNumberPinPad | string | Numer seryjny PIN pad |
| UseUnrefferenceRefund | bool | Włącz użycie zwrotu bez ReferenceId |
| ReconcilationWithCloseShift | bool | Włącz zamykanie zmiany na PIN pad wraz z zamknięciem zmiany na POS |
| EventServiceEnable | bool | Włącz usługę odbierania zdarzeń z PIN pad w wtyczce. Więcej szczegółów: https://docs.adyen.com/point-of-sale/notifications/display-notifications |
| EventServiceAddress | string | Adres serwera zdarzeń |
| EventServicePort | int | Port serwera zdarzeń |
| EnableLiveMode | bool | True - terminal w trybie produkcyjnym (Live) |
| LiveEndpointUrlPrefix | string | https://docs.adyen.com/development-resources/live-endpoints#page-introduction |
| EnableTipping | bool | Uwzględnianie napiwku podczas płatności |
| AllowedPaymentBrands | string | Wypełnij za pomocą «,», przykład affirm_pos, alipay Obecnie dostępne: affirm_pos: wyświetla kod QR Affirm. |
- Uruchom Syrve POS.
- Uruchom Syrve Office.
- Skonfiguruj system płatności.
- Po uruchomieniu zostanie załadowany typ płatności „Płatność CCV”.
- Przejdź do Syrve Office > Sprzedaż detaliczna > Typy płatności i kliknij Dodaj.
- Skonfiguruj typ płatności „Płatność Adyen” jako płatność zewnętrzną. Typ płatności musi być fiskalny.