Przejdź do głównej zawartości

Źródło dla płatności online

Zaktualizowano ponad 2 tygodnie temu

Źródła są używane do płatności online za pośrednictwem Smart Checkout, wtyczek i naszych narzędzi płatniczych.

➡️ Dodaj źródło

Aby dodać źródło do płatności online, wykonaj następujące kroki:

  1. Zaloguj się do Viva.com i wybierz odpowiednie konto (demo lub produkcyjne).

  2. Przejdź do Sprzedaż → Płatności online → Strony internetowe/Aplikacje.

  3. Wybierz Dodaj stronę internetową/Aplikację.

  4. Wypełnij wymagane dane w oknie podręcznym w następujący sposób:

  • Kod – Czterocyfrowy numer w lewym górnym rogu pola to „Kod źródła” – unikalny identyfikator tego źródła płatności. Kod ten jest generowany automatycznie, ale możesz wybrać inną wartość, jeśli wolisz (na przykład do celów organizacyjnych). Jeśli korzystasz z naszego Payment API, ten kod jest przekazywany przez parametr sourceCode podczas tworzenia zlecenia płatniczego.

  • Nazwa źródła – Oprócz Kodu źródła możesz również przypisać nazwę swojemu źródłu płatności. Ułatwia to identyfikację źródła w Twoim koncie i raportach (na przykład w Raporcie rozliczeniowym).

  • Powiązane konto – Wybierz konto (portfel), które chcesz powiązać z tym źródłem płatności. Gdy to źródło płatności zostanie użyte, środki zostaną wpłacone na wybrane konto. Możesz powiązać wiele różnych źródeł z jednym kontem, jeśli chcesz.

  • Protokół – Jeśli Twoja platforma e-commerce korzysta z SSL przy finalizacji zakupu, wybierz https. Jeśli Twoja platforma nie korzysta z SSL (tak jak w niektórych środowiskach deweloperskich), wybierz http.

  • Nazwa domeny – Wprowadź domenę, która zostanie powiązana z tym źródłem płatności. Nie musisz podawać końcowego ukośnika (\) ani protokołu (http:// lub https://). Na przykład:

    • Jeśli Twoja strona internetowa używa www: www.twojadomena.com

    • Jeśli Twoja strona internetowa nie używa www: twojadomena.com

  • Metoda integracji – Pozostaw ustawioną na Redirection/Native Checkout v2.

  • Logo firmy – Prześlij logo swojej firmy, które zostanie powiązane z tym źródłem płatności, w formacie PNG z przezroczystością, do 100 KB (zalecany rozmiar: 128 x 128 pikseli). Jest to ważny krok, ponieważ logo pojawi się na Twojej stronie płatności, pomagając klientom rozpoznać i potwierdzić Twoją firmę.

  • Success URL – Jest to adres URL strony, na którą klient zostanie przekierowany po udanej płatności. Na przykład możesz go użyć do wyświetlenia strony z potwierdzeniem płatności lub strony dziękującej klientowi za dokonanie płatności.

  • Failure URL – Jest to adres URL strony, na którą klient zostanie przekierowany po nieudanej płatności. Na przykład możesz go użyć, aby odesłać klienta do ostatniego kroku procesu płatności, aby mógł ponownie spróbować przeprowadzić transakcję.

Jeśli korzystasz z jednej z naszych wtyczek, Success URL i Failure URL mogą wymagać określonych wartości. Zapoznaj się z tabelą adresów URL wtyczek poniżej.

Plugin name

Success URL

WooCommerce Smart Checkout

index.php?wc-api=wc_vivawallet&vivawallet=success

OpenCart Smart Checkout

index.php?route=extension/payment/vivawallet/callback&success

Magento Smart Checkout

vivapayments/viva/callback

Plugin name

Failure URL

WooCommerce Smart Checkout

index.php?wc-api=wc_vivawallet&vivawallet=fail

OpenCart Smart Checkout

index.php?route=extension/payment/vivawallet/callback&fail

Magento Smart Checkout

vivapayments/viva/callback

  • Ustawienia zaawansowane – Na tym etapie możesz włączyć wyświetlanie przycisku Anuluj w Smart Checkout, a także zmodyfikować nazwy parametrów URL dodawanych do Success/Failure URL po transakcji (zobacz Response information | Viva.com Developer Portal).

    Aby włączyć przycisk Anuluj w Smart Checkout, aktywuj opcję Cancel Button. Po kliknięciu przycisku Anuluj, Smart Checkout przekieruje do Twojego Failure URL z parametrem cancel w zapytaniu.

Uwaga:

  • Obecnie przycisk Anuluj jest obsługiwany dla bezpośrednich integracji z Smart Checkout, a także dla określonych funkcjonalności w naszych wtyczkach dla Shopify i PrestaShop.

  • Możliwe jest również otrzymywanie webhooków dla zdarzeń anulowania zamówień. Postępuj zgodnie z tym przewodnikiem (Order Updated | Viva.com Developer Portal), aby skonfigurować webhook dla anulowania zamówień.

Parametry domyślne to:

Parameter

Default Name

Cancellation status

cancel

Order Code

s

Transaction ID

t

Language

lang

Zaleca się pozostawienie tych ustawień domyślnych, chyba że wymagane są szczególne zmiany w celu dostosowania ich do systemów wewnętrznych.

Na końcu przejrzyj informacje obok każdego pola wyboru na dole ekranu. Musisz zaakceptować te warunki, aby utworzyć źródło płatności. Po wybraniu wszystkich opcji kliknij przycisk Utwórz, aby zakończyć proces.

Czy to odpowiedziało na twoje pytanie?