W celu poprawnego skonfigurowania połączenia z systemem płatności VivaWallet należy przejść przez proces instalacji i aktywacji integracji z VivaWallet. Proces ten zawiera się w kilku krokach:
-
Instalacja integracji poprzez przycisk Zainstaluj
-
Konfiguracja integracji poprzez przycisk Konfiguruj

Niezbędne jest podanie adresu email dla konta VivaWallet na które mają trafiać opłaty. Może być to nowe lub istniejące konto VivaWallet.
Jeśli konto jest już połączone z kontem ISV VCN to krok ten należy zastąpić podaniem odpowiednich identyfikatorów MerchantID i ConnectedAccountId w ustawieniach zaawansowanych integracji.
W przeciwnym wypadku identyfikatory automatycznie uzupełnią się po poprawnym połączeniu konta klienckiego z kontem ISV.
-
Dokończenie integracji
Jest to proces onboardingu, czyli połączenia konta klienckiego z kontem ISV. Proces ten odbywa się po stronie VivaWallet. Przycisk Dokończ integrację przekierowuje do odpowiedniego formularza.
W przypadku klienta nieposiadającego konta VivaWallet:
isv_flow_new_vw.mp4
W przypadku klienta, posiadającego konto VivaWallet:
isv_flow_existing_vw.mp4
-
Konfiguracja webhooków.
Webhooki VivaWallet to system automatycznych notyfikacji, które VivaWallet przesyła do VnetLPR. Konfiguracja Webhooków jest odrębna dla każdej instancji VnetLPR, a także dla trybów testowego i produkcyjnego.
Konfiguracja webhooków wymaga, aby do whitelisty adresów ip został dodany adres ip, z którego VivaWallet komunikuje się z VnetLPR. Domyślnie system VnetLPR dopuszcza tylko adresy serwerów VivaWallet.
Jeśli ruch z sieci zewnętrznej dociera do VnetLPR przez proxy. To adres ip tego proxy należy dopisać do whitelisty w Konfiguracji zaawansowanej
-
Konfiguracja kodu źródła płatności
Po stronie konta VivaWallet należy dodać nowe źródło płatności. Kod tego źródła należy podać w formularzu dostępnym pod przyciskiem Zmiana trybu

Pozostawienie pola Kod źródła płatności w panelu klienta pustego spowoduje, że VnetLPR korzystać będzie ze źródła płatności o kodzie Default
-
Konfiguracja zaawansowana
Przycisk Zaawansowane daje możliwość ręcznej zmiany ustawień konfiguracji. Dostępne opcje:
- integracja włączona - możliwość ręcznego włączenia/wyłączenia integracji. Automatyczne włączenie integracji odbywa się po połączeniu konta klienckiego z kontem ISV
- tryb testowy - możliwość ręcznej zmiany trybu działania połączenia z VivaWallet
- Czas na dokonanie płatności - czas przez po jakim link do płatności wygaśnie (w sekundach)
- Czas na dokonanie płatności POS - czas po jakim terminal VivaWallet zwróci komunikat o braku płatności i powróci do stanu wygaszenia
- Typ integracji z VivaWallet - obecnie dostępna tylko wartość isv
- pobieranie prowizji platformy - możliwość włączenia pobierania prowizji przez VnetLPR
- Prowizja platformy (wartość procentowa) - wartość procentowa prowizji pobieranej przez VnetLPR
- Minimalna prowizja platformy (w groszach) - jeśli wartość transakcji VivaWallet wygenerowałaby mniejszą kwotę niż kwota z tego pola, to kwota transakcji zostanie odpowiednio zmodyfikowana
- Identyfikator konta ISV - klucz niezbędny do działania integracji, do pobrania w panelu konta ISV VivaWallet
- Tajny klucz konta ISV - klucz niezbędny do działania integracji, do pobrania w panelu konta ISV VivaWallet
- Email klienta - adres email, na któy zarejestrowane jest konto klienckie VivaWallet
- Identyfikator klienta (MerchantId) - identyfikator konta klienckiego - do pobrania z panelu VivaWallet konta klienckiego lub ustawiany automatycznie podczas łączenia kont
- Identyfikator konta połączonego (AccountId) - stawiany automatycznie podczas łączenia kont
- Klucz dla weryfikacji Webhook - klucz automatycznie ustawiany podczas inicjalizacji połączenia kont klienta i ISV
- Kod źródła płatności w panelu klienta - 4-cyfrowy kod ustawiany w panelu konta klienckiego VivaWallet
- Kod źródła płatności w panelu ISV - możliwy w przypadku ustawienia więcej niż jednego źródła płatności dla konta ISV, domyślnie puste
- Adres do dokończenia integracji - link do połączenia konta klienckiego VivaWallet z kontem ISV
- Adresy IP VivaWallet (oddzielone przecinkiem) - whitelista adresów ip, z których VivaWallet może komunikować się z VnetLPR
- Identyfikator do legacy API (ResellerId) - klucz niezbędny do działania integracji, do pobrania w panelu konta ISV VivaWallet
- Klucz legacy API (Reseller Api Key) - klucz niezbędny do działania integracji, do pobrania w panelu konta ISV VivaWallet
- IP requestów przychodzących - adres ip, z którego łączy się VivaWallet, jeśli nie ma go w polu Adresy IP VivaWallet, to należy go tam dodać
Analogiczne opcje konfiguracyjne dostępne są dla trybu testowego.