Postępuj zgodnie z tą kompleksową listą kontrolną, aby skonfigurować swoje konto Zonos Dashboard i zintegrować Zonos Checkout na swojej niestandardowej stronie lub platformie.
1
Utwórz konto Zonos
Aby rozpocząć, prosimy skontaktować się z naszym zespołem ds. sprzedaży, aby utworzyć konto i podpisać umowę. Po podpisaniu umowy otrzymasz dwie małe wpłaty na swoje konto, które należy zweryfikować.
Prosimy wysłać kwoty tych małych wpłat na adres accounting@zonos.com wraz z identyfikatorem sklepu Dashboard (CC twojemu przedstawicielowi ds. sprzedaży).
Po weryfikacji twoje dane bankowe będą wyświetlane w Dashboard -> Settings -> Billing.
2
Skonfiguruj ustawienia Dashboard i Checkout
Po utworzeniu konta Zonos musisz skonfigurować ustawienia w Dashboard, aby upewnić się, że Checkout działa prawidłowo w twojej witrynie. Ta sekcja obejmuje wszystkie niezbędne konfiguracje Dashboard.
Połącz konto bankowe, aby otrzymywać terminowe wypłaty z Checkout. Wypłaty są przetwarzane codziennie w ciągu 2 dni od przechwycenia płatności. Aby to zrobić, postępuj zgodnie z poniższymi krokami:
Zostaniesz przeniesiony do portalu Stripe, aby ukończyć konfigurację i podać następujące informacje:
Informacje o koncie bankowym.
EIN firmy.
Numer ubezpieczenia społecznego właściciela firmy posiadającego 25% udziałów. Aby uzyskać więcej szczegółów na temat przyczyn tego wymogu, zapoznaj się z dokumentacją Stripe.
Uwaga: Jeśli chcesz zaktualizować harmonogram wypłat, skontaktuj się z support@zonos.com
Skrypt JS Zonos wymaga listy dozwolonych domen ze względów bezpieczeństwa. Zapobiega to ładowaniu skryptu przez nieautoryzowane witryny i zapewnia, że działa tylko na zatwierdzonych domenach. Bez tej konfiguracji skrypt zwróci błędy uprawnień.
W sekcji URLs dodaj swoją pełną domenę i dowolne subdomeny, w których będzie używany Checkout. Na przykład, jeśli twoja domena to example.com, powinieneś dodać example.com i test.example.com.
Aby podać ceny wysyłki przy kasie, musisz połączyć operatora wysyłkowego z kontem Zonos. To umożliwi Ci włączenie określonych poziomów usług wysyłkowych przy kasie.
Aby połączyć operatora wysyłkowego, postępuj zgodnie z poniższymi krokami:
Przejdź do Dashboard -> Settings -> Shipping -> Rates
Kliknij Add carrier
Postępuj zgodnie z instrukcjami konfiguracji operatora.
Aby uzyskać więcej szczegółów na temat połączania kont operatorów, zapoznaj się z naszą dokumentacją.
Kraj pochodzenia i kod HS są używane do obliczenia dokładnych cła i podatków.
Jeśli nie podasz określonego kraju pochodzenia lub kodu HS, użyjemy rezerwowych ustawień skonfigurowanych w Dashboard.
Aby ustawić rezerwowy kraj pochodzenia i kod HS:
Przejdź do Dashboard -> Settings -> Shipping -> Catalog.
W przypadku kraju pochodzenia wybierz kraj, w którym wytwarzana jest większość twoich produktów.
W przypadku kodu HS wprowadź kod HS swojego najpopularniejszego produktu. Jeśli nie masz kodu HS, przejdź do Classify w Dashboard i wprowadź nazwę i opis swojego produktu, aby wygenerować dokładny kod HS.
3
Zainstaluj fragment JS Zonos
Fragment JS Zonos to integracja JavaScript po stronie klienta, która włącza globalną funkcjonalność kasy na twojej stronie. Służy jako most między twoją platformą e-commerce a usługami Zonos, obsługując:
Doświadczenie Checkout: Renderuje interfejs kasy i przetwarza płatności.
Usługi lokalizacyjne: Wykrywa lokalizację odwiedzającego i zarządza konwersją walut.
Integracja koszyka: Łączy się z istniejącym wózkiem i systemem zamówień.
Bezpieczeństwo: Weryfikuje domeny i uwierzytelnia żądania API.
Fragment jest ładowany asynchronicznie, aby zapobiec jakimkolwiek wpływom na wydajność witryny. Inicjalizuje się za pomocą poświadczeń API sklepu i obsługuje wszystkie interakcje po stronie klienta w bezpieczny sposób. Wdrożenie ma być nieinwazyjne, wymagając minimalnych zmian w istniejącym przepływie kasy.
Poniżej znajduje się kompletny przykład obejmujący ładowanie skryptu, inicjalizację i obsługę zdarzeń, do którego należy odwołać się podczas integracji Checkout.
1
Przekaż odpowiadające identyfikatory poprzez customHTML Checkout, aby relay wiedział, którą właściwość/piksel ma uruchomić:
1
Aby uzyskać instrukcje krok po kroku dla iframe, pełne odniesienie zdarzeń (w tym mapowanie ładunku purchase / Purchase) i porady dotyczące debugowania, patrz:
Synchronizuje numer twojego natywnego konta z Dashboard. Docs →
orderAddTrackingNumber
Wymagane tylko, jeśli nie drukujesz etykiet w Dashboard. Zapewnia, że śledzenie jest widoczne w Dashboard, aby Zonos mógł zagarantować twoje obliczenia Landed cost. Docs →
Potrzebne, aby wysyłać zamówienia Checkout do twojej natywnej platformy. Docs →
ORDER_STATUS_CHANGED
Utrzymuje twój system w synchronizacji z Zonos, gdy zmienia się status zamówienia (np. zrealizowane, anulowane). Docs →
7
Przetestuj swoją integrację
Przed wdrożeniem integracji Checkout na stronie, ważne jest dokładne przetestowanie wszystkich aspektów integracji, aby zapewnić gładkie doświadczenie klienta. Obejmuje to testowanie przepływu kasy, przetwarzania płatności, tworzenia zamówień i funkcjonalności webhooków.
Skonfiguruj doświadczenie po zakupie w Dashboard -> Settings -> Checkout settings w sekcji Success page type. Dostępne są trzy opcje:
Show Zonos success page (domyślna, rekomendowana) — Zonos wyświetla wbudowaną stronę dziękowania po złożeniu zamówienia. Strona jest zawsze pokazywana, nawet jeśli zamówienie nie zostanie zaimportowane do twojego systemu, więc kupujący zawsze otrzymuje potwierdzenie.
Redirect to a success page — Zonos czeka na krótkim ekranie „Order complete", dopóki zamówienie nie zostanie utworzone, a następnie przekierowuje na skonfigurowany adres URL sukcesu z zOrderNumber (i orderId dla starszych koszyków) dołączonym jako parametry zapytania.
Close the checkout modal — Zonos zamyka modał po przechwyceniu płatności. Jeśli także skonfigurujesz adres URL sukcesu, Zonos przekierowuje do tego adresu URL natychmiast po pobraniu płatności przez Stripe — bez czekania na utworzenie zamówienia — i dołącza zonosCheckoutSessionId jako parametr zapytania. Użyj tej opcji, gdy chcesz najszybszego przekazania do twojej własnej strony sukcesu.
Gdy używasz Close the checkout modal z adresem URL przekierowania, zamówienie może potrwać kilka sekund, aby dołączyć do sesji kasy po przekierowaniu. Przeczytaj zonosCheckoutSessionId z adresu URL i sonduj zapytanie GraphQL checkoutSession z serwera za pomocą tajnego tokenu poświadczeń, dopóki zamówienie nie będzie gotowe. Nigdy nie wywołuj tego z przeglądarki — tajny token poświadczeń musi pozostać po stronie serwera.
1query getCheckoutSession($id: String!)
2checkoutSession )
3order
4id
Wyślij zapytanie do https://api.zonos.com/graphql ze swoim tajnym tokenem poświadczeń z Dashboard -> Settings -> Integrations przekazanym jako nagłówek żądania credentialToken.
Tak. Jeśli chcesz otrzymać powiadomienia o utworzeniu zamówienia, w Dashboard w sekcji EmailCheckout settings możesz wprowadzić adres e-mail członków zespołu, którzy powinni być powiadamiani o utworzeniu, wysłaniu lub anulowaniu zamówienia.
Integracja niestandardowa
Integracja niestandardowa
Zbuduj end-to-end integrację Checkout na swojej niestandardowej stronie.
Lista kontrolna integracji
Postępuj zgodnie z tą kompleksową listą kontrolną, aby skonfigurować swoje konto Zonos Dashboard i zintegrować Zonos Checkout na swojej niestandardowej stronie lub platformie.
Utwórz konto Zonos
Aby rozpocząć, prosimy skontaktować się z naszym zespołem ds. sprzedaży, aby utworzyć konto i podpisać umowę. Po podpisaniu umowy otrzymasz dwie małe wpłaty na swoje konto, które należy zweryfikować.
Prosimy wysłać kwoty tych małych wpłat na adres accounting@zonos.com wraz z identyfikatorem sklepu Dashboard (CC twojemu przedstawicielowi ds. sprzedaży).
Po weryfikacji twoje dane bankowe będą wyświetlane w Dashboard -> Settings -> Billing.
Skonfiguruj ustawienia Dashboard i Checkout
Po utworzeniu konta Zonos musisz skonfigurować ustawienia w Dashboard, aby upewnić się, że Checkout działa prawidłowo w twojej witrynie. Ta sekcja obejmuje wszystkie niezbędne konfiguracje Dashboard.
Skonfiguruj wypłaty
Połącz konto bankowe, aby otrzymywać terminowe wypłaty z Checkout. Wypłaty są przetwarzane codziennie w ciągu 2 dni od przechwycenia płatności. Aby to zrobić, postępuj zgodnie z poniższymi krokami:
Skonfiguruj dozwolone domeny
Skrypt JS Zonos wymaga listy dozwolonych domen ze względów bezpieczeństwa. Zapobiega to ładowaniu skryptu przez nieautoryzowane witryny i zapewnia, że działa tylko na zatwierdzonych domenach. Bez tej konfiguracji skrypt zwróci błędy uprawnień.
Aby to skonfigurować:
example.com, powinieneś dodaćexample.comitest.example.com.Dostosuj ustawienia brandingu
Skonfiguruj ustawienia brandingu w Dashboard, aby pasowały do wyglądu i stylu swojej witryny.
Aby to zrobić, postępuj zgodnie z poniższymi krokami:
Aby uzyskać więcej informacji na temat ustawień brandingu, zapoznaj się z naszą dokumentacją.
Połącz operatora wysyłkowego
Aby podać ceny wysyłki przy kasie, musisz połączyć operatora wysyłkowego z kontem Zonos. To umożliwi Ci włączenie określonych poziomów usług wysyłkowych przy kasie.
Aby połączyć operatora wysyłkowego, postępuj zgodnie z poniższymi krokami:
Aby uzyskać więcej szczegółów na temat połączania kont operatorów, zapoznaj się z naszą dokumentacją.
Skonfiguruj strefy wysyłkowe
Strefy wysyłkowe umożliwiają skonfigurowanie, którzy operatorzy wysyłkowi i poziomy usług są dostępne dla różnych regionów świata.
Aby skonfigurować strefy wysyłkowe, postępuj zgodnie z poniższymi krokami:
Aby uzyskać więcej szczegółów na temat stref wysyłkowych, zapoznaj się z naszą dokumentacją.
Skonfiguruj rezerwową kraj pochodzenia i kod HS
Kraj pochodzenia i kod HS są używane do obliczenia dokładnych cła i podatków.
Jeśli nie podasz określonego kraju pochodzenia lub kodu HS, użyjemy rezerwowych ustawień skonfigurowanych w Dashboard.
Aby ustawić rezerwowy kraj pochodzenia i kod HS:
Zainstaluj fragment JS Zonos
Fragment JS Zonos to integracja JavaScript po stronie klienta, która włącza globalną funkcjonalność kasy na twojej stronie. Służy jako most między twoją platformą e-commerce a usługami Zonos, obsługując:
Fragment jest ładowany asynchronicznie, aby zapobiec jakimkolwiek wpływom na wydajność witryny. Inicjalizuje się za pomocą poświadczeń API sklepu i obsługuje wszystkie interakcje po stronie klienta w bezpieczny sposób. Wdrożenie ma być nieinwazyjne, wymagając minimalnych zmian w istniejącym przepływie kasy.
Poniżej znajduje się kompletny przykład obejmujący ładowanie skryptu, inicjalizację i obsługę zdarzeń, do którego należy odwołać się podczas integracji Checkout.
customHTMLCheckout, aby relay wiedział, którą właściwość/piksel ma uruchomić:Aby uzyskać instrukcje krok po kroku dla iframe, pełne odniesienie zdarzeń (w tym mapowanie ładunku
purchase/Purchase) i porady dotyczące debugowania, patrz:Zsynchronizuj śledzenie zamówień i status na Dashboard
Aby zsynchronizować zamówienia między twoim systemem a Zonos Dashboard, wdróż te wywołania API i webhooki:
Wymagane mutacje
orderUpdateAccountOrderNumberorderAddTrackingNumberWymagane webhooki
ORDER_CREATEDORDER_STATUS_CHANGEDPrzetestuj swoją integrację
Przed wdrożeniem integracji Checkout na stronie, ważne jest dokładne przetestowanie wszystkich aspektów integracji, aby zapewnić gładkie doświadczenie klienta. Obejmuje to testowanie przepływu kasy, przetwarzania płatności, tworzenia zamówień i funkcjonalności webhooków.
Postępuj zgodnie z naszym przewodnikiem testowania, aby zweryfikować, że twoja integracja działa prawidłowo i aby zidentyfikować i naprawić wszelkie problemy przed uruchomieniem na produkcję.
Częste pytania
Poniżej znajdują się niektóre typowe pytania dotyczące procesu integracji.
Jak Zonos obsługuje potwierdzenie zamówienia?
Skonfiguruj doświadczenie po zakupie w Dashboard -> Settings -> Checkout settings w sekcji Success page type. Dostępne są trzy opcje:
zOrderNumber(iorderIddla starszych koszyków) dołączonym jako parametry zapytania.zonosCheckoutSessionIdjako parametr zapytania. Użyj tej opcji, gdy chcesz najszybszego przekazania do twojej własnej strony sukcesu.Wyszukiwanie zamówienia z
zonosCheckoutSessionIdGdy używasz Close the checkout modal z adresem URL przekierowania, zamówienie może potrwać kilka sekund, aby dołączyć do sesji kasy po przekierowaniu. Przeczytaj
zonosCheckoutSessionIdz adresu URL i sonduj zapytanie GraphQLcheckoutSessionz serwera za pomocą tajnego tokenu poświadczeń, dopóki zamówienie nie będzie gotowe. Nigdy nie wywołuj tego z przeglądarki — tajny token poświadczeń musi pozostać po stronie serwera.query getCheckoutSession($id: String!)checkoutSession )orderidWyślij zapytanie do
https://api.zonos.com/graphqlze swoim tajnym tokenem poświadczeń z Dashboard -> Settings -> Integrations przekazanym jako nagłówek żądaniacredentialToken.Czy mogę być powiadamiany, gdy zostanie utworzone zamówienie?
Tak. Jeśli chcesz otrzymać powiadomienia o utworzeniu zamówienia, w Dashboard w sekcji Email Checkout settings możesz wprowadzić adres e-mail członków zespołu, którzy powinni być powiadamiani o utworzeniu, wysłaniu lub anulowaniu zamówienia.
Czy ta strona była pomocna?