Egendefinert integrasjon

For å komme i gang, vennligst kontakt salgsteamet vårt for å opprette en konto og signere en avtale. Når avtalen er signert, mottar du to mikroinnskudd på kontoen som må bekreftes.

Send disse mikroinnskuddsbeløpene per e-post til accounting@zonos.com med din Dashboard-butikkID (CC salgsrepresentanten din).

Når de er bekreftet, vil bankopplysningene dine vises i Dashboard -> Settings -> Billing.

Etter å ha opprettet Zonos-kontoen din, må du konfigurere innstillinger i Dashboard for å sikre at Checkout fungerer riktig med butikken din. Dette avsnittet dekker alle essensielle Dashboard-konfigurasjoner.

Sett opp utbetalinger 

Koble til en bankkonto for å motta rettidige utbetalinger fra Checkout. Utbetalinger behandles daglig med en forsinkelse på 2 dager fra betalingen er fanget opp. For å gjøre dette, vennligst følg disse trinnene:

1. Naviger til Dashboard -> Settings -> Checkout settings .
2. Klikk Add bank account
3. Du blir ført til en Stripe-portal for å fullføre oppsettet og oppgi følgende informasjon:
   • Bankkontoinformasjon.
   • Bedrifts-EIN.
   • Personnummer for en 25% bedriftseier. For mer informasjon om hvorfor dette er påkrevd, se Stripes dokumentasjon.

Merk: Hvis du trenger å oppdatere utbetalingsplanen din, kontakt support@zonos.com

Sett opp tillatte domener 

Zonos JS-scriptet krever en liste over tillatte domener av sikkerhetshensyn. Dette forhindrer uautoriserte nettsteder fra å laste inn scriptet og sikrer at det bare kjøres på dine godkjente domener. Uten denne konfigurasjonen returnerer scriptet tillatelsesfeil.

For å sette dette opp:

1. Naviger til Dashboard -> Settings -> Checkout settings
2. Under URLs legger du til ditt fullstendige domene og eventuelle underdomener der Checkout skal brukes. For eksempel, hvis ditt domene er example.com, bør du legge til både example.com og test.example.com.

Tilpass merkevareinnstillinger 

Konfigurer merkevareinnstillingene dine i Dashboard slik at de samsvarer med butikkens utseende og preg.

For å gjøre dette, vennligst følg disse trinnene:

1. Naviger til Dashboard -> Settings -> Checkout settings -> Branding
2. Konfigurer følgende innstillinger:
   • Logo.
   • Merke- og aksentfarge.
   • Tema, stil og skrifttype.

For mer informasjon om merkevareinnstillinger, se vår dokumentasjon.

Koble til en fraktbærer 

For å oppgi frakt under kassen, må du koble til en fraktbærer med Zonos-kontoen din. Dette lar deg aktivere spesifikke frakttjenestenivåer ved kassen.

For å koble til en fraktbærer, vennligst følg disse trinnene:

1. Naviger til Dashboard -> Settings -> Shipping -> Rates
2. Klikk Add carrier
3. Følg instruksjonene for bæreroppsettet.

For mer informasjon om å koble til bærerkonto, se vår dokumentasjon.

Sett opp fraktsoner 

Fraktsoner lar deg konfigurere hvilke fraktbærere og tjenestenivåer som er tilgjengelige for forskjellige regioner i verden.

For å sette opp fraktsoner, vennligst følg disse trinnene:

1. Naviger til Dashboard -> Settings -> Shipping -> Locations
2. Klikk New zone
3. Skriv inn et sonenavn og velg landene du vil sende til.
4. Velg bærer og tjenestenivå du vil tilby.

For mer informasjon om fraktsoner, se vår dokumentasjon.

Sett opp et fallback-land for opprinnelse og HS-kode 

Landet for opprinnelse og HS-koden brukes til å beregne nøyaktig toll og skatter.

Hvis du ikke oppgir et spesifikt land for opprinnelse eller HS-kode, vil vi bruke standardinnstillingene som er satt opp i Dashboard.

For å angi dine fallback-verdier for land for opprinnelse og HS-kode:

1. Naviger til Dashboard -> Settings -> Shipping -> Catalog.
2. For landet for opprinnelse, velg landet der størstedelen av produktene dine produseres.
3. For HS-koden, skriv inn HS-koden for ditt vanligste produkt. Hvis du ikke har en HS-kode, naviger til Classify i Dashboard og skriv inn navn og beskrivelse på produktet ditt for å generere en nøyaktig HS-kode.

