Wprowadzenie
Zintegruj Viva.com Smart Checkout, aby umożliwić klientom dokonywanie bezpiecznych płatności za pośrednictwem hostowanej strony kasy. Ten przewodnik przeprowadzi Cię przez kolejne kroki bezproblemowej integracji z witryną lub aplikacją.
➤ Zdobądź konto Viva.com, jeśli jeszcze go nie masz
Viva.com obsługuje dwa różne środowiska, upewnij się, że używasz właściwego:
Środowisko | Opis | Adres URL rejestracji | Adres URL pulpitu nawigacyjnego |
Produkcja | Do dokonywania płatności w świecie rzeczywistym | ||
Demo | Do przeprowadzania płatności testowych i innych celów testowych |
➤ Pobierz źródło płatności online i zachowaj kod źródłowy
Źródło płatności to jednostka konfiguracyjna, która umożliwia sprzedawcom konfigurowanie i zarządzanie ustawieniami integracji płatności dla ich witryn internetowych lub aplikacji mobilnych.
Skonfiguruj swoją domenę i adresy URL Viva.com do których Smart Checkout będzie przekierowywać klientów po zakończeniu płatności. Te adresy URL zwykle prowadzą do stron takich jak "Dziękujemy za zamówienie" w przypadku udanych płatności lub "Coś poszło nie tak z płatnością" w przypadku nieudanych transakcji, dzięki czemu klienci mogą bezproblemowo kontynuować podróż w Twojej witrynie lub aplikacji.
Utwórz źródło płatności dla płatności online, przechodząc do Sprzedaż > Płatności online > Strony internetowe / aplikacje na pulpicie nawigacyjnym Viva.com.
Upewnij się, że zapisałeś 4-cyfrowy kod źródłowy właśnie utworzonego źródła płatności, ponieważ będzie on później potrzebny do celów integracji i konfiguracji.
Przykładowa konfiguracja źródła płatności z kodem źródłowym 4642
Sprawdź tutaj, aby uzyskać szczegółowy przewodnik na temat tworzenia Źródło płatności onlin
➤ Przewodnik integracji krok po kroku
Kluczowe kroki do integracji
Tworzenie zlecenia płatniczego
Przekieruj do Smart Checkout
Obsługa zwrotów od klientów i weryfikacja wyników płatności
➥ Krok 1: Utwórz zlecenie płatnicze |
Aby zażądać płatności od jednego ze swoich klientów, musisz utworzyć zlecenie płatnicze. Każdemu zleceniu płatniczemu przypisywany jest unikalny 16-cyfrowy identyfikator, znany również jako orderCode.
Możesz wygenerować zlecenie płatnicze za pomocą interfejsu API tworzenia zlecenia płatniczego na swoim serwerze i przekazać orderCode do swojej strony internetowej lub aplikacji.
Aby uzyskać więcej informacji na temat konfiguracji zlecenia płatniczego, zapoznaj się z naszym szczegółowym przewodnikiem na naszym portalu dla programistów tutaj i tutaj.
➥ Krok 2: Przekieruj klienta do Smart Checkout |
Po przekierowaniu klienci zobaczą formularz Smart Checkout, aby wprowadzić szczegóły płatności i sfinalizować transakcję.
➤ Dodatkowe opcje Smart Checkout
Opcje źródła płatności
Wyświetl logo swojej marki
Możesz dołączyć logo swojej marki, które będzie wyświetlane w Smart Checkout, konfigurując je w ustawieniach Źródła płatności. Szczegółowy przewodnik znajduje się na naszym portalu dla programistów tutaj.
Dodanie logo poprawia wrażenia klientów, wzmacniając tożsamość marki podczas procesu płatności. Upewnij się, że przesyłasz wyraźne logo o odpowiednim rozmiarze, aby zapewnić optymalne wyświetlanie.
➤ Wyświetlanie przycisku anulowania
Udostępnienie przycisku Anuluj zapewnia klientom elastyczność i pomaga poprawić ogólne wrażenia użytkownika.
Możesz skonfigurować przycisk Anuluj w Smart Checkout, aby zapewnić klientom możliwość anulowania zamówień. Jest to zarządzane na poziomie źródła płatności (w sekcji Konfiguracja zaawansowana), co daje kontrolę nad tym, czy przycisk Anuluj jest dostępny dla zamówień powiązanych z określonym źródłem.
Obsługiwane platformy: Przycisk Anuluj jest obecnie obsługiwany w przypadku bezpośrednich integracji Smart Checkout i wtyczek dla Shopify i PrestaShop.
Obsługa webhooków: Możesz skonfigurować webhooki tak, aby otrzymywały powiadomienia o zdarzeniach związanych z anulowaniem zamówienia. Postępuj zgodnie z tym przewodnikiem konfiguracji elementu webhook, aby uzyskać więcej informacji
➥ Krok 3: Zajmij się zwrotem od klienta i zweryfikuj wynik płatności |
Obsługa zwrotów od klientów
Po dokonaniu płatności klienci są przekierowywani do:
Adres URL pomyślnych płatności zakończonych sukcesem.
Adres URL niepowodzenia dla nieudanych płatności.
Ustawienia te można skonfigurować za pośrednictwem Pulpitu Nawigacyjnego Konta Viva.com w Sprzedaż > Płatności online > Strony internetowe / aplikacje
Zweryfikuj wynik płatności
Weryfikacja gwarantuje, że transakcja została zakończona pomyślnie. Aby sprawdzić poprawność statusu transakcji w systemie, sprawdź następujące parametry: Amount, transactionId, statusId Wyświetl wszystkie kody StatusId
➤ Polecane metody weryfikacji płatności:
Elementy webhook:
Otrzymuj aktualizacje w czasie rzeczywistym o powodzeniu lub niepowodzeniu płatności.
Zapoznaj się z naszą dokumentacją elementów webhook Transaction Payment Created i Transaction Failed, aby uzyskać więcej informacji na temat implementacji, przykładowych ładunków i wyjaśnienia wszystkich parametrów.
Obejmuje zarówno synchroniczne, jak i asynchroniczne metody płatności.
Pobierz interfejs API transakcji:
Aby uzyskać więcej informacji na temat wywołania interfejsu API i jego parametrów, zapoznaj się z dokumentacją Pobierz interfejs API transakcji w naszym portalu dla programistów
➤ Dodatkowa konfiguracja
Dzięki Viva.com Smart Checkout przygotowaliśmy wiele funkcji i narzędzi, z których możesz korzystać i dać swoim klientom więcej opcji płatności.
Płatności cykliczne: Metoda płatności, w której sprzedawca (Ty) inicjuje opłaty automatycznie zgodnie z wcześniej określonym harmonogramem bez angażowania klienta po pierwszej płatności.
Preautoryzacje: Metoda płatności używana do weryfikacji dostępności środków i zarezerwowania kwoty, przy czym faktyczny transfer środków jest inicjowany później.
Szczegółowe przewodniki można znaleźć na naszym portalu dla programistów, aby przejść do wszystkich konfiguracji, których możesz dokonać za pośrednictwem swojego konta w celu akceptowania płatności online, a także zapoznać się ze wszystkimi alternatywami i usługami, które oferujemy.