DOCS

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.

Profil ohne Käufer erstellen oder aktualisieren 

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.

1mutation checkoutCustomerUpsert($input: CheckoutCustomerProfileInput!) {
2 checkoutCustomerUpsert(input: $input) {
3 customerId
4 email
5 name
6 phone
7 locations {
8 administrativeArea
9 countryCode
10 line1
11 line2
12 locality
13 postalCode
14 }
15 }
16}

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

War diese Seite hilfreich?