Adyen
Przegląd
Wtyczka Resto.Front.Api.AdyenPaymentPlugin łączy Syrve POS z terminalami Adyen PIN. Wtyczka stale monitoruje status terminala PIN.
Jeśli połączenie między terminalem PIN a POS zostanie utracone podczas ponownej 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 przeprowadzona bez użycia terminala PIN.
Aby zainstalować wtyczkę, Twoja wersja Syrve musi być co najmniej 8.0, a wersja API — v8p1.
Zanim zaczniesz
Zanim zaczniesz, przeczytaj następujące przewodniki użytkownika i dokonaj odpowiednich ustawień:
- https://docs.adyen.com/point-of-sale/design-your-integration/choose-your-architecture/local#protect-communications
- https://docs.adyen.com/point-of-sale/design-your-integration/choose-your-architecture/local#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% — autoryzowana nazwa użytkownika systemu operacyjnego, pod którą uruchamiany jest Syrve POS
Instalacja
- Pobierz wtyczkę z https://downloads.syrve.online/plugins/Resto%20AdyenPayment/.
- Utwórz katalog i nazwij go Resto.Front.Api.AdyenPaymentPlugin w folderze Syrve POS\Plugins. Przenieś wszystkie pliki archiwum do tego folderu.
Konfiguracja
Aby skonfigurować wtyczkę, otwórz 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 lub nieprawidłowego działania |
| TerminalIpAddress | string | Adres IP PIN pada |
| TerminalPort | int | Port terminala |
| MerchantAccount | string | https://docs.adyen.com/point-of-sale/determine-account-structure#request-merchant-accounts |
| KeyIdentifier | string | |
| KeyPassphrase | string | |
| KeyVersion | int | |
| HttpTimeoutSec | int | Limit czasu komunikacji z PIN padem (zalecana wartość 120)
https://docs.adyen.com/point-of-sale/design-your-integration/choose-your-architecture/local#build-payment-flow |
| Waluta | 3-znakowy kod waluty w formacie ISO-4217 | |
| PrinterIiko | int | Gdzie wydrukować paragon z PIN padaOpis kodu-1 Drukuj na wirtualnej drukarce paragonów (do testów)0 Brak wydruku1 Na drukarce paragonów2 Na drukarce rachunków3 Na drukarce raportów |
| ModelNamePinPad | string | Nazwa PIN pada |
| SerialNumberPinPad | string | Numer seryjny PIN pada |
| UseUnrefferenceRefund | bool | Włącz użycie zwrotu bez ReferenceId |
| ReconcilationWithCloseShift | bool | Włącz zamykanie zmiany na PIN padzie razem z zamykaniem zmiany w POS |
| EventServiceEnable | bool | Włącz usługę odbierania zdarzeń z PIN pada w wtyczce.Więcej szczegółów: https://docs.adyen.com/point-of-sale/design-your-integration/notifications/display-notifications |
| EventServiceAddress | string | Adres serwera zdarzeń |
| EventServicePort | int | Port serwera zdarzeń |
| EnableLiveMode | bool | True - terminal w trybie Live |
| LiveEndpointUrlPrefix | string | https://docs.adyen.com/development-resources/live-endpoints#page-introduction |
| EnableTipping | bool | Uwzględnienie napiwku przy płatności |
| AllowedPaymentBrands | string | Wypełnij za pomocą «,», przykład affirm_pos, alipay Obecnie dostępne: affirm_pos: pokazuje kod QR Affirm. |
- Uruchom Syrve POS.
- Uruchom Syrve Office.
- Skonfiguruj system płatności.
- Po uruchomieniu zostanie załadowany typ płatności „CCV Payment”.
- Przejdź do Syrve Office > Sprzedaż detaliczna > Typy płatności i kliknij Dodaj.
- Skonfiguruj typ płatności „Adyen Payment” jako płatność zewnętrzną. Typ płatności musi być fiskalny.