Adyen
Przegląd
Wtyczka Resto.Front.Api.AdyenPaymentPlugin łączy Syrve POS z terminalami PIN Adyen. Wtyczka nieustannie 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 być 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/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 korzystasz z 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
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ń:
https://docs.adyen.com/point-of-sale/design-your-integration/choose-your-architecture/local#build-payment-flow
| 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 | |
| KeyVersion | int | |
| HttpTimeoutSec | int | Limit czasu komunikacji z terminalem PIN pad (zalecana wartość 120) |
| Waluta | 3-znakowy kod waluty w formacie ISO-4217 | |
| PrinterIiko | int | Gdzie wydrukować paragon z PIN pada Opis kodu-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 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 zamknięciem 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 | Prawda - terminal w trybie Live |
| LiveEndpointUrlPrefix | string | https://docs.adyen.com/development-resources/live-endpoints#page-introduction |
| EnableTipping | bool | Uwzględnianie napiwku przy 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.