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) { email customerId organizationId name phone locations { administrativeArea countryCode locality line1 line2 postalCode } 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 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.
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 der Zonos.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.
Derzeit können Kundenprofile nur mit zusätzlichen Informationen aktualisiert werden – vorhandene Details können nicht bearbeitet oder entfernt werden.
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.