Zonos JS-snippet er en klient-side JavaScript-integrasjon som aktiverer global kassefunksjonalitet på nettstedet ditt. Det fungerer som broen mellom e-handelsplattformen din og Zonos-tjenester, og håndterer:

• Checkout Experience: Gjengir kassebrukergrensesnittet og behandler betalinger.
• Location Services: Oppdager besøkendes plassering og administrerer valutakonvertering.
• Cart Integration: Kobler sammen med din eksisterende handlekurv og ordresystem.
• Security: Validerer domener og autentiserer API-forespørsler.

Snippetet lastes asynkront for å forhindre påvirkning på nettstedets ytelse. Det initialiseres med API-legitimasjonen til butikken din og håndterer all sikker klient-side interaksjon. Implementasjonen er designet for å være ikke-påtrengende, og krever minimale endringer i eksisterende kasseflyten din.

Nedenfor er et komplett eksempel som inkluderer scriptlasting, initialisering og hendelseshåndtering for referanse ved integrasjon av Checkout.

4. Overfør de tilsvarende ID-ene gjennom din Checkout customHTML slik at releiet vet hvilken eiendom/piksel du skal avfyre:

For trinnvis iframe-instruksjoner, hele hendelsesreferansen (inkludert nyttelast-kartleggingen for purchase / Purchase), og feilsøkingstips, se:

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

For å synkronisere bestillinger mellom systemet ditt og Zonos Dashboard, implementerer du disse API-anropene og webhooks:

Nødvendige mutasjoner 

Nødvendige webhooks 

Før du går live med Checkout-integrasjonen din, er det viktig å grundig teste alle aspekter av integrasjonen for å sikre en jevn kundeopplevelse. Dette inkluderer testing av kasseflyten, betalingsbehandling, ordreopprettelse og webhook-funksjonalitet.

Følg vår testguide for å verifisere at integrasjonen din fungerer korrekt, og for å identifisere og fikse eventuelle problemer før lansering til produksjon.

Nedenfor er noen vanlige spørsmål om integrasjonsprosessen.

Hvordan håndterer Zonos ordrebekreftelse? 

Konfigurer opplevelsen etter kjøp i Dashboard -> Settings -> Checkout settings under Success page type. Tre alternativer er tilgjengelige:

• Show Zonos success page (standard, anbefalt) — Zonos viser en innebygd takk-side etter at bestillingen er plassert. Siden vises alltid, selv om bestillingen ikke importeres til systemet ditt, slik at kjøperen alltid får en bekreftelse.
• Redirect to a success page — Zonos venter på en kort «Ordre fullført»-skjerm til bestillingen er opprettet, og omdirigerer deretter til den konfigurerte suksess-URL-en din med zOrderNumber (og orderId for eldre handlekurver) lagt til som spørreparametere.
• Close the checkout modal — Zonos lukker sin modal når betalingen hentes inn. Hvis du også konfigurerer en suksess-URL, omdirigerer Zonos til den URL-en umiddelbart etter at Stripe samler inn betalingen — uten å vente på at bestillingen skal opprettes — og legger til zonosCheckoutSessionId som en spørreparameter. Bruk dette alternativet når du vil ha den raskeste overføringen tilbake til din egen suksess-side.

Slå opp bestillingen fra zonosCheckoutSessionId 

Når du bruker Close the checkout modal med en omdirigerings-URL, kan det hende at bestillingen tar noen få sekunder å knytte seg til checkout-sesjonen etter omdirigeringen. Les zonosCheckoutSessionId fra URL-en og poll checkoutSession-GraphQL-spørringen fra serveren din ved hjelp av din hemmelige legitimasjontoken inntil bestillingen er klar. Kall aldri dette fra nettleseren — den hemmelige legitimasjontoken må holdes på serversiden.

Send spørringen til https://api.zonos.com/graphql med din hemmelige legitimasjontoken fra Dashboard -> Settings -> Integrations sendt som credentialToken-forespørselshoder.

Kan jeg bli varslet når en ordre opprettes? 

Ja. Hvis du vil motta varslinger når en ordre opprettes, i Dashboard under Email-delen av Checkout settings, kan du oppgi e-postadressen til teammedlemmene som bør varsles når en ordre opprettes, sendes eller kanselleres.