Telefonnummern der Kundinnen/Kunden erfassen

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

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price_data][unit_amount]"=1000 \
  -d "line_items[0][price_data][product_data][name]"=T-shirt \
  -d "line_items[0][price_data][currency]"=eur \
  -d "line_items[0][quantity]"=2 \
  -d "phone_number_collection[enabled]"=true \
  -d mode=payment \
  -d ui_mode=embedded \
  --data-urlencode return_url="https://example.com/return"

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 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.

Die Übergabe einer/eines bestehenden Kundin/Kunden mit der ausgefüllten phone-Eigenschaft an die Checkout-Sitzung führt dazu, dass das Feld „Telefonnummer“ vorab ausgefüllt wird.

Wenn die Kundin/der Kunde ihre/seine Telefonnummer aktualisiert, verbleibt der aktualisierte Wert in der Eigenschaft phone des Kundenobjekts und überschreibt alle zuvor gespeicherten Telefonnummern.

Telefonnummern im Kundenportal aktualisieren

Sie können Kundinnen/Kunden gestatten, ihre eigenen Konten im Kundenportal zu verwalten (einschließlich Aktualisierung ihrer Telefonnummern).