# Telefonnummern der Kundinnen/Kunden erfassen Erfassen Sie eine Telefonnummer für den Versand oder die Rechnungsstellung, wenn Ihr Kunde/Ihre Kundin eine Zahlung vornimmt. # Gehostete Seite > This is a Gehostete Seite for when payment-ui is stripe-hosted. View the full page at https://docs.stripe.com/payments/checkout/phone-numbers?payment-ui=stripe-hosted. Sie können die Erfassung von Telefonnummern für alle Sitzungen im [Modus](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-mode) `payment` und `subscription` aktivieren (Im Modus `setup` wird die Erfassung von Telefonnummern nicht unterstützt). Erfassen Sie Telefonnummern nur dann, wenn Sie sie für die Transaktion benötigen. ## Erfassung von Telefonnummern aktivieren Um die Erfassung von Telefonnummern zu aktivieren, legen Sie [phone_number_collection[enabled]](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-phone_number_collection-enabled) beim Erstellen einer Checkout-Sitzung auf `true` fest. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -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 \ --data-urlencode "success_url=https://example.com/success" ``` 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. ## Telefonnummer abrufen Wenn Ihr Kunde/Ihre Kundin mit digitalen Wallets von Drittanbietern wie [Apple Pay](https://docs.stripe.com/apple-pay.md) oder [Google Pay](https://docs.stripe.com/google-pay.md) bezahlt, kann das Telefonnummernformat aufgrund von Einschränkungen auf diesen Plattformen nicht garantiert werden. Wir geben den Telefonnummernwert zurück, der von der Wallet des Drittanbieters bereitgestellt wird. Wir garantieren Telefonnummern im Format [E.164](https://en.wikipedia.org/wiki/E.164), wenn ein Kunde/eine Kundin keine [Wallet-Zahlungen](https://docs.stripe.com/payments/wallets.md) verwendet. Nach der Sitzung können Sie Telefonnummern der Kund/innen aus dem resultierenden *Customer* (Customer objects represent customers of your business. They let you reuse payment methods and give you the ability to track multiple payments)- oder *Checkout Session* (A Checkout Session represents your customer's session as they pay for one-time purchases or subscriptions through Checkout. After a successful payment, the Checkout Session contains a reference to the Customer, and either the successful PaymentIntent or an active Subscription)-Objekt abrufen. - [Auf dem Kunden/der Kundin](https://docs.stripe.com/api/customers.md): Checkout speichert erfasste Telefonnummern in der Eigenschaft [phone](https://docs.stripe.com/api/customers/object.md#customer_object-phone) des Kundenobjekts, auf die Sie programmgesteuert zugreifen können. Der Zugriff erfolgt entweder durch direktes Abrufen des Kundenobjekts mithilfe des [API](https://docs.stripe.com/api/customers/retrieve.md) oder Überwachen des Ereignisses [customer.created](https://docs.stripe.com/api/events/types.md#event_types-customer.created) in einem *Webhook* (A webhook is a real-time push notification sent to your application as a JSON payload through HTTPS requests). Sie können die Telefonnummer auch im [Dashboard](https://dashboard.stripe.com/customers) anzeigen. - [In der Checkout-Sitzung](https://docs.stripe.com/api/checkout/sessions.md): Die Telefonnummer der Kundin/des Kunden ist auch im [customer_details](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-customer_details)-Hash des Checkout-Sitzungsobjekts unter [customer_details.phone](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-customer_details-phone) gespeichert. Nach jeder erfolgreichen Checkout-Sitzung gibt Stripe das Ereignis [checkout.session.completed](https://docs.stripe.com/api/events/types.md#event_types-checkout.session.completed) aus, das das Checkout-Sitzungsobjekt (und die Telefonnummer) enthält, die Sie in einem *Webhook* (A webhook is a real-time push notification sent to your application as a JSON payload through HTTPS requests) überwachen können. ## Telefonnummern für bestehende Kundinnen und Kunden erfassen Die Übergabe einer/eines bestehenden [Kundin/Kunden](https://docs.stripe.com/api/customers.md) mit der ausgefüllten [phone](https://docs.stripe.com/api/customers/object.md#customer_object-phone)-Eigenschaft an die [Checkout-Sitzung](https://docs.stripe.com/api/checkout/sessions.md) führt dazu, dass das Feld „Telefonnummer“ vorab ausgefüllt wird. Wenn die Kundin bzw. der Kunde ihre/seine Telefonnummer aktualisiert, bleibt dieser aktualisierte Wert in der [Telefoneigenschaft](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-phone) des [Kundenobjekts](https://docs.stripe.com/api/customers.md) erhalten 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](https://docs.stripe.com/api/customer_portal/configurations/create.md#create_portal_configuration-features-customer_update-allowed_updates)). ## See also - [Integration des Kundenportals](https://docs.stripe.com/customer-management.md) # Eingebettete Seite > This is a Eingebettete Seite for when payment-ui is embedded-form. View the full page at https://docs.stripe.com/payments/checkout/phone-numbers?payment-ui=embedded-form. Sie können die Erfassung von Telefonnummern für alle Sitzungen im [Modus](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-mode) `payment` und `subscription` aktivieren (Im Modus `setup` wird die Erfassung von Telefonnummern nicht unterstützt). Erfassen Sie Telefonnummern nur dann, wenn Sie sie für die Transaktion benötigen. ## Erfassung von Telefonnummern aktivieren Um die Erfassung von Telefonnummern zu aktivieren, legen Sie [phone_number_collection[enabled]](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-phone_number_collection-enabled) beim Erstellen einer Checkout-Sitzung auf `true` fest. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -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_page \ --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. ## Telefonnummer abrufen Wenn Ihr Kunde/Ihre Kundin mit digitalen Wallets von Drittanbietern wie [Apple Pay](https://docs.stripe.com/apple-pay.md) oder [Google Pay](https://docs.stripe.com/google-pay.md) bezahlt, kann das Telefonnummernformat aufgrund von Einschränkungen auf diesen Plattformen nicht garantiert werden. Wir geben den Telefonnummernwert zurück, der von der Wallet des Drittanbieters bereitgestellt wird. Wir garantieren Telefonnummern im Format [E.164](https://en.wikipedia.org/wiki/E.164), wenn ein Kunde/eine Kundin keine [Wallet-Zahlungen](https://docs.stripe.com/payments/wallets.md) verwendet. Nach der Sitzung können Sie Telefonnummern der Kund/innen aus dem resultierenden *Customer* (Customer objects represent customers of your business. They let you reuse payment methods and give you the ability to track multiple payments)- oder *Checkout Session* (A Checkout Session represents your customer's session as they pay for one-time purchases or subscriptions through Checkout. After a successful payment, the Checkout Session contains a reference to the Customer, and either the successful PaymentIntent or an active Subscription)-Objekt abrufen. - [Auf dem Kunden/der Kundin](https://docs.stripe.com/api/customers.md): Checkout speichert erfasste Telefonnummern in der Eigenschaft [phone](https://docs.stripe.com/api/customers/object.md#customer_object-phone) des Kundenobjekts, auf die Sie programmgesteuert zugreifen können. Der Zugriff erfolgt entweder durch direktes Abrufen des Kundenobjekts mithilfe des [API](https://docs.stripe.com/api/customers/retrieve.md) oder Überwachen des Ereignisses [customer.created](https://docs.stripe.com/api/events/types.md#event_types-customer.created) in einem *Webhook* (A webhook is a real-time push notification sent to your application as a JSON payload through HTTPS requests). Sie können die Telefonnummer auch im [Dashboard](https://dashboard.stripe.com/customers) anzeigen. - [In der Checkout-Sitzung](https://docs.stripe.com/api/checkout/sessions.md): Die Telefonnummer der Kundin/des Kunden ist auch im [customer_details](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-customer_details)-Hash des Checkout-Sitzungsobjekts unter [customer_details.phone](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-customer_details-phone) gespeichert. Nach jeder erfolgreichen Checkout-Sitzung gibt Stripe das Ereignis [checkout.session.completed](https://docs.stripe.com/api/events/types.md#event_types-checkout.session.completed) aus, das das Checkout-Sitzungsobjekt (und die Telefonnummer) enthält, die Sie in einem *Webhook* (A webhook is a real-time push notification sent to your application as a JSON payload through HTTPS requests) überwachen können. ## Telefonnummern für bestehende Kundinnen und Kunden erfassen Die Übergabe einer/eines bestehenden [Kundin/Kunden](https://docs.stripe.com/api/customers.md) mit der ausgefüllten [phone](https://docs.stripe.com/api/customers/object.md#customer_object-phone)-Eigenschaft an die [Checkout-Sitzung](https://docs.stripe.com/api/checkout/sessions.md) führt dazu, dass das Feld „Telefonnummer“ vorab ausgefüllt wird. Wenn die Kundin bzw. der Kunde ihre/seine Telefonnummer aktualisiert, bleibt dieser aktualisierte Wert in der [Telefoneigenschaft](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-phone) des [Kundenobjekts](https://docs.stripe.com/api/customers.md) erhalten 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](https://docs.stripe.com/api/customer_portal/configurations/create.md#create_portal_configuration-features-customer_update-allowed_updates)). ## See also - [Integration des Kundenportals](https://docs.stripe.com/customer-management.md)