Wiederkehrende Käuferinformationen in Zonos Checkout vorab laden.
Kundenprofile optimieren Ihr Checkout-Erlebnis, indem Kunden mit Konto ihre Adress- und Zahlungsdaten vorab laden können.
Diese Funktion ist derzeit nur für benutzerdefinierte API-Integrationen verfügbar. Für Händler, die Checkout-Plugins nutzen, ist diese Funktion noch nicht verfügbar.
Wenn Sie an Wiederverkäufer, Regierungsbehörden oder gemeinnützige Organisationen verkaufen, können Sie auch deren Steuerbefreiungsbescheinigungen mit einem Kundenprofil synchronisieren.
1
Authentifizierte Kundeninformationen senden
Um ein Kundenprofil zu authentifizieren, muss Ihr Backend-Server zwei unabhängige API-Aufrufe durchführen, die wir aus Performance-Gründen parallel auszuführen empfehlen:
createCart: Erstellt den Zonos-Warenkorb. Detaillierte Anleitungen finden Sie im Abschnitt Zonos Checkout einrichten in der Dokumentation zur benutzerdefinierten Integration.
checkoutCustomerProfileAuthenticate: Übermittelt und validiert die Kundeninformationen.
Stellen Sie bei der Validierung der Kundensitzung sicher, dass die customerId, die Sie in der Anfrage übergeben, mit dem richtigen Profil übereinstimmt, um korrekte Kundeninformationen im Checkout anzuzeigen. Beachten Sie, dass Sie beim Erstellen eines Warenkorbs keine customerId in den Metadaten angeben sollten, da diese überschrieben wird.
Nachdem der Kunde authentifiziert wurde und die Bestellung aufgegeben wurde, ist die customerId in order.references verfügbar, wenn Sie Bestelldetails über die Order-Abfrage abrufen, sodass Sie die Bestellung dem richtigen Kunden zuordnen können.
2
Warenkorb mit Kundenprofil erstellen
Nachdem Sie beide Mutationen aufgerufen haben, erhalten Sie Folgendes zurück:
cartId aus der createCart-Mutation zum Erstellen des Warenkorbs.
Ein oneTimePassword aus der checkoutCustomerProfileAuthenticate-Mutation für die Kundenauthentifizierung.
Sie können beide Werte im createCartId-Callback in der Zonos.init-Funktion übergeben, um die bereitgestellten Kundenprofilinformationen im Checkout zu laden.
Beim ersten Übermitteln von Kundeninformationen speichert Zonos die bereitgestellten Kundeninformationen. Zahlungsmethoden werden sicher in Stripe gespeichert. Jedes Mal, wenn neue Adress- oder Zahlungsmethodendetails übermittelt werden, werden sie dem Kundenprofil hinzugefügt.
Adressen und Zahlungsmethoden können nur hinzugefügt werden – vorhandene können nicht bearbeitet oder entfernt werden. Name, E-Mail-Adresse und Telefonnummer eines Kunden können mit checkoutCustomerUpsert aktualisiert werden.
checkoutCustomerProfileAuthenticate setzt voraus, dass der Käufer anwesend ist, da hierbei ein Einmalpasswort für diese Checkout-Sitzung ausgestellt wird. Wenn Sie ein Profil außerhalb eines Checkouts erstellen oder aktualisieren möchten – etwa um Ihre Kundenliste im Voraus zu laden, Profiländerungen aus Ihrem eigenen System zu synchronisieren oder vor der ersten Bestellung eines Kunden Steuerbefreiungen zu hinterlegen – verwenden Sie stattdessen checkoutCustomerUpsert.
Profile werden anhand der customerId zugeordnet. Wiederholte Aufrufe aktualisieren daher dasselbe Profil, anstatt Duplikate zu erstellen. Es ist unbedenklich, dies regelmäßig für Ihre gesamte Kundenliste auszuführen.
Drei Dinge, die Sie zur Anwendung von Aktualisierungen wissen sollten:
Ausgelassene Felder bleiben unverändert. Wird nur name gesendet, wird nur der Name aktualisiert; E-Mail-Adresse und Telefonnummer bleiben unverändert.
Werte können nicht gelöscht werden. Ein leerer Wert wird genauso behandelt wie ein ausgelassenes Feld – es gibt daher keine Möglichkeit, einen einmal gesetzten Namen, eine E-Mail-Adresse oder eine Telefonnummer wieder zu entfernen.
Adressen werden nur hinzugefügt. Ein Standort, der bereits im Profil vorhanden ist, wird nicht dupliziert, und Standorte, die in der Anfrage ausgelassen werden, werden nicht entfernt.
checkoutCustomerUpsert gibt kein oneTimePassword zurück. Um ein Profil in Checkout zu laden,
benötigen Sie weiterhin checkoutCustomerProfileAuthenticate, das eines für diese Sitzung ausstellt.
GraphQL API ReferenceTypes, inputs, and operations used in this guide
Kundenprofile
Kundenprofile
Wiederkehrende Käuferinformationen in Zonos Checkout vorab laden.
Kundenprofile optimieren Ihr Checkout-Erlebnis, indem Kunden mit Konto ihre Adress- und Zahlungsdaten vorab laden können.
Diese Funktion ist derzeit nur für benutzerdefinierte API-Integrationen verfügbar. Für Händler, die Checkout-Plugins nutzen, ist diese Funktion noch nicht verfügbar.
Wenn Sie an Wiederverkäufer, Regierungsbehörden oder gemeinnützige Organisationen verkaufen, können Sie auch deren Steuerbefreiungsbescheinigungen mit einem Kundenprofil synchronisieren.
Authentifizierte Kundeninformationen senden
Um ein Kundenprofil zu authentifizieren, muss Ihr Backend-Server zwei unabhängige API-Aufrufe durchführen, die wir aus Performance-Gründen parallel auszuführen empfehlen:
createCart: Erstellt den Zonos-Warenkorb. Detaillierte Anleitungen finden Sie im Abschnitt Zonos Checkout einrichten in der Dokumentation zur benutzerdefinierten Integration.checkoutCustomerProfileAuthenticate: Übermittelt und validiert die Kundeninformationen.mutation checkoutCustomerProfileAuthenticate($input: CheckoutCustomerProfileAuthenticateInput!) {checkoutCustomerProfileAuthenticate(input: $input) {emailcustomerIdorganizationIdnamephonelocations {administrativeAreacountryCodelocalityline1line2postalCode}oneTimePassword}}Stellen Sie bei der Validierung der Kundensitzung sicher, dass die
customerId, die Sie in der Anfrage übergeben, mit dem richtigen Profil übereinstimmt, um korrekte Kundeninformationen im Checkout anzuzeigen. Beachten Sie, dass Sie beim Erstellen eines Warenkorbs keinecustomerIdin den Metadaten angeben sollten, da diese überschrieben wird.Nachdem der Kunde authentifiziert wurde und die Bestellung aufgegeben wurde, ist die customerId in
order.referencesverfügbar, wenn Sie Bestelldetails über die Order-Abfrage abrufen, sodass Sie die Bestellung dem richtigen Kunden zuordnen können.Warenkorb mit Kundenprofil erstellen
Nachdem Sie beide Mutationen aufgerufen haben, erhalten Sie Folgendes zurück:
cartIdaus dercreateCart-Mutation zum Erstellen des Warenkorbs.Ein
oneTimePasswordaus dercheckoutCustomerProfileAuthenticate-Mutation für die Kundenauthentifizierung.Sie können beide Werte im
createCartId-Callback in derZonos.init-Funktion übergeben, um die bereitgestellten Kundenprofilinformationen im Checkout zu laden.Zonos.init({...checkoutSettings: {...createCartId: async () => {const result = await fetch('https://api.merchant.com/api/get-cart-info',{body: JSON.stringify(payload),method: 'POST',},);const json =await result.json();return {cartId: json.cartId,customerAuthenticationToken:json.customerProfileAuthenticate?.checkoutCustomerProfileAuthenticate.oneTimePassword ||'',};}},}Kundenprofile verwalten
Beim ersten Übermitteln von Kundeninformationen speichert Zonos die bereitgestellten Kundeninformationen. Zahlungsmethoden werden sicher in Stripe gespeichert. Jedes Mal, wenn neue Adress- oder Zahlungsmethodendetails übermittelt werden, werden sie dem Kundenprofil hinzugefügt.
Adressen und Zahlungsmethoden können nur hinzugefügt werden – vorhandene können nicht bearbeitet oder entfernt werden. Name, E-Mail-Adresse und Telefonnummer eines Kunden können mit
checkoutCustomerUpsertaktualisiert werden.Profil ohne Käufer erstellen oder aktualisieren
checkoutCustomerProfileAuthenticatesetzt voraus, dass der Käufer anwesend ist, da hierbei ein Einmalpasswort für diese Checkout-Sitzung ausgestellt wird. Wenn Sie ein Profil außerhalb eines Checkouts erstellen oder aktualisieren möchten – etwa um Ihre Kundenliste im Voraus zu laden, Profiländerungen aus Ihrem eigenen System zu synchronisieren oder vor der ersten Bestellung eines Kunden Steuerbefreiungen zu hinterlegen – verwenden Sie stattdessencheckoutCustomerUpsert.mutation checkoutCustomerUpsert($input: CheckoutCustomerProfileInput!) {checkoutCustomerUpsert(input: $input) {customerIdemailnamephonelocations {administrativeAreacountryCodeline1line2localitypostalCode}}}Profile werden anhand der
customerIdzugeordnet. Wiederholte Aufrufe aktualisieren daher dasselbe Profil, anstatt Duplikate zu erstellen. Es ist unbedenklich, dies regelmäßig für Ihre gesamte Kundenliste auszuführen.Drei Dinge, die Sie zur Anwendung von Aktualisierungen wissen sollten:
namegesendet, wird nur der Name aktualisiert; E-Mail-Adresse und Telefonnummer bleiben unverändert.checkoutCustomerUpsertgibt keinoneTimePasswordzurück. Um ein Profil in Checkout zu laden, benötigen Sie weiterhincheckoutCustomerProfileAuthenticate, das eines für diese Sitzung ausstellt.CheckoutCustomerProfileInput
checkoutCustomerUpsert
War diese Seite hilfreich?