Checkout for Miva

Innen 24 timer etter registrering vil en dedikert onboarding-representant kontakte deg for å starte en skreddersydd integrasjonsprosess.

Viktig: Trinnene oppført nedenfor er til referanse, og du vil bli veiledet gjennom dem av onboarding-representanten din.

1. Last ned modulen fra Miva App Store, eller be Zonos om zonos.mvc-filen direkte.
2. I Miva-administrasjonen går du til Domeneinnstillinger -> Moduler -> Legg til modul, laster opp zonos.mvc-filen og klikker Legg til.

3. Gå til Innstillinger -> Moduler, finn Zonos og klikk Installer. Bekreft at den vises som Installert.

I Miva går du til Brukere -> API-tokener og klikker Legg til API-token. Konfigurer det som følger:

• Name: Zonos Checkout
• Allowed IP Addresses: 0.0.0.0/0, ::/0
• Signature: Krev signatur med nøkkel -- klikk Generer for å opprette en signeringsnøkkel
• Timestamp: Krev tidsstempel innen 30 sekunder

På neste skjermbilde aktiverer du Customer Service & Sales for å tillate at tokenet kan opprette og endre ordrer. Klikk Lagre.

Naviger til Checkout-modulen i Miva ved å gå til Miva -> Systemutvidelser -> Zonos, og fyll deretter ut følgende felter:

1. Store ID: Kopier Zonos-kontonummeret ditt fra Dashboard -> Settings -> Account -> Integrations.
2. Zonos API Key: Din hemmelige API-nøkkel (del aldri denne).
3. Zonos Public Key: Din offentlige nøkkel.
4. Store Currency: Butikkens basisvaluta (f.eks. USD).
5. Environment: Velg Live for produksjon eller Test for testing.
6. Checkout Button Selector: CSS-velger for kasseknappen din (eksempel: a[href*="checkout.html"]).
7. Hidden Selectors: For å skjule innenlandske betalingsalternativer og andre detaljer som kanskje ikke er relevante for internasjonale kunder.
8. Import Orders: Merk av for å automatisk importere fullførte Zonos-ordrer til Miva-administrasjonen. Dette krever at webhooker registreres i neste steg.

Klikk Oppdater øverst til høyre for å lagre før du fortsetter.

Ordrer importeres via webhook i 10.x-modulen. Tidligere moduleversjoner brukte i stedet en URL/endepunkt for ordrebekreftelse.

Når du har lagret innstillingene dine, klikker du Registrer webhooker. Dette kobler butikken din til Zonos, slik at fullførte ordrer importeres automatisk, kanselleringer synkroniseres, og fraktoppdateringer sendes tilbake til Miva.

Webhooker må registreres før ordreimportering, kanselleringssynkronisering og fraktoppdateringer fungerer. Avmerkingsboksen Import Orders krever at webhooker er registrert.

Bla nedover for å fylle ut de resterende feltene:

1. Miva API Token: Access Token fra API-tokenet du opprettet i steget Opprett et API-token.
2. Miva API Signature: Signing Key fra den samme API-token-oppføringen.
3. Image Type: Velger hvilken produktbildestørrelse som vises i Zonos-kassen (Main fungerer for de fleste butikker).
4. Additional Field Mappings: Du kan eventuelt tilordne egendefinerte Miva-felter til Zonos-attributter/-metadata (farge, materiale, størrelse osv.). Vi anbefaler å tilordne HS-kode hvis du har angitt produktspesifikke HS-koder i Miva-produktoppføringene dine. Dette er ikke påkrevd for å produsere et toll- og skattetilbud, siden vi kan bruke produktspesifikke HS-koder du har angitt i Catalog, eller bruke din standard HS-kode. Det anbefales likevel; nøyaktigheten til beregninger av landed cost vil øke betraktelig med korrekt klassifiserte produkter. For å tilordne et felt i Miva oppretter du et egendefinert felt for HS-koden og tilordner det deretter under Systemutvidelser -> Zonos.

Klikk Oppdater for å lagre alle innstillingene.

Nå som du har satt opp kontoen og modulen din, er du klar til å teste ved å gjøre følgende:

• Test fraktanbudet
• Plassér en testbestilling på nettstedet ditt
• Test bestillingsflyt gjennom systemene dine
• Test nettstedet ditt

Lær hvordan du kjører disse testene. Du må sette modulens Environment-felt til Test mens du tester.

Etter å ha fullført testingen er du nå klar til å gå live! Sett Environment til Live, bekreft at Zonos-legitimasjonene dine er riktige, og sørg for at webhooker er registrert på den aktive butikken din.

1. Gå til dashboard.zonos.com -> Hello -> Hello Settings.
2. Slå på Currency behavior.
3. Angi CSS-velgeren som treffer produktpriselementene dine (f.eks. .price).

