Brugerdefineret integration

For at komme i gang skal du kontakte vores salgsteam for at oprette en konto og underskrive en aftale. Når en aftale er underskrevet, modtager du to mikroindskud på din konto, som skal verificeres.

Send mikroindskudsbeløbene pr. e-mail til accounting@zonos.com med dit Dashboard store ID (CC din salgsrepræsentant).

Når de er verificeret, vises dine bankoplysninger i Dashboard -> Settings -> Billing.

Efter oprettelse af din Zonos-konto skal du konfigurere indstillinger i Dashboard, så Checkout fungerer korrekt med din butik. Dette afsnit dækker alle væsentlige Dashboard-konfigurationer.

Opsæt udbetalinger 

Tilknyt en bankkonto for at modtage rettidige udbetalinger fra Checkout. Udbetalinger behandles dagligt med 2 dages forsinkelse fra den indfangede betaling. Følg disse trin:

1. Gå til Dashboard -> Settings -> Checkout settings .
2. Klik Add bank account
3. Du sendes til en Stripe-portal for at fuldføre opsætning og angive følgende:
   • Bankkontooplysninger.
   • Virksomhedens EIN.
   • Social Security Number for en virksomhedsejer med 25 % ejerandel. Se Stripes dokumentation for flere detaljer om, hvorfor dette kræves.

Note: Hvis du skal opdatere din udbetalingsplan, skal du kontakte support@zonos.com

Opsæt tilladte domæner 

Zonos JS-scriptet kræver en liste over tilladte domæner af sikkerhedshensyn. Det forhindrer uautoriserede sites i at indlæse scriptet og sikrer, at det kun kører på dine godkendte domæner. Uden denne konfiguration returnerer scriptet tilladelsesfejl.

Sådan opsætter du det:

1. Gå til Dashboard -> Settings -> Checkout settings
2. Under URLs skal du tilføje dit fulde domæne og eventuelle subdomæner, hvor Checkout bruges. Hvis dit domæne f.eks. er example.com, skal du tilføje example.com og test.example.com.

Tilpas branding-indstillinger 

Konfigurer branding-indstillinger i Dashboard, så de matcher din butiks udseende.

Følg disse trin:

1. Gå til Dashboard -> Settings -> Checkout settings -> Branding
2. Konfigurer følgende:
   • Logo.
   • Brand- og accentfarve.
   • Theme, Style og Font.

Se vores dokumentation for mere om branding-indstillinger.

Tilslut en forsendelsestransportør 

For at give forsendelsestilbud ved Checkout skal du tilslutte en transportør til din Zonos-konto. Det gør, at du kan aktivere specifikke servicelevels ved Checkout.

Følg disse trin for at tilslutte en transportør:

1. Gå til Dashboard -> Settings -> Shipping -> Rates
2. Klik Add carrier
3. Følg transportørens opsætningsinstruktioner.

Se vores dokumentation for flere detaljer om tilslutning af transportørkonti.

Opsæt forsendelseszoner 

Forsendelseszoner gør det muligt at konfigurere, hvilke transportører og servicelevels der er tilgængelige for forskellige regioner.

Følg disse trin for at opsætte forsendelseszoner:

1. Gå til Dashboard -> Settings -> Shipping -> Locations
2. Klik New zone
3. Angiv et zonenavn og vælg de lande, du vil sende til.
4. Vælg den transportør og det servicelevel, du vil tilbyde.

Se vores documentation for flere detaljer om forsendelseszoner.

Opsæt fallback for oprindelsesland og HS-kode 

Oprindelsesland og HS-kode bruges til at beregne præcis told og skat.

Hvis du ikke angiver et specifikt oprindelsesland eller en HS-kode, bruger vi fallback-værdierne opsat i Dashboard.

Sådan angiver du fallback for oprindelsesland og HS-kode:

