Følg denne omfattende tjekliste for at opsætte din Zonos Dashboard-konto og integrere Zonos Checkout i dit brugerdefinerede site eller platform.
1
Opret en Zonos-konto
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.
2
Konfigurer Dashboard- og Checkout-indstillinger
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.
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:
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.
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.
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.
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:
Gå til Dashboard -> Settings -> Shipping -> Catalog.
For oprindelsesland skal du vælge det land, hvor størstedelen af dine produkter fremstilles.
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.
3
Installer Zonos JS-snippet
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.
1
Send de tilsvarende ID'er via Checkout customHTML, så relay'et ved, hvilken property/pixel der skal udløses mod:
1
For trin-for-trin iframe-instruktioner, den fulde event-reference (inkl. purchase / Purchase payload-mapping) og debugging-tips, se:
Synkroniserer dit native kontonummer med Dashboard. Docs →
orderAddTrackingNumber
Kun påkrævet, hvis du ikke udskriver labels i Dashboard. Sikrer, at tracking vises i Dashboard, så Zonos kan garantere dine Landed Cost-beregninger. Docs →
Nødvendig for at sende Checkout-ordrer til din native platform. Docs →
ORDER_STATUS_CHANGED
Holder dit system synkroniseret med Zonos, når ordrestatus ændres (f.eks. fulfilled, canceled). Docs →
7
Test din integration
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.
Almindelige spørgsmål
Nedenfor er nogle almindelige spørgsmål om integrationsprocessen.
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.
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.
1query getCheckoutSession($id: String!){
2 checkoutSession(id:$id) {
3 order
4 id
Send query til https://api.zonos.com/graphql med dit hemmelige credential token fra Dashboard -> Settings -> Integrations som credentialToken request header.
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.
Brugerdefineret integration
Brugerdefineret integration
Byg en end-to-end Checkout-integration ind i dit brugerdefinerede site.
Integrations-tjekliste
Følg denne omfattende tjekliste for at opsætte din Zonos Dashboard-konto og integrere Zonos Checkout i dit brugerdefinerede site eller platform.
Opret en Zonos-konto
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.
Konfigurer Dashboard- og Checkout-indstillinger
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:
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:
example.com, skal du tilføjeexample.comogtest.example.com.Tilpas branding-indstillinger
Konfigurer branding-indstillinger i Dashboard, så de matcher din butiks udseende.
Følg disse trin:
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:
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:
Se vores dokumentation 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:
Installer Zonos JS-snippet
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:
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.
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/Purchasepayload-mapping) og debugging-tips, se:Synkroniser ordresporing og status til Dashboard
For at synkronisere ordrer mellem dit system og Zonos Dashboard skal du implementere disse API-kald og webhooks:
Påkrævede mutationer
orderUpdateAccountOrderNumberorderAddTrackingNumberPåkrævede webhooks
ORDER_CREATEDORDER_STATUS_CHANGEDTest din integration
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.
Almindelige spørgsmål
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:
zOrderNumber(ogorderIdfor legacy-kurve) som query-parametre.zonosCheckoutSessionIdsom query-param. Brug dette, når du vil have hurtigst mulig overdragelse til din egen success-side.Slå ordren op via
zonosCheckoutSessionIdNå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
zonosCheckoutSessionIdfra URL'en og pollcheckoutSessionGraphQL-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.query getCheckoutSession($id: String!) {checkoutSession(id: $id) {orderidSend query til
https://api.zonos.com/graphqlmed dit hemmelige credential token fra Dashboard -> Settings -> Integrations somcredentialTokenrequest 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.
Var denne side nyttig?