Anpassad integration

För att komma igång, kontakta vårt säljteam för att skapa ett konto och underteckna ett avtal. När avtalet är undertecknat får ni två mikroinsättningar på ert konto som behöver verifieras.

Skicka dessa mikroinsättningsbelopp via e-post till accounting@zonos.com tillsammans med ert Dashboard store ID (CC:a er säljrepresentant).

När verifieringen är klar visas era bankuppgifter i Dashboard -> Settings -> Billing.

När ni har skapat ert Zonos-konto behöver ni konfigurera inställningar i Dashboard så att Checkout fungerar korrekt med er butik. Detta avsnitt täcker alla väsentliga Dashboard-konfigurationer.

Konfigurera utbetalningar 

Anslut ett bankkonto för att ta emot utbetalningar från Checkout i tid. Utbetalningar behandlas dagligen med en fördröjning på 2 dagar från den inkasserade betalningen. Följ dessa steg:

1. Navigera till Dashboard -> Settings -> Checkout settings .
2. Klicka på Add bank account
3. Ni tas till en Stripe-portal för att slutföra konfigurationen och ange följande information:
   • Bankkontouppgifter.
   • Företagets EIN.
   • Personnummer för en ägare med minst 25 % ägarandel. Mer information om varför detta krävs finns i Stripes dokumentation.

Obs: Om ni behöver uppdatera ert utbetalningsschema, kontakta support@zonos.com

Konfigurera tillåtna domäner 

Zonos JS-skriptet kräver en lista över tillåtna domäner av säkerhetsskäl. Detta förhindrar att obehöriga webbplatser laddar skriptet och säkerställer att det bara körs på era godkända domäner. Utan denna konfiguration returnerar skriptet behörighetsfel.

Så här ställer ni in detta:

1. Navigera till Dashboard -> Settings -> Checkout settings
2. Under URLs, lägg till er fullständiga domän och eventuella underdomäner där Checkout ska användas. Om er domän till exempel är example.com bör ni lägga till example.com och test.example.com.

Anpassa varumärkesinställningar 

Konfigurera era varumärkesinställningar i Dashboard så att de matchar er butiks utseende och känsla.

Följ dessa steg:

1. Navigera till Dashboard -> Settings -> Checkout settings -> Branding
2. Konfigurera följande inställningar:
   • Logotyp.
   • Varumärkes- och accentfärg.
   • Tema, stil och teckensnitt.

Mer information om varumärkesinställningar finns i vår dokumentation.

Anslut en frakttransportör 

För att kunna ge fraktofferter i kassan behöver ni ansluta en frakttransportör till ert Zonos-konto. Då kan ni aktivera specifika frakttjänstenivåer i kassan.

För att ansluta en frakttransportör, följ dessa steg:

1. Navigera till Dashboard -> Settings -> Shipping -> Rates
2. Klicka på Add carrier
3. Följ instruktionerna för transportörskonfiguration.

Mer information om att ansluta transportörskonton finns i vår dokumentation.

Konfigurera fraktzoner 

Fraktzoner låter er konfigurera vilka frakttransportörer och tjänstenivåer som är tillgängliga för olika regioner i världen.

För att konfigurera fraktzoner, följ dessa steg:

1. Navigera till Dashboard -> Settings -> Shipping -> Locations
2. Klicka på New zone
3. Ange ett zonnamn och välj de länder ni vill skicka till.
4. Välj den transportör och tjänstenivå ni vill erbjuda.

Mer information om fraktzoner finns i vår dokumentation.

Konfigurera ett reservursprungsland och en HS-kod 

Ursprungsland och HS-kod används för att beräkna korrekta tullar och skatter.

Om ni inte anger ett specifikt ursprungsland eller en HS-kod använder vi reservvärdena som ställts in i Dashboard.

Så här ställer ni in ert reservursprungsland och er HS-kod:

1. Navigera till Dashboard -> Settings -> Shipping -> Catalog.
2. För ursprungsland, välj det land där majoriteten av era produkter tillverkas.
3. För HS-kod, ange HS-koden för er vanligaste produkt. Om ni inte har en HS-kod, navigera till Classify i Dashboard och ange namn och beskrivning för er produkt för att generera en korrekt HS-kod.