1. Gå til Dashboard -> Settings -> Shipping -> Catalog.
2. For oprindelsesland skal du vælge det land, hvor størstedelen af dine produkter fremstilles.
3. For HS-koden skal du indtaste HS-koden for dit mest almindelige produkt. Hvis du ikke har en HS-kode, skal du gå til Classify i Dashboard og indtaste produktnavn og -beskrivelse for at generere en præcis HS-kode.

Zonos JS-snippet er en client-side JavaScript-integration, der aktiverer global Checkout på dit site. Det fungerer som bro mellem din e-handelsplatform og Zonos-tjenester og håndterer:

• Checkout-oplevelse: Viser Checkout-UI og behandler betalinger.
• Lokationstjenester: Registrerer besøgendes placering og håndterer valutakonvertering.
• Kurvintegration: Forbinder med dit eksisterende kurv- og ordresystem.
• Sikkerhed: Validerer domæner og autentificerer API-anmodninger.

Snippetet indlæses asynkront for ikke at påvirke dit sites ydeevne. Det initialiseres med din butiks API-legitimationsoplysninger og håndterer alle client-side interaktioner sikkert. Implementeringen er designet til at være uindtrængende og kræver minimale ændringer i dit eksisterende Checkout-flow.

Nedenfor er et komplet eksempel med scriptindlæsning, initialisering og eventhåndtering, du kan bruge som reference ved integration af Checkout.

4. Send de tilsvarende ID'er via Checkout customHTML, så relay'et ved, hvilken property/pixel der skal udløses mod:

For trin-for-trin iframe-instruktioner, den fulde event-reference (inkl. purchase / Purchase payload-mapping) og debugging-tips, se:

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

For at synkronisere ordrer mellem dit system og Zonos Dashboard skal du implementere disse API-kald og webhooks:

Påkrævede mutationer 

Påkrævede webhooks 

Før du går live med din Checkout-integration, er det vigtigt grundigt at teste alle aspekter for en smidig kundeoplevelse — Checkout-flow, betalingsbehandling, ordreoprettelse og webhook-funktionalitet.

Følg vores testguide for at verificere, at integrationen virker korrekt, og rette eventuelle problemer før produktion.

Nedenfor er nogle almindelige spørgsmål om integrationsprocessen.

Hvordan håndterer Zonos ordrebekræftelse? 

Konfigurer efter-købsoplevelsen i Dashboard -> Settings -> Checkout settings under Success page type. Tre muligheder er tilgængelige:

• Show Zonos success page (standard, anbefalet) — Zonos viser en indbygget tak-side efter ordren. Siden vises altid, selv hvis ordren fejler ved import til dit system, så køberen altid får en bekræftelse.
• Redirect to a success page — Zonos venter på en kort „Order complete“-skærm, indtil ordren er oprettet, og omdirigerer derefter til din konfigurerede success-URL med zOrderNumber (og orderId for legacy-kurve) som query-parametre.
• Close the Checkout modal — Zonos lukker sin modal, når betalingen er indfanget. Hvis du også konfigurerer en success-URL, omdirigerer Zonos med det samme efter Stripe har opkrævet betaling — uden at vente på ordreoprettelse — og tilføjer zonosCheckoutSessionId som query-param. Brug dette, når du vil have hurtigst mulig overdragelse til din egen success-side.

Slå ordren op via zonosCheckoutSessionId 

Når du bruger Close the Checkout modal med redirect-URL, kan det tage et par sekunder, før ordren knyttes til Checkout-sessionen efter redirect. Læs zonosCheckoutSessionId fra URL'en og poll checkoutSession GraphQL-query fra din server med dit hemmelige credential token, indtil ordren er klar. Kald aldrig dette fra browseren — det hemmelige credential token skal forblive på serversiden.

Send query til https://api.zonos.com/graphql med dit hemmelige credential token fra Dashboard -> Settings -> Integrations som credentialToken request header.

Kan jeg få besked, når en ordre oprettes? 

Ja. Hvis du vil modtage notifikationer ved ordreoprettelse, kan du under Email i Checkout settings i Dashboard angive e-mailadresser for teammedlemmer, der skal underrettes ved oprettelse, afsendelse eller annullering af ordre.