Telefonnummern von Kund/innen mit Checkout erfassen
Sie können die Erfassung von Telefonnummern in Checkout aktivieren, wenn Sie diese für den Versand oder die Rechnungsstellung benötigen. Die Telefonnummernerfassung können Sie für alle Sitzungen im Modus payment
und subscription
aktivieren (im setup
-Modus wird die Erfassung von Telefonnummern dagegen nicht unterstützt). In diesem Leitfaden wird davon ausgegangen, dass Sie Checkout bereits integriert haben. Ansonsten finden Sie alle wichtigen Informationen in diesem Leitfaden.
Erfassung von Telefonnummern aktivieren
Um die Erfassung von Telefonnummern zu aktivieren, legen Sie phone_number_collection[enabled]
beim Erstellen einer Checkout-Sitzung auf true
fest.
Notiz
Das obige Code-Beispiel erstellt bei aktivierter Erfassung von Telefonnummern eine Sitzung im Modus payment
. Zur Aktivierung der Erfassung von Telefonnummern im Modus subscription
nehmen Sie für Ihre Anforderung zum Erstellen einer Sitzung im Modus subscription
die gleichen grün hervorgehobenen Änderungen vor.
Wenn das Erfassen von Telefonnummern aktiviert ist, fügt Checkout dem Zahlungsformular ein erforderliches Telefonnummernfeld hinzu. Wenn Sie eine Versandadresse erfassen, wird das Telefonnummernfeld unter den Adressfeldern angezeigt. Andernfalls zeigt Checkout das Telefonnummernfeld unter der E-Mail-Eingabe an. Kund/innen können nur eine Telefonnummer pro Sitzung eingeben.
Nach der Sitzung
Nach der Sitzung können Sie Telefonnummern der Kund/innen aus dem resultierenden Customer- oder Checkout Session-Objekt abrufen.
- Auf dem Kundenobjekt: Checkout speichert erfasste Telefonnummern in der
phone
-Eigenschaft des Kundenobjekts, auf die Sie programmatisch zugreifen können. Der Zugriff erfolgt entweder durch direktes Abrufen des Kundenobjekts mithilfe der API oder Beobachten des Ereignissescustomer.created
in einem Webhook. Sie können die Telefonnummer auch im Dashboard anzeigen.
- In der Checkout-Sitzung: Die Telefonnummer des Kunden/der Kundin ist auch im
customer_details
-Hash des Checkout-Sitzungsobjekts untercustomer_details.phone
gespeichert. Nach jeder erfolgreichen Checkout-Sitzung gibt Stripe das Ereignischeckout.session.completed
aus, das das Checkout-Sitzungsobjekt (und die Telefonnummer) enthält, die Sie in einem Webhook beobachten können.
Telefonnummern für bestehende Kund/innen erfassen
Die Übergabe eines/einer bestehenden Kunden/Kundin mit der ausgefüllten phone
-Eigenschaft an die Checkout-Sitzung führt dazu, dass das Feld „Telefonnummer“ vorab ausgefüllt wird.
Wenn der Kunde/die Kundin seine/ihre Telefonnummer aktualisiert, verbleibt der aktualisierte Wert auf der phone
-Eigenschaft des Kundenobjekts und überschreibt alle zuvor gespeicherten Telefonnummern.
Rufnummernaktualisierung über das Kundenportal
Sie können Kundinnen/Kunden erlauben, ihre eigenen Konten im Kundenportal zu verwalten (einschließlich Aktualisierung ihrer Telefonnummern).