Integracja niestandardowa

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.

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:

1. Przejdź do Dashboard -> Settings -> Checkout settings .
2. Kliknij Add bank account
3. 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

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ć:

1. Przejdź do Dashboard -> Settings -> Checkout settings
2. 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.

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:

1. Przejdź do Dashboard -> Settings -> Checkout settings -> Branding
2. Skonfiguruj poniższe ustawienia:
   • Logo.
   • Kolor marki i akcentu.
   • Motyw, styl i czcionka.

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:

1. Przejdź do Dashboard -> Settings -> Shipping -> Rates
2. Kliknij Add carrier
3. 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ą.

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:

1. Przejdź do Dashboard -> Settings -> Shipping -> Locations
2. Kliknij New zone
3. Wprowadź nazwę strefy i wybierz kraje, do których chcesz wysyłać.
4. Wybierz operatora i poziom usługi, który chcesz oferować.

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:

1. Przejdź do Dashboard -> Settings -> Shipping -> Catalog.
2. W przypadku kraju pochodzenia wybierz kraj, w którym wytwarzana jest większość twoich produktów.
3. 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.

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:

• Checkout Experience: Renderuje interfejs kasy i przetwarza płatności.
• Location Services: Wykrywa lokalizację odwiedzającego i zarządza konwersją walut.
• Cart Integration: Łączy się z istniejącym wózkiem i systemem zamówień.
• Security: 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ć nietechniczną, 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.

4. Przekaż odpowiadające identyfikatory poprzez customHTML Checkout, 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:

• Google Analytics 4 for iframe Checkout
• Facebook Pixel for iframe Checkout

Aby zsynchronizować zamówienia między twoim systemem a Zonos Dashboard, wdróż te wywołania API i webhooki:

Wymagane mutacje 

Wymagane webhooki 

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ę.

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:

• 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.

Wyszukiwanie zamówienia z zonosCheckoutSessionId 

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.

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.

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.