Checkout voor Miva

Binnen 24 uur na aanmelding neemt een toegewijde onboarding-vertegenwoordiger contact met u op om een op maat gemaakt integratieproces te starten.

Belangrijk: De onderstaande stappen zijn ter referentie; u wordt er door uw onboarding-vertegenwoordiger doorheen geleid.

1. Download de module vanuit de Miva App Store, of vraag het bestand zonos.mvc rechtstreeks aan bij Zonos.
2. Ga in uw Miva-beheeromgeving naar Domain Settings -> Modules -> Add Module, upload het bestand zonos.mvc en klik op Add.

3. Ga naar Settings -> Modules, zoek Zonos en klik op Install. Bevestig dat het wordt weergegeven als Installed.

Ga in Miva naar Users -> API Tokens en klik op Add API Token. Configureer het als volgt:

• Name: Zonos Checkout
• Allowed IP Addresses: 0.0.0.0/0, ::/0
• Signature: Require Signature with Key -- klik op Generate om een signeersleutel aan te maken
• Timestamp: Require Timestamp Within 30 seconds

Schakel op het volgende scherm Customer Service & Sales in om het token orders te laten aanmaken en wijzigen. Klik op Save.

Navigeer naar de Checkout-module in Miva via Miva -> Utility Settings -> Zonos, en vul de volgende velden in:

1. Store ID: Kopieer uw Zonos-accountnummer vanuit Dashboard -> Settings -> Account -> Integrations.
2. Zonos API Key: Uw geheime API-sleutel (deel deze nooit).
3. Zonos Public Key: Uw publieke sleutel.
4. Store Currency: De basisvaluta van uw winkel (bijv. USD).
5. Environment: Selecteer Live voor productie of Test voor testen.
6. Checkout Button Selector: CSS-selector voor uw checkout-knop (voorbeeld: a[href*="checkout.html"]).
7. Hidden Selectors: Voor het verbergen van binnenlandse betaalopties en andere details die mogelijk niet relevant zijn voor internationale klanten.
8. Import Orders: Vink aan om voltooide Zonos-bestellingen automatisch te importeren in het Miva-beheerpaneel. Dit vereist dat webhooks zijn geregistreerd in de volgende stap.

Klik rechtsboven op Update om op te slaan voordat u verdergaat.

Bestellingen worden geïmporteerd via webhook in de 10.x-module. Eerdere moduleversies gebruikten in plaats daarvan een order success URL/endpoint.

Klik na het opslaan van uw instellingen op Register Webhooks. Dit koppelt uw winkel aan Zonos, zodat voltooide bestellingen automatisch worden geïmporteerd, annuleringen worden gesynchroniseerd en verzendupdates worden teruggestuurd naar Miva.

Webhooks moeten geregistreerd zijn voordat het importeren van bestellingen, synchronisatie van annuleringen en verzendupdates werken. Het selectievakje Import Orders vereist dat webhooks zijn geregistreerd.

Scroll naar beneden om de resterende velden in te vullen:

1. Miva API Token: Het Access Token van het API-token dat u hebt aangemaakt in de stap Maak een API-token aan.
2. Miva API Signature: De Signing Key van dezelfde API-tokeninvoer.
3. Image Type: Bepaalt welke productafbeeldingsgrootte wordt weergegeven in de Zonos checkout (Main werkt voor de meeste winkels).
4. Additional Field Mappings: Map optioneel Miva custom fields naar Zonos-attributen/metadata (kleur, materiaal, maat, enz.). We raden aan HS code te mappen als u productspecifieke HS-codes hebt ingesteld in uw Miva-productvermeldingen. Dit is niet vereist om een offerte voor invoerrechten en belastingen te genereren, aangezien we productspecifieke HS-codes kunnen gebruiken die u hebt ingevoerd in Catalog, of uw default HS code kunnen gebruiken. Het wordt echter wel aanbevolen; de nauwkeurigheid van landed cost-berekeningen neemt sterk toe bij correct geclassificeerde producten. Om een veld in Miva te mappen, maakt u een custom field aan voor de HS code en mapt u dit onder Utility Settings -> Zonos.

Klik op Update om alle instellingen op te slaan.

Nu u uw account en module hebt ingesteld, bent u klaar om te testen door het volgende te doen:

• Test verzendoffertes
• Plaats een testbestelling op uw site
• Test orderflow door uw systemen
• Test uw website

Leer hoe u deze tests uitvoert. U moet het veld Environment van de module instellen op Test tijdens het testen.

Na het voltooien van testen bent u klaar om live te gaan! Stel Environment in op Live, controleer of uw Zonos-gegevens correct zijn en zorg ervoor dat webhooks zijn geregistreerd op uw live winkel.

1. Ga naar dashboard.zonos.com -> Hello -> Hello Settings.
2. Schakel Currency behavior in.
3. Voer de CSS-selector in die uw productprijselementen target (bijv. .price).