Zonos Hello vil automatisk konvertere og vise priser i kjøperens lokale valuta når dette er aktivert.

Fraktdimensjoner, opprinnelsesland og HS-kode som er angitt i Miva-katalogen, tilordnes automatisk til Zonos og brukes til landed cost-/fraktanbud hvis de er fylt ut. Det kreves ingen ytterligere tilordning for å konfigurere dette.

Hvis butikken din selger konfigurerbare produkter der alle variasjoner deler ett enkelt SKU, lagrer Mivas standard Product Shipping Rules ett sett med dimensjoner per produkt, slik at hver konfigurasjon behandles som samme størrelse uansett hva kunden valgte.

Miva og Zonos støtter dimensjoner på variantnivå, men det krever at hver variant settes opp individuelt. Dette kan være upraktisk for butikker med hundrevis eller tusenvis av konfigurasjoner som ikke tilordnes til diskrete varianter.

Denne funksjonen løser dette ved å lese dimensjoner per konfigurasjon direkte fra handlekurven i kassen, ved hjelp av den egendefinerte logikken butikken din allerede har på plass for å beregne dem -- for eksempel ved å hente ut dimensjoner fra produktbeskrivelsen.

Krav

• Butikken din må allerede fylle ut egendefinerte dimensjonskolonner på handlekurvvarer når varer legges i handlekurven (håndteres på Miva-siden, utenfor omfanget til Zonos-modulen).
• Du må vite de nøyaktige kolonnenavnene du bruker.

Konfigurasjon

Angi disse kolonnenavnene i de tre tilhørende feltene i Zonos-modulens administrasjon. La dem stå tomme for å falle tilbake til standard Product Shipping Rules -- funksjonen er fullstendig opt-in og påvirker ikke butikker som ikke bruker den.

Når en fraktetikett opprettes eller et sporingsnummer angis i Zonos Dashboard, sendes sporingsnummeret og forsendelsesstatusen automatisk til den tilsvarende ordren i Miva-administrasjonen. Dette krever at webhooker er registrert (se steget Registrer webhooker ovenfor).

Sporing kan også angis direkte i Miva. Bruk dialogboksen Enter Tracking Number på en hvilken som helst Zonos-ordre -- sporingsnummeret og forsendelsesstatusen synkroniseres automatisk tilbake til Zonos Dashboard.

Feilsøkingsloggen er tilgjengelig inne i Miva-administrasjonen, under innstillingene for Zonos-modulen. Den registrerer hele livssyklusen til hver ordrehendelse modulen behandler -- importeringer, sporingssynkroniseringer, kanselleringer og utgående kanselleringsforespørsler til Zonos -- inkludert både vellykkede og mislykkede hendelser fortløpende.

Hver oppføring inkluderer Zonos-ordre-ID-en, Miva-ordre-ID-en, og der det er relevant, kundenivådetaljer som feilresponsen fra Miva- eller Zonos-API-et. Dette gjør den til den mest komplette informasjonskilden for å diagnostisere problemer.

Loggen beholder bare de siste 500 linjene. Eldre oppføringer arkiveres ikke, så sjekk den umiddelbart etter at et problem oppstår -- tidligere hendelser kan allerede ha blitt overskrevet.

Offentlig feillogg (ingen innlogging kreves) 

En andre, offentlig tilgjengelig logg er tilgjengelig via direkte URL -- ingen innlogging i Miva-administrasjonen kreves. Den registrerer kun feil (ingen vellykkede hendelser) og inneholder ingen kunde-PII eller sensitive data. Hver oppføring er prefikset med modulversjonen (f.eks. [v10.09]) for rask identifisering.

URL-format:

https://[store-domain]/mm5/json.mvc?Store_Code=[miva_store_code]&Function=Module&Module_Code=igs&Session_Type=runtime&Module_Function=JSON_WebHook&publiclog=1

Eksempel:

https://dts4509.mivamerchantdev.com/mm5/json.mvc?Store_Code=Test&Function=Module&Module_Code=igs&Session_Type=runtime&Module_Function=JSON_WebHook&publiclog=1

Store Code: miva_store_code returneres i metadata-arrayen i API-responsen for alle dashboard-ordrer.

Alle betalingsrefusjoner må behandles direkte gjennom Zonos Dashboard. Knappene Refund, Capture og Void i Miva er av design ikke tilgjengelige for Zonos-importerte ordrer. Eventuelle refusjoner behandlet i Zonos vil ikke automatisk oppdatere betalingsbeløpene på den tilsvarende Miva-ordren -- Miva-ordren beholder de opprinnelige belastede beløpene og holdes ikke synkronisert med refusjonsaktivitet i Zonos.

For ordrekanselleringer avhenger oppførselen av ordrens gjeldende status:

