Przewodnik po integracji Smart Checkout

Viva.com Smart Checkout umożliwia przyjmowanie płatności online za pośrednictwem hostowanej strony płatności.

Ten przewodnik przedstawia główne etapy integracji Smart Checkout z Państwa stroną internetową lub aplikacją — od skonfigurowania konta Viva.com i źródła płatności po przekierowanie klientów i weryfikację wyniku płatności.

1. Wybierz środowisko Viva.com

Viva.com udostępnia dwa środowiska. Należy upewnić się, że używane środowisko odpowiada temu, co chcą Państwo zrobić.

Środowisko	Zastosowanie	Pierwsze kroki
Produkcyjne	Przyjmowanie rzeczywistych płatności	Proces rejestracji konta Viva.com \| Viva.com Support
Demo	Testowanie integracji i płatności testowych	Pierwsze kroki z kontem demo \| Viva.com Support

Podczas konfigurowania i testowania integracji należy upewnić się, że pracują Państwo w odpowiednim środowisku.

2. Utwórz źródło płatności dla płatności online

Źródło płatności zawiera ustawienia używane przez Viva.com do obsługi płatności dokonywanych za pośrednictwem Państwa strony internetowej lub aplikacji.

Podczas konfigurowania źródła płatności należy skonfigurować domenę oraz adresy URL, na które klienci mają być przekierowywani po zakończeniu procesu płatności.

Na przykład:

stronę potwierdzającą pomyślną płatność, np. „Dziękujemy za zamówienie”
stronę informującą o nieudanej płatności, np. „Wystąpił problem z płatnością”

Aby utworzyć źródło płatności dla płatności online, należy przejść do Sprzedaż > Płatności online w Dashboard Viva.com.

Po utworzeniu źródła płatności należy zapisać jego 4-cyfrowy kod źródła. Kod ten będzie potrzebny podczas konfigurowania integracji.

Przykładowa konfiguracja źródła płatności o kodzie źródłowym 1309

Szczegółowe instrukcje dotyczące konfiguracji można znaleźć w artykule Źródło dla płatności online | Viva.com Support.

3. Zintegruj Smart Checkout

Integracja Smart Checkout obejmuje trzy główne kroki:

Krok 1: Utwórz zlecenie płatności

Przed zażądaniem płatności od klienta należy utworzyć zlecenie płatności.

Każdemu zleceniu płatności przypisywany jest unikalny 16-cyfrowy identyfikator o nazwie orderCode.

Należy utworzyć zlecenie płatności na swoim serwerze za pomocą Create Payment Order API, a następnie przekazać orderCode do swojej strony internetowej lub aplikacji.

Informacje na temat parametrów API i szczegółów implementacji można znaleźć w Viva.com Developer Portal. W menu po lewej stronie należy wybrać APIs for payments, a następnie Payment API. W sekcji Payments należy wybrać Create payment order.

Krok 2: Przekieruj klienta do Smart Checkout

Po utworzeniu zlecenia płatności należy przekierować klienta do Smart Checkout. Klient może następnie wprowadzić dane płatności i zakończyć proces płatności na stronie Smart Checkout.

Krok 3: Obsłuż powrót klienta i zweryfikuj wynik płatności

Po zakończeniu procesu płatności klient zostaje przekierowany na adres URL skonfigurowany dla odpowiedniego wyniku:

Success URL dla udanych płatności
Failure URL dla nieudanych płatności

Te adresy URL można skonfigurować w Dashboard Viva.com w sekcji Sprzedaż > Płatności online > Strony internetowe / aplikacje.

Zweryfikuj wynik płatności

Należy zweryfikować status transakcji w swoim systemie, korzystając z informacji o płatności zwróconych przez Viva.com. Informacje o transakcji używane do weryfikacji obejmują:

Amount
transactionId
statusId

Viva.com udostępnia następujące metody sprawdzania wyniku płatności.

Webhooks

Webhooks umożliwiają systemowi otrzymywanie powiadomień o udanych lub nieudanych płatnościach i obsługują zarówno synchroniczne, jak i asynchroniczne metody płatności.

Szczegółowe informacje dotyczące implementacji, parametrów zdarzeń i przykładowych payloadów można znaleźć w Viva.com Developer Portal. W menu należy wybrać Webhooks For Payments.

Retrieve Transaction API

Informacje o transakcji można również pobrać za pomocą Retrieve Transaction API. Informacje na temat parametrów API i szczegółów implementacji można znaleźć w Viva.com Developer Portal. W menu po lewej stronie należy wybrać APIs for payments, a następnie Payment API. W sekcji Transactions należy wybrać Retrieve transaction.

Opcjonalne ustawienia Smart Checkout

Można również skonfigurować dodatkowe ustawienia Smart Checkout odpowiednio do potrzeb integracji.

Wyświetl logo swojej marki

Logo swojej marki można dodać do Smart Checkout za pośrednictwem ustawień źródła płatności. Instrukcje można znaleźć w Viva.com Developer Portal. Należy przejść do Tutorials, wybrać Smart Checkout Configuration, a następnie kliknąć Add your brand logo.

Aby zapewnić optymalne wyświetlanie, należy przesłać wyraźne logo o odpowiednim rozmiarze.

Wyświetl przycisk Cancel

W zaawansowanych ustawieniach konfiguracji źródła płatności można skonfigurować przycisk Cancel. Umożliwia on klientom anulowanie zamówienia.

Przycisk Cancel jest obsługiwany w przypadku bezpośrednich integracji Smart Checkout oraz pluginów dla Shopify i PrestaShop.

Można również skonfigurować webhooks, aby otrzymywać powiadomienia o zdarzeniach związanych z anulowaniem zamówień. Należy przejść do Viva.com Developer Portal, wybrać Webhooks For Payments, a następnie Order Updated, aby uzyskać więcej informacji.

Dodatkowe opcje płatności

Smart Checkout obsługuje również dodatkowe konfiguracje płatności, w tym:

Płatności cykliczne: Sprzedawca automatycznie inicjuje obciążenia zgodnie z wcześniej określonym harmonogramem po pierwszej płatności.
Preautoryzacje: Kwota zostaje zarezerwowana, a transfer środków jest inicjowany później.

Szczegółowe informacje techniczne dotyczące implementacji i innych dostępnych konfiguracji Smart Checkout można znaleźć w Viva.com developer portal.

Nadal potrzebują Państwo pomocy? Nasz zespół jest do Państwa dyspozycji. Prosimy o kontakt za pośrednictwem opcji Porozmawiaj z nami na Państwa koncie Viva.com.