# Collecter le numéro de téléphone des clients Collectez un numéro de téléphone pour l'expédition ou la facturation lorsque votre client effectue un paiement. # Page hébergée > This is a Page hébergée for when payment-ui is stripe-hosted. View the full page at https://docs.stripe.com/payments/checkout/phone-numbers?payment-ui=stripe-hosted. Vous pouvez activer la collecte des numéros de téléphone pour toutes les sessions en [mode](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-mode) `payment` et `subscription` (la collecte des numéros de téléphone n’est pas prise en charge en mode `setup`). Ne collectez les numéros de téléphone que si vous en avez besoin pour la transaction. ## Activer la collecte du numéro de téléphone Pour activer la collecte du numéro de téléphone, définissez le paramètre [phone_number_collection[enabled]](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-phone_number_collection-enabled) sur `true` lors de la création d’une session Checkout. ```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" ``` Lorsque la collecte du numéro de téléphone est activée, Checkout ajoute un champ de numéro de téléphone *obligatoire* au formulaire de paiement. Si vous collectez une adresse de livraison, le champ du numéro de téléphone s’affiche sous les champs d’adresse. Sinon, Checkout affiche le champ du numéro de téléphone sous la saisie de l’adresse e-mail. Les clients ne peuvent saisir qu’un seul numéro de téléphone par session. ## Récupérer le numéro de téléphone Lorsque votre client règle une transaction avec des wallets tiers, tels que [Apple Pay](https://docs.stripe.com/apple-pay.md) ou [Google Pay](https://docs.stripe.com/google-pay.md), le format du numéro de téléphone n’est pas garanti en raison des limitations imposées sur ces plateformes. Nous renvoyons la valeur du numéro de téléphone fournie par le wallet tiers. Nous garantissons les numéros de téléphone au format [E.164](https://en.wikipedia.org/wiki/E.164) lorsqu’un client n’utilise pas les [paiements par wallet](https://docs.stripe.com/payments/wallets.md). Après la session, vous pouvez récupérer le numéro de téléphone des clients à partir des objets *Customer* (Customer objects represent customers of your business. They let you reuse payment methods and give you the ability to track multiple payments) ou *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) résultants : - [Sur l’objet Customer](https://docs.stripe.com/api/customers.md) : Checkout enregistre les numéros de téléphone collectés dans la propriété [phone](https://docs.stripe.com/api/customers/object.md#customer_object-phone) de l’objet Customer, à laquelle vous pouvez accéder de manière programmatique en récupérant directement l’objet Customer via l’[API](https://docs.stripe.com/api/customers/retrieve.md) ou en écoutant l’événement [customer.created](https://docs.stripe.com/api/events/types.md#event_types-customer.created) à l’aide d’un *webhook* (A webhook is a real-time push notification sent to your application as a JSON payload through HTTPS requests). Vous pouvez également consulter le numéro de téléphone du client dans le [Dashboard](https://dashboard.stripe.com/customers). - [Sur la session Checkout](https://docs.stripe.com/api/checkout/sessions.md) : Le numéro de téléphone du client est également enregistré dans le hachage [customer_details](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-customer_details) de l’objet Checkout Session, sous [customer_details.phone](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-customer_details-phone). Après chaque session Checkout réussie, Stripe émet l’événement [checkout.session.completed](https://docs.stripe.com/api/events/types.md#event_types-checkout.session.completed) contenant l’objet Checkout Session (et le numéro de téléphone), que vous pouvez écouter à l’aide d’un *webhook* (A webhook is a real-time push notification sent to your application as a JSON payload through HTTPS requests). ## Collecter les numéros de téléphone de vos clients existants Si l’on transmet un objet [Customer](https://docs.stripe.com/api/customers.md) existant avec une propriété [phone](https://docs.stripe.com/api/customers/object.md#customer_object-phone) renseignée à la [session Checkout](https://docs.stripe.com/api/checkout/sessions.md), le champ du numéro de téléphone est prérempli. Si le client modifie son numéro de téléphone, cette valeur mise à jour est répercutée sur la propriété [phone](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-phone) de l’[objet [Customer](https://docs.stripe.com/api/customers.md), écrasant tout numéro de téléphone précédemment enregistré. ### Modifier les numéros de téléphone avec le portail client Vous pouvez offrir à vos clients la possibilité de gérer eux-mêmes leur compte (par exemple en [modifiant leur numéro de téléphone](https://docs.stripe.com/api/customer_portal/configurations/create.md#create_portal_configuration-features-customer_update-allowed_updates)) dans le portail client. ## See also - [Intégrer le portail client](https://docs.stripe.com/customer-management.md) # Page intégrée > This is a Page intégrée for when payment-ui is embedded-form. View the full page at https://docs.stripe.com/payments/checkout/phone-numbers?payment-ui=embedded-form. Vous pouvez activer la collecte des numéros de téléphone pour toutes les sessions en [mode](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-mode) `payment` et `subscription` (la collecte des numéros de téléphone n’est pas prise en charge en mode `setup`). Ne collectez les numéros de téléphone que si vous en avez besoin pour la transaction. ## Activer la collecte du numéro de téléphone Pour activer la collecte du numéro de téléphone, définissez le paramètre [phone_number_collection[enabled]](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-phone_number_collection-enabled) sur `true` lors de la création d’une session Checkout. ```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" ``` Lorsque la collecte du numéro de téléphone est activée, Checkout ajoute un champ de numéro de téléphone *obligatoire* au formulaire de paiement. Si vous collectez une adresse de livraison, le champ du numéro de téléphone s’affiche sous les champs d’adresse. Sinon, Checkout affiche le champ du numéro de téléphone sous la saisie de l’adresse e-mail. Les clients ne peuvent saisir qu’un seul numéro de téléphone par session. ## Récupérer le numéro de téléphone Lorsque votre client règle une transaction avec des wallets tiers, tels que [Apple Pay](https://docs.stripe.com/apple-pay.md) ou [Google Pay](https://docs.stripe.com/google-pay.md), le format du numéro de téléphone n’est pas garanti en raison des limitations imposées sur ces plateformes. Nous renvoyons la valeur du numéro de téléphone fournie par le wallet tiers. Nous garantissons les numéros de téléphone au format [E.164](https://en.wikipedia.org/wiki/E.164) lorsqu’un client n’utilise pas les [paiements par wallet](https://docs.stripe.com/payments/wallets.md). Après la session, vous pouvez récupérer le numéro de téléphone des clients à partir des objets *Customer* (Customer objects represent customers of your business. They let you reuse payment methods and give you the ability to track multiple payments) ou *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) résultants : - [Sur l’objet Customer](https://docs.stripe.com/api/customers.md) : Checkout enregistre les numéros de téléphone collectés dans la propriété [phone](https://docs.stripe.com/api/customers/object.md#customer_object-phone) de l’objet Customer, à laquelle vous pouvez accéder de manière programmatique en récupérant directement l’objet Customer via l’[API](https://docs.stripe.com/api/customers/retrieve.md) ou en écoutant l’événement [customer.created](https://docs.stripe.com/api/events/types.md#event_types-customer.created) à l’aide d’un *webhook* (A webhook is a real-time push notification sent to your application as a JSON payload through HTTPS requests). Vous pouvez également consulter le numéro de téléphone du client dans le [Dashboard](https://dashboard.stripe.com/customers). - [Sur la session Checkout](https://docs.stripe.com/api/checkout/sessions.md) : Le numéro de téléphone du client est également enregistré dans le hachage [customer_details](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-customer_details) de l’objet Checkout Session, sous [customer_details.phone](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-customer_details-phone). Après chaque session Checkout réussie, Stripe émet l’événement [checkout.session.completed](https://docs.stripe.com/api/events/types.md#event_types-checkout.session.completed) contenant l’objet Checkout Session (et le numéro de téléphone), que vous pouvez écouter à l’aide d’un *webhook* (A webhook is a real-time push notification sent to your application as a JSON payload through HTTPS requests). ## Collecter les numéros de téléphone de vos clients existants Si l’on transmet un objet [Customer](https://docs.stripe.com/api/customers.md) existant avec une propriété [phone](https://docs.stripe.com/api/customers/object.md#customer_object-phone) renseignée à la [session Checkout](https://docs.stripe.com/api/checkout/sessions.md), le champ du numéro de téléphone est prérempli. Si le client modifie son numéro de téléphone, cette valeur mise à jour est répercutée sur la propriété [phone](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-phone) de l’[objet [Customer](https://docs.stripe.com/api/customers.md), écrasant tout numéro de téléphone précédemment enregistré. ### Modifier les numéros de téléphone avec le portail client Vous pouvez offrir à vos clients la possibilité de gérer eux-mêmes leur compte (par exemple en [modifiant leur numéro de téléphone](https://docs.stripe.com/api/customer_portal/configurations/create.md#create_portal_configuration-features-customer_update-allowed_updates)) dans le portail client. ## See also - [Intégrer le portail client](https://docs.stripe.com/customer-management.md)