Zonos JS-snippetet är en klientbaserad JavaScript-integration som möjliggör global checkout-funktionalitet på er webbplats. Det fungerar som bron mellan er e-handelsplattform och Zonos-tjänster och hanterar:

• Checkout-upplevelse: Renderar checkout-gränssnittet och behandlar betalningar.
• Platstjänster: Identifierar besökarens plats och hanterar valutakonvertering.
• Varukorgsintegration: Ansluter till er befintliga varukorgs- och ordersystem.
• Säkerhet: Validerar domäner och autentiserar API-förfrågningar.

Snippetet laddas asynkront för att undvika påverkan på er webbplats prestanda. Det initieras med er butiks API-uppgifter och hanterar alla klientinteraktioner säkert. Implementeringen är utformad för att vara diskret och kräver minimala ändringar i ert befintliga checkout-flöde.

Nedan finns ett komplett exempel som inkluderar skriptladdning, initiering och händelsehantering att referera till när ni integrerar Checkout.

4. Skicka med motsvarande ID:n via er Checkout-customHTML så att reläet vet vilken egenskap/pixel det ska matchas mot:

För steg-för-steg-instruktioner för iframe, en fullständig referens över eventen (inklusive mappningen av purchase/Purchase-nyttolasten) och tips för felsökning, se:

• Google Analytics 4 för iframe-Checkout
• Facebook Pixel för iframe-Checkout

Implementera följande API-anrop och webhooks för att synkronisera ordrar mellan ert system och Zonos Dashboard:

Obligatoriska mutationer 

Obligatoriska webhooks 

Innan ni går live med er Checkout-integration är det viktigt att noggrant testa alla delar av integrationen för att säkerställa en smidig kundupplevelse. Detta inkluderar att testa checkout-flödet, betalningshanteringen, orderskapandet och webhook-funktionaliteten.

Följ vår testguide för att verifiera att er integration fungerar korrekt och för att identifiera och åtgärda eventuella problem innan lansering i produktion.

Nedan finns några vanliga frågor om integrationsprocessen.

Hur hanterar Zonos orderbekräftelse? 

Konfigurera efterköpsupplevelsen i Dashboard -> Settings -> Checkout settings under Success page type. Tre alternativ finns tillgängliga:

• Show Zonos success page (standard, rekommenderas) — Zonos visar en inbyggd tacksida efter att beställningen har lagts. Sidan visas alltid, även om ordern misslyckas med att importeras till ert system, så att kunden alltid får en bekräftelse.
• Redirect to a success page — Zonos väntar på en kort "Order complete"-skärm tills ordern har skapats och omdirigerar sedan till er konfigurerade success-URL med zOrderNumber (och orderId för äldre varukorgar) tillagt som frågeparametrar.
• Close the checkout modal — Zonos stänger sin modal så snart betalningen har inkasserats. Om ni även har konfigurerat en success-URL omdirigerar Zonos till den URL:en omedelbart efter att Stripe har tagit emot betalningen — utan att vänta på att ordern skapas — och lägger till zonosCheckoutSessionId som frågeparameter. Använd det här alternativet när ni vill ha snabbast möjliga överlämning tillbaka till er egen success-sida.

Slå upp ordern från zonosCheckoutSessionId 

När ni använder Close the checkout modal med en omdirigerings-URL kan det ta några sekunder innan ordern kopplas till checkout-sessionen efter omdirigeringen. Läs zonosCheckoutSessionId från URL:en och fråga checkoutSession GraphQL-frågan från er server med er hemliga autentiseringstoken tills ordern är klar. Anropa aldrig detta från webbläsaren — den hemliga autentiseringstoken måste stanna på serversidan.

Skicka frågan till https://api.zonos.com/graphql med er hemliga autentiseringstoken från Dashboard -> Settings -> Integrations som skickas som credentialToken-headern i förfrågan.

Kan jag bli notifierad när en order skapas? 

Ja. Om ni vill få notifieringar när en order skapas kan ni, under avsnittet Email i Checkout settings i Dashboard, ange e-postadressen till de teammedlemmar som ska notifieras när en order skapas, skickas eller avbryts.