Individuelle Integration

Um zu beginnen, kontaktieren Sie bitte unser Vertriebsteam, um ein Konto zu erstellen und eine Vereinbarung zu unterzeichnen. Nach Unterzeichnung einer Vereinbarung erhalten Sie zwei Mikroeinzahlungen auf Ihr Konto, die verifiziert werden müssen.

Bitte senden Sie diese Mikroeinzahlungsbeträge per E-Mail an accounting@zonos.com mit Ihrer Dashboard-Store-ID (Ihren Vertriebsmitarbeiter in CC setzen).

Nach der Verifizierung werden Ihre Bankdaten unter Dashboard -> Einstellungen -> Abrechnung angezeigt.

Nach Erstellung Ihres Zonos-Kontos müssen Sie Einstellungen im Dashboard konfigurieren, damit Checkout ordnungsgemäß mit Ihrem Shop funktioniert. Dieser Abschnitt behandelt alle wesentlichen Dashboard-Konfigurationen.

Auszahlungen einrichten 

Verbinden Sie ein Bankkonto, um rechtzeitige Auszahlungen von Checkout zu erhalten. Auszahlungen werden täglich mit einer Verzögerung von 2 Tagen ab dem erfassten Zahlungseingang verarbeitet. Befolgen Sie dazu diese Schritte:

1. Navigieren Sie zu Dashboard -> Einstellungen -> Checkout-Einstellungen .
2. Klicken Sie auf Bankkonto hinzufügen
3. Sie werden zu einem Stripe-Portal weitergeleitet, um die Einrichtung abzuschließen und folgende Informationen anzugeben:
   • Bankkontoinformationen.
   • Unternehmens-EIN.
   • Social Security Number eines Unternehmensinhabers mit 25 %. Weitere Details, warum dies erforderlich ist, finden Sie in Stripes Dokumentation.

Hinweis: Wenn Sie Ihren Auszahlungsplan aktualisieren müssen, kontaktieren Sie bitte support@zonos.com

Zugelassene Domains einrichten 

Das Zonos-JS-Skript benötigt aus Sicherheitsgründen eine Liste zugelassener Domains. Dies verhindert, dass nicht autorisierte Websites das Skript laden, und stellt sicher, dass es nur auf Ihren genehmigten Domains ausgeführt wird. Ohne diese Konfiguration gibt das Skript Berechtigungsfehler zurück.

So richten Sie dies ein:

1. Navigieren Sie zu Dashboard -> Einstellungen -> Checkout-Einstellungen
2. Fügen Sie unter URLs Ihre vollständige Domain und alle Subdomains hinzu, auf denen Checkout verwendet wird. Wenn Ihre Domain beispielsweise example.com ist, sollten Sie example.com und test.example.com hinzufügen.

Branding-Einstellungen anpassen 

Konfigurieren Sie Ihre Branding-Einstellungen im Dashboard passend zum Erscheinungsbild Ihres Shops.

Befolgen Sie dazu diese Schritte:

1. Navigieren Sie zu Dashboard -> Einstellungen -> Checkout-Einstellungen -> Branding
2. Konfigurieren Sie folgende Einstellungen:
   • Logo.
   • Marken- und Akzentfarbe.
   • Theme, Stil und Schriftart.

Weitere Informationen zu Branding-Einstellungen finden Sie in unserer Dokumentation.

Versandcarrier verbinden 

Um Versand beim Checkout anzubieten, müssen Sie einen Versandcarrier mit Ihrem Zonos-Konto verbinden. So können Sie bestimmte Versandservice-Level beim Checkout aktivieren.

So verbinden Sie einen Versandcarrier:

1. Navigieren Sie zu Dashboard -> Einstellungen -> Versand -> Tarife
2. Klicken Sie auf Carrier hinzufügen
3. Befolgen Sie die Carrier-Einrichtungsanweisungen.

Weitere Details zum Verbinden von Carrier-Konten finden Sie in unserer Dokumentation.

Versandzonen einrichten 

Versandzonen ermöglichen es Ihnen zu konfigurieren, welche Versandcarrier und Service-Level für verschiedene Regionen der Welt verfügbar sind.

So richten Sie Versandzonen ein:

1. Navigieren Sie zu Dashboard -> Einstellungen -> Versand -> Standorte
2. Klicken Sie auf Neue Zone
3. Geben Sie einen Zonennamen ein und wählen Sie die Länder aus, in die Sie versenden möchten.
4. Wählen Sie den Carrier und das Service-Level, das Sie anbieten möchten.

Weitere Details zu Versandzonen finden Sie in unserer Dokumentation.

Fallback-Ursprungsland und HS-Code einrichten 

Ursprungsland und HS-Code werden zur Berechnung genauer Zölle und Steuern verwendet.

Wenn Sie kein spezifisches Ursprungsland oder keinen HS-Code angeben, verwenden wir die im Dashboard eingerichteten Fallbacks.

So legen Sie Ihr Fallback-Ursprungsland und den HS-Code fest:

1. Navigieren Sie zu Dashboard -> Einstellungen -> Versand -> Katalog.
2. Wählen Sie für das Ursprungsland das Land, in dem die Mehrheit Ihrer Produkte hergestellt wird.
3. Geben Sie für den HS-Code den HS-Code Ihres häufigsten Produkts ein. Wenn Sie keinen HS-Code haben, navigieren Sie zu Classify im Dashboard und geben Sie Name und Beschreibung Ihres Produkts ein, um einen genauen HS-Code zu generieren.

