Adyen
Przegląd
Wtyczka Resto.Front.Api.AdyenPaymentPlugin łączy Syrve POS z terminalami PIN Adyen. Wtyczka ciągle 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
Przed rozpoczęciem prosimy o zapoznanie się z następującymi przewodnikami użytkownika i dokonanie 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% — uprawniona 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 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 | (Prawda/Fałsz)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 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-4217PrinterIikointGdzie wydrukować paragon z PIN pada Opis kodu-1 Drukuj na wirtualnej drukarce paragonów (do testów)0 Brak wydruku 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ńEnableLiveModeboolTrue - terminal w trybie LiveLiveEndpointUrlPrefixstring
https://docs.adyen.com/development-resources/live-endpoints#page-introduction
EnableTippingboolUwzględnianie napiwku przy płatnościAllowedPaymentBrandsstringWypełnij przecinkami «,», przykład affirm_pos, alipay
Aktualnie 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.