Telefonnummern der Kundinnen/Kunden erfassen

Erfassen Sie eine Telefonnummer für den Versand oder die Rechnungsstellung, wenn Ihr Kunde/Ihre Kundin eine Zahlung vornimmt.

Sie können die Erfassung von Telefonnummern für alle payment- und subscription-Checkout-Sitzungen im mode aktivieren (die Erfassung von Telefonnummern wird im setup-Modus nicht unterstützt). Fordern Sie Telefonnummern nur an, wenn Sie sie für die Transaktion benötigen.

Erfassung von Telefonnummern aktivieren
Serverseitig

Um die Erfassung von Telefonnummern zu aktivieren, legen Sie phone_number_collection[enabled] beim Erstellen einer Checkout-Sitzung auf true fest.

Telefonnummer der Kundin/des Kunden erfassen
Clientseitig

Erstellen Sie eine Telefonnummerneingabe, um die Telefonnummer Ihres Kunden/Ihrer Kundin zu erfassen. Rufen Sie updatePhoneNumber auf, wenn Ihr Kunde/Ihre Kundin die Eingabe abgeschlossen hat, um die Telefonnummer zu speichern:

Je nach Design Ihres Bezahlformulars können Sie updatePhoneNumber folgendermaßen aufrufen:

Direkt vor dem Senden der Zahlung.
Vor dem Übergang zum nächsten Schritt, z. B. dem Klicken auf die Schaltfläche Speichern, wenn Ihr Formular mehrere Schritte umfasst.

Sie sind dafür verantwortlich, Telefonnummern zu validieren und zu formatieren, bevor Sie updatePhoneNumber aufrufen.

index.html
<input type="tel" id="phone-number" />

checkout.js
stripe.initCheckout({fetchClientSecret}).then((checkout) => {
  const phoneNumberInput = document.getElementById('phone-number');

  phoneNumberInput.addEventListener('blur', () => {
    checkout.updatePhoneNumber(phoneNumberInput.value);
  });
});

Telefonnummer abrufen
Serverseitig

Nach der Sitzung können Sie Telefonnummern der Kund/innen aus dem resultierenden Customer- oder Checkout Session-Objekt abrufen.

Auf dem Kunden/der Kundin: Checkout speichert erfasste Telefonnummern in der Eigenschaft phone des Kundenobjekts, auf die Sie programmgesteuert zugreifen können. Der Zugriff erfolgt entweder durch direktes Abrufen des Kundenobjekts mithilfe des API oder Überwachen des Ereignisses customer.created in einem Webhook. Sie können die Telefonnummer auch im Dashboard anzeigen.
In der Checkout-Sitzung: Die Telefonnummer der Kundin/des Kunden ist auch im customer_details-Hash des Checkout-Sitzungsobjekts unter customer_details.phone gespeichert. Nach jeder erfolgreichen Checkout-Sitzung gibt Stripe das Ereignis checkout.session.completed aus, das das Checkout-Sitzungsobjekt (und die Telefonnummer) enthält, die Sie in einem Webhook überwachen können.

Telefonnummern der Kundinnen/Kunden erfassen

Erfassen Sie eine Telefonnummer für den Versand oder die Rechnungsstellung, wenn Ihr Kunde/Ihre Kundin eine Zahlung vornimmt.

Erfassung von Telefonnummern aktivierenServerseitig

Telefonnummer der Kundin/des Kunden erfassenClientseitig

Telefonnummer abrufenServerseitig

Erfassung von Telefonnummern aktivieren
Serverseitig

Telefonnummer der Kundin/des Kunden erfassen
Clientseitig

Telefonnummer abrufen
Serverseitig