Das Zonos-JS-Snippet ist eine clientseitige JavaScript-Integration, die globale Checkout-Funktionalität auf Ihrer Website ermöglicht. Es dient als Brücke zwischen Ihrer E-Commerce-Plattform und Zonos-Diensten und übernimmt:

• Checkout-Erlebnis: Rendert die Checkout-Oberfläche und verarbeitet Zahlungen.
• Standortdienste: Erkennt den Standort des Besuchers und verwaltet die Währungsumrechnung.
• Warenkorb-Integration: Verbindet sich mit Ihrem bestehenden Warenkorb- und Bestellsystem.
• Sicherheit: Validiert Domains und authentifiziert API-Anfragen.

Das Snippet wird asynchron geladen, um die Leistung Ihrer Website nicht zu beeinträchtigen. Es initialisiert mit den API-Anmeldedaten Ihres Shops und verarbeitet alle clientseitigen Interaktionen sicher. Die Implementierung ist unaufdringlich gestaltet und erfordert minimale Änderungen an Ihrem bestehenden Checkout-Ablauf.

Unten finden Sie ein vollständiges Beispiel mit Skript-Laden, Initialisierung und Event-Handling als Referenz für die Checkout-Integration.

4. Übergeben Sie die entsprechenden IDs über Ihr Checkout-customHTML, damit das Relay weiß, gegen welche Property bzw. welchen Pixel es feuern soll:

Schritt-für-Schritt-Iframe-Anweisungen, die vollständige Event-Referenz (einschließlich purchase / Purchase-Payload-Mapping) und Debugging-Tipps finden Sie hier:

• Google Analytics 4 für iframe Checkout
• Facebook Pixel für iframe Checkout

Um Bestellungen zwischen Ihrem System und Zonos Dashboard zu synchronisieren, implementieren Sie diese API-Aufrufe und Webhooks:

Erforderliche Mutationen 

Erforderliche Webhooks 

Bevor Sie Ihre Checkout-Integration live schalten, ist es wichtig, alle Aspekte der Integration gründlich zu testen, um ein reibungsloses Kundenerlebnis sicherzustellen. Dazu gehören Tests des Checkout-Ablaufs, der Zahlungsabwicklung, der Bestellerstellung und der Webhook-Funktionalität.

Befolgen Sie unseren Testleitfaden, um zu überprüfen, ob Ihre Integration korrekt funktioniert, und um Probleme zu identifizieren und zu beheben, bevor Sie in die Produktion gehen.

Nachfolgend finden Sie einige häufige Fragen zum Integrationsprozess.

Wie behandelt Zonos die Bestellbestätigung? 

Konfigurieren Sie das Erlebnis nach dem Kauf unter Dashboard -> Einstellungen -> Checkout-Einstellungen unter Success page type. Drei Optionen stehen zur Verfügung:

• Show Zonos success page (Standard, empfohlen) – Zonos zeigt nach der Bestellung eine integrierte Dankeseite an. Die Seite wird immer angezeigt, auch wenn der Import der Bestellung in Ihr System fehlschlägt, sodass der Käufer immer eine Bestätigung erhält.
• Redirect to a success page – Zonos wartet auf einem kurzen „Order complete“-Bildschirm, bis die Bestellung erstellt wurde, und leitet dann zu Ihrer konfigurierten Erfolgs-URL mit zOrderNumber (und orderId für Legacy-Warenkörbe) als Query-Parameter weiter.
• Close the checkout modal – Zonos schließt sein Modal, sobald die Zahlung erfasst wurde. Wenn Sie auch eine Erfolgs-URL konfigurieren, leitet Zonos sofort nach der Zahlungserfassung durch Stripe zu dieser URL weiter – ohne auf die Bestellerstellung zu warten – und hängt zonosCheckoutSessionId als Query-Parameter an. Verwenden Sie diese Option, wenn Sie die schnellste Rückgabe zu Ihrer eigenen Erfolgsseite wünschen.

Bestellung über zonosCheckoutSessionId nachschlagen 

Wenn Sie Close the checkout modal mit einer Redirect-URL verwenden, kann es einige Sekunden dauern, bis die Bestellung nach dem Redirect an die Checkout-Session angehängt wird. Lesen Sie zonosCheckoutSessionId aus der URL und pollen Sie die checkoutSession-GraphQL-Abfrage von Ihrem Server mit Ihrem geheimen Credential-Token, bis die Bestellung bereit ist. Rufen Sie dies niemals vom Browser aus auf – das geheime Credential-Token muss serverseitig bleiben.

Senden Sie die Abfrage an https://api.zonos.com/graphql mit Ihrem geheimen Credential-Token aus Dashboard -> Einstellungen -> Integrationen als credentialToken-Request-Header.

Kann ich benachrichtigt werden, wenn eine Bestellung erstellt wird? 

Ja. Wenn Sie Benachrichtigungen erhalten möchten, wenn eine Bestellung erstellt wird, können Sie im Dashboard unter dem Abschnitt E-Mail der Checkout-Einstellungen die E-Mail-Adressen der Teammitglieder eingeben, die bei Erstellung, Versand oder Stornierung einer Bestellung benachrichtigt werden sollen.