Zonos Hello converteert en toont prijzen automatisch in de lokale valuta van de shopper wanneer dit is ingeschakeld.

Verzendafmetingen, land van oorsprong en HS-code die zijn ingesteld in de Miva-catalogus worden automatisch naar Zonos gemapt en gebruikt voor landed cost-/verzendoffertes indien ingevuld. Er is geen aanvullende mapping nodig om dit te configureren.

Als uw winkel configureerbare producten verkoopt waarbij alle varianten dezelfde SKU delen, slaan Miva's standaard Product Shipping Rules één set afmetingen per product op, waardoor elke configuratie wordt behandeld als hetzelfde formaat, ongeacht wat de klant heeft geselecteerd.

Miva en Zonos ondersteunen afmetingen op variantniveau, maar dat vereist het individueel instellen van elke variant. Dit kan onpraktisch zijn voor winkels met honderden of duizenden configuraties die niet aan afzonderlijke varianten zijn gekoppeld.

Deze functie lost dit op door per-configuratie-afmetingen rechtstreeks uit het winkelmandje bij checkout te lezen, met behulp van de custom logica die uw winkel al heeft om deze te berekenen -- bijvoorbeeld door afmetingen uit de productbeschrijving te halen.

Vereisten

• Uw winkel moet al custom afmetingskolommen op mandartikelen invullen wanneer artikelen aan de winkelwagen worden toegevoegd (dit gebeurt aan de Miva-kant, buiten het bereik van de Zonos-module).
• U moet de exacte kolomnamen kennen die u gebruikt.

Configuratie

Voer deze kolomnamen in bij de drie bijbehorende velden in de Zonos-module admin. Laat ze leeg om terug te vallen op de standaard Product Shipping Rules -- deze functie is volledig opt-in en heeft geen invloed op winkels die er geen gebruik van maken.

Wanneer een verzendlabel wordt aangemaakt of een trackingnummer wordt ingevoerd in het Zonos Dashboard, worden het trackingnummer en de verzendstatus automatisch doorgestuurd naar de bijbehorende bestelling in Miva admin. Hiervoor moeten webhooks zijn geregistreerd (zie de stap Registreer webhooks hierboven).

Tracking kan ook rechtstreeks in Miva worden ingevoerd. Gebruik het invoerdialoogvenster Enter Tracking Number bij elke Zonos-bestelling -- het trackingnummer en de verzendstatus worden automatisch teruggesynchroniseerd naar het Zonos Dashboard.

Het foutopsporingslogboek is toegankelijk binnen Miva admin, onder de instellingen van de Zonos-module. Het registreert de volledige levenscyclus van elke bestelgebeurtenis die de module verwerkt -- imports, tracking-synchronisaties, annuleringen en uitgaande annuleringsverzoeken naar Zonos -- inclusief zowel successen als mislukkingen inline.

Elke invoer bevat het Zonos-bestel-ID, het Miva-bestel-ID en, waar relevant, klantniveaugegevens zoals de foutreactie van de Miva- of Zonos-API. Dit maakt het de meest volledige informatiebron voor het diagnosticeren van problemen.

Het logboek bewaart alleen de meest recente 500 regels. Oudere invoeren worden niet gearchiveerd, dus controleer het logboek direct na een probleem -- eerdere gebeurtenissen kunnen al zijn overschreven.

Openbaar foutenlogboek (geen login vereist) 

Er is een tweede, openbaar toegankelijk logboek beschikbaar via een directe URL -- geen Miva admin-login vereist. Het registreert alleen fouten (geen successen) en bevat geen klant-PII of gevoelige gegevens. Elke invoer wordt voorafgegaan door de moduleversie (bijv. [v10.09]) voor snelle identificatie.

URL-formaat:

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

Voorbeeld:

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: De miva_store_code wordt geretourneerd in de metadata-array van de API-respons voor alle dashboard-bestellingen.

Alle betalingsteruggaven moeten rechtstreeks via het Zonos-dashboard worden verwerkt. De knoppen Refund, Capture en Void in Miva zijn met opzet niet beschikbaar voor via Zonos geïmporteerde bestellingen. Terugbetalingen die in Zonos worden verwerkt, werken de betalingsbedragen op de bijbehorende Miva-bestelling niet automatisch bij -- de Miva-bestelling behoudt de oorspronkelijk vastgelegde bedragen en wordt niet gesynchroniseerd met terugbetalingsactiviteit in Zonos.

Voor orderannuleringen hangt het gedrag af van de huidige status van de bestelling:

