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 przeprowadzona bez użycia terminala PIN.
Aby zainstalować wtyczkę, 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/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% — uprawniony użytkownik systemu operacyjnego, pod którym uruchamiany jest Syrve POS
Instalacja
- Pobierz wtyczkę z https://downloads.syrve.online/plugins/Resto%20AdyenPayment/.
- Utwórz katalog o nazwie Resto.Front.Api.AdyenPaymentPlugin w folderze Syrve POS\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 | |
| KeyVersion | int | |
| HttpTimeoutSec | int | Limit czasu komunikacji z terminalem PIN pad (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-4217PrinterIikointGdzie 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ówModelNamePinPadstringNazwa PIN padaSerialNumberPinPadstringNumer seryjny PIN padaUseUnrefferenceRefundboolWłącz użycie zwrotu bez ReferenceIdReconcilationWithCloseShiftboolWłącz zamykanie zmiany na PIN padzie razem z zamknięciem zmiany na POSEventServiceEnableboolWłą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
EventServiceAddressstringAdres serwera zdarzeńEventServicePortintPort serwera zdarzeńEnableLiveModeboolPrawda - terminal w trybie LiveLiveEndpointUrlPrefixstring
https://docs.adyen.com/development-resources/live-endpoints#page-introduction
EnableTippingboolUwzględnianie napiwku przy płatnościAllowedPaymentBrandsstringWypełnij przecinkiem «,», przykład affirm_pos, alipay
Obecnie dostępne:
affirm_pos: wyświetla kod QR Affirm.
alipay: wyświetla kod QR Alipay.
atome_pos: wyświetla kod QR Atome.
grabpay_pos: wyświetla kod QR GrabPay.
pix: wyświetla kod QR PIX.
swish: wyświetla kod QR Swish.
twint_pos: wyświetla kod QR TWINT.
wechatpay_pos: wyświetla kod QR WeChat Pay.
zip_pos: wyświetla kod QR Zip.
- 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.