• Open (ennå ikke sendt): Kansellering i Miva vil også kansellere den i Zonos og annullere betalingsautorisasjonen. Fordi Zonos ikke belaster betaling før en ordre sendes, blir kunden aldri faktisk belastet, og ingen separat refusjon er nødvendig.
• Shipped eller Completed: Kansellering i Miva vil markere Miva-ordren som kansellert, men Zonos vil avvise kanselleringen fordi ordren allerede er fullført og ikke lenger kvalifiserer for automatisk kansellering. I dette tilfellet legges det til et notat kun synlig for administratorer på Miva-ordren -- synlig kun for butikkens ansatte og aldri for kunden -- som forklarer at ordren må håndteres i Zonos. Det sendes også en e-postvarsling til butikkontoens primære e-postadresse som varsler forhandleren om å handle i Zonos Dashboard, der de kan behandle eventuell refusjon manuelt.

Symptom: Ordrer fullføres i Zonos Checkout og vises i Zonos Dashboard, men ingenting vises i Miva-administrasjonen.

Årsak: Zonos sender en ORDER_CREATED-webhook (HTTP POST) til butikkens /mm5/json.mvc-endepunkt. På utviklingsnettsteder blokkerer sikkerhet på servernivå ofte denne forespørselen før den når Miva. Vanlige årsaker:

• HTTP Basic Auth -- Hvis utviklingsnettstedet har en passordforespørsel (Plesk, cPanel, .htaccess osv.), blir webhooken avvist med en 401 Unauthorized. Sett Zonos' IP-er på hviteliste i .htaccess- eller Plesk-konfigurasjonen din, slik at de omgår passordforespørselen.
• Cloudflare WAF / IP Access Rules -- Hvis nettstedet er proxyet gjennom Cloudflare, kan sikkerhetsreglene blokkere POST-forespørselen før den når serveren din. Legg til en WAF-regel som tillater POST-forespørsler der URL-stien inneholder /mm5/json.mvc, eller sett Zonos' IP-er på hviteliste direkte i Cloudflares IP Access Rules.
• Server-level IP allowlist -- Hvis utviklingsnettstedet begrenser trafikk til bestemte IP-er (vanlig på testmiljøer låst til kontor- eller plattform-IP-er), blir Zonos' webhook-forespørsler stille forkastet uten respons. Legg til alle Zonos' webhook-leverings-IP-er i serverens hviteliste (Plesk IP Access Restriction Manager, cPanel IP Blocker, eller sikkerhetsreglene i brannmuren/hostingpanelet ditt).

Zonos' webhook-leverings-IP-er

195.85.106.100/32
67.207.37.24/29
18.118.243.230/32
18.191.115.116/32
18.216.243.49/32
18.218.198.53/32
18.221.118.18/32
18.223.39.35/32
3.128.123.176/32
3.132.179.92/32
3.138.165.252/32
3.19.11.176/32
3.22.153.63/32
52.15.215.38/32

Dette påvirker vanligvis kun utviklings-/testnettsteder -- produksjons-Miva-nettsteder er vanligvis offentlige og trenger ikke IP-hviteliste. Hvis du er usikker på hvordan du konfigurerer dette, kontakt hostingleverandøren din eller Miva-support.

Produktinformasjon kan påvirke mengden toll og skatter som skal betales og fraktekostnaden. Jo mer produktinformasjon du gir til Zonos, desto mer presist vil tilbudet som returneres være. Zonos kan generere et tilbud selv når denne informasjonen er utilgjengelig, men anbefaler å gi følgende nøkkelproduktdetaljer for å forbedre nøyaktigheten:

• Vekt: Vekt påvirker fraktekostnaden din, som kan påvirke toll eller skatter. Vekter i produktoppføringene dine i Miva brukes automatisk av Zonos når de er til stede.
• Dimensjoner: Dimensjoner kan påvirke fraktekostnaden din, som kan påvirke toll eller skatter. Zonos kan bruke produktdimensjoner (lengde, bredde og høyde) angitt på hvert produkt i Miva, men du må tilordne det i Zonos-appen for riktig integrasjon.
• HS-koder: HS-koder påvirker tollsatser og kan noen ganger påvirke skatter. Zonos kan bruke HS-kodene angitt i produktoppføringene dine i Miva, men du må tilordne HS-kodefeltet i Zonos-appen.
• Opprinnelsesland: Opprinnelseslandet til et produkt påvirker tollsatser og kan påvirke skatter. Miva kan ikke sende opprinnelseslandet for produktene dine til Zonos, så de må legges til ved hjelp av Zonos Catalog.

Produktdetaljer som sendes til Zonos av Miva 

Merk: Alternativt kan du skrive inn noen av informasjonen ovenfor i katalogen, noe som overstyrer informasjonen som er lagret og sendt fra Miva.

Lær mer om produktinformasjon etter plattform.