• Open (nog niet verzonden): Annuleren in Miva annuleert de bestelling ook in Zonos en maakt de betalingsautorisatie ongeldig. Omdat Zonos pas betaling vastlegt zodra een bestelling wordt verzonden, wordt de klant nooit daadwerkelijk in rekening gebracht en is een aparte terugbetaling niet nodig.
• Verzonden of Voltooid: Annuleren in Miva markeert de Miva-bestelling als geannuleerd, maar Zonos wijst de annulering af omdat de bestelling al is afgehandeld en niet meer in aanmerking komt voor automatische annulering. In dit geval wordt een notitie alleen voor beheerders toegevoegd aan de Miva-bestelling -- alleen zichtbaar voor winkelmedewerkers en nooit voor de klant -- waarin wordt uitgelegd dat de bestelling in Zonos moet worden afgehandeld. Er wordt ook een e-mailmelding verstuurd naar het primaire e-mailadres van het winkelaccount om de handelaar te waarschuwen actie te ondernemen in het Zonos-dashboard, waar ze eventuele toepasselijke terugbetalingen handmatig kunnen verwerken.

Symptoom: Bestellingen worden voltooid in Zonos Checkout en verschijnen in het Zonos-dashboard, maar er verschijnt niets in Miva admin.

Oorzaak: Zonos stuurt een ORDER_CREATED-webhook (HTTP POST) naar het /mm5/json.mvc-endpoint van uw winkel. Op dev sites blokkeert beveiliging op serverniveau dit verzoek vaak voordat het Miva bereikt. Veelvoorkomende oorzaken:

• HTTP Basic Auth -- Als de dev site een wachtwoordprompt heeft (Plesk, cPanel, .htaccess, enz.), wordt de webhook geweigerd met een 401 Unauthorized. Zet de IP-adressen van Zonos op de witte lijst in uw .htaccess- of Plesk-configuratie zodat ze de auth-prompt omzeilen.
• Cloudflare WAF / IP Access Rules -- Als de site via Cloudflare wordt geproxied, kunnen de beveiligingsregels de POST blokkeren voordat deze uw server bereikt. Voeg een WAF-regel toe om POST-verzoeken toe te staan waarbij het URL-pad /mm5/json.mvc bevat, of zet de IP-adressen van Zonos rechtstreeks op de witte lijst in Cloudflare's IP Access Rules.
• IP-toegangslijst op serverniveau -- Als de dev site verkeer beperkt tot specifieke IP-adressen (gebruikelijk bij staging-omgevingen die zijn afgeschermd voor kantoor- of platform-IP's), worden Zonos-webhookverzoeken stilzwijgend genegeerd zonder respons. Voeg alle IP-adressen voor Zonos-webhookaflevering toe aan de toegangslijst van uw server (Plesk IP Access Restriction Manager, cPanel IP Blocker, of uw firewall-/hostingpaneelbeveiligingsregels).

IP-adressen voor Zonos-webhookaflevering

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

Dit heeft doorgaans alleen invloed op dev/staging sites -- productie-Miva-sites zijn meestal openbaar toegankelijk en hebben geen IP-whitelisting nodig. Neem bij twijfel over de configuratie contact op met uw hostingprovider of Miva-support.

Productinformatie kan het bedrag aan verschuldigde invoerrechten en belastingen en de verzendkosten beïnvloeden. Hoe meer productinformatie u aan Zonos levert, hoe preciezer de geretourneerde offerte is. Zonos kan een offerte genereren zelfs wanneer deze informatie niet beschikbaar is, maar raadt aan de volgende belangrijke productdetails te leveren om de nauwkeurigheid te verbeteren:

• Gewicht: Gewicht beïnvloedt uw verzendkosten, wat invoerrechten of belastingen kan beïnvloeden. Gewichten in uw Miva-productlijsten worden automatisch door Zonos gebruikt wanneer aanwezig.
• Afmetingen: Afmetingen kunnen uw verzendkosten beïnvloeden, wat invoerrechten of belastingen kan beïnvloeden. Zonos kan productafmetingen (lengte, breedte en hoogte) gebruiken die op elk product in Miva zijn ingesteld, maar u moet dit mappen in de Zonos app voor correcte integratie.
• HS-codes: HS-codes beïnvloeden invoerrechtentarieven en kunnen soms belastingen beïnvloeden. Zonos kan de HS-codes gebruiken die in uw productlijsten in Miva zijn ingesteld, maar u moet het HS-code-veld mappen in de Zonos app.
• Land van oorsprong: Het land van oorsprong van een product beïnvloedt invoerrechtentarieven en kan belastingen beïnvloeden. Miva kan het land van oorsprong van uw producten niet naar Zonos sturen, dus deze moeten worden toegevoegd via Zonos Catalog.

Productdetails doorgegeven aan Zonos door Miva 

Opmerking: U kunt ook een van bovenstaande gegevens invoeren in Catalog, waarmee de informatie die is opgeslagen en doorgegeven vanuit Miva wordt overschreven.

Meer informatie over productinfo per platform.