# Collecter les noms des clients Recouvrez les noms d’entreprise et d’entrepreneurs individuels en tant que champs de première classe dans Checkout. # 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/name-collection?payment-ui=stripe-hosted. You can enable name collection on the payment form to collect business or individual names from your customers. The information is available after the session is complete. Ces noms de *première classe* (First-class fields are prominent input fields that appear at the top level of the payment form and API, rather than being grouped within other sections such as billing or shipping details) sont distincts des noms collectés dans les informations de facturation et de livraison, et apparaissent toujours comme des champs de nom de niveau supérieur sur le formulaire de paiement s’ils sont activés. ![Champs de nom de première classe dans le formulaire Checkout](https://b.stripecdn.com/docs-statics-srv/assets/preview.d9469cc97e1794c04837c664c0cda4bb.png) Paiement ajoute des champs de nom de niveau supérieur au formulaire de paiement dans les coordonnées. ## Enable name collection Créez une session Checkout tout en spécifiant les paramètres de collecte de noms. Pour activer la collecte de noms, configurez l’objet [name_collection](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-name_collection) lors de la création d’une session Checkout. Vous pouvez collecter les noms d’entreprise, les noms d’entrepreneurs individuels, ou les deux, et définir chaque champ comme obligatoire ou facultatif en fonction de vos besoins. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d mode=payment \ --data-urlencode success_url="https://example.com/success" \ -d "line_items[0][price]"="{{PRICE_ID}}" \ -d "line_items[0][quantity]"=1 \ -d "name_collection[business][enabled]"=true \ -d "name_collection[individual][enabled]"=true \ -d "name_collection[individual][optional]"=true ``` > Lorsque vous définissez la collecte de nom de l’entreprise sur obligatoire, le bouton paiement Express et le bouton en un clic, comme Apple Pay, sont déplacés vers le bas du formulaire de paiement ou désactivés. ## Retrieve the collected names Après la session, vous pouvez récupérer les noms d’entreprises ou d’entrepreneurs individuels 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) suivants : ### À propos du client Checkout enregistre les noms collectés dans leurs propriétés [business_name](https://docs.stripe.com/api/customers/object.md#customer_object-business_name) ou [individual_name](https://docs.stripe.com/api/customers/object.md#customer_object-individual_name) respectives de l’objet Customer, auxquelles vous pouvez accéder par voie programmatique en récupérant l’objet Customer directement avec 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) dans un *webhook* (A webhook is a real-time push notification sent to your application as a JSON payload through HTTPS requests). Le [nom](https://docs.stripe.com/api/customers/object.md#customer_object-name) de l’objet Customer sera également défini sur business_name ou individual_name, dans cette commande. ```json { "object": { "id": "cus_HQmikpKnGHkNwW", "object": "customer", ... "name": "Stripe, Inc.""business_name": "Stripe, Inc." ..."individual_name": "Jenny Rosen" ... } } ``` Vous pouvez également consulter les noms des clients dans le [Dashboard](https://dashboard.stripe.com/customers). ### À propos de la session Checkout Les noms du client sont également enregistrés dans les hachages `collected_information` et `customer_details` de l’objet Checkout Session, sous : - [collected_information.business_name](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-collected_information-business_name) et [collected_information.individual_name](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-collected_information-individual_name) - [customer_details.business_name](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-customer_details-business_name) et [customer_details.individual_name](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-customer_details-individual_name) ```json { "object": { "id": "cs_test_a1dJwt0TCJTBsDkbK7RcoyJ91vJxe2Y", "object": "checkout.session", ... "collected_information": {"business_name": "Stripe, Inc.", "individual_name": "Jenny Rosen" }, ... "customer": "cus_id_of_new_customer", "customer_details": { ..."business_name": "Stripe, Inc.", "individual_name": "Jenny Rosen", "name": "Stripe, Inc." }, ... } } ``` Après chaque session Checkout réussie, Stripe envoie 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 les valeurs collectées, que vous pouvez écouter dans un *webhook* (A webhook is a real-time push notification sent to your application as a JSON payload through HTTPS requests). # Embedded Page > This is a Embedded Page for when payment-ui is embedded-form. View the full page at https://docs.stripe.com/payments/checkout/name-collection?payment-ui=embedded-form. You can enable name collection on the payment form to collect business or individual names from your customers. The information is available after the session is complete. Ces noms de *première classe* (First-class fields are prominent input fields that appear at the top level of the payment form and API, rather than being grouped within other sections such as billing or shipping details) sont distincts des noms collectés dans les informations de facturation et de livraison, et apparaissent toujours comme des champs de nom de niveau supérieur sur le formulaire de paiement s’ils sont activés. ![Champs de nom de première classe dans le formulaire Checkout](https://b.stripecdn.com/docs-statics-srv/assets/preview.d9469cc97e1794c04837c664c0cda4bb.png) Paiement ajoute des champs de nom de niveau supérieur au formulaire de paiement dans les coordonnées. ## Enable name collection Créez une session Checkout tout en spécifiant les paramètres de collecte de noms. Pour activer la collecte de noms, configurez l’objet [name_collection](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-name_collection) lors de la création d’une session Checkout. Vous pouvez collecter les noms d’entreprise, les noms d’entrepreneurs individuels, ou les deux, et définir chaque champ comme obligatoire ou facultatif en fonction de vos besoins. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d mode=payment \ --data-urlencode return_url="https://example.com/return" \ -d ui_mode=embedded \ -d "line_items[0][price]"="{{PRICE_ID}}" \ -d "line_items[0][quantity]"=1 \ -d "name_collection[business][enabled]"=true \ -d "name_collection[individual][enabled]"=true \ -d "name_collection[individual][optional]"=true ``` > Lorsque vous définissez la collecte de nom de l’entreprise sur obligatoire, le bouton paiement Express et le bouton en un clic, comme Apple Pay, sont déplacés vers le bas du formulaire de paiement ou désactivés. ## Retrieve the collected names Après la session, vous pouvez récupérer les noms d’entreprises ou d’entrepreneurs individuels 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) suivants : ### À propos du client Checkout enregistre les noms collectés dans leurs propriétés [business_name](https://docs.stripe.com/api/customers/object.md#customer_object-business_name) ou [individual_name](https://docs.stripe.com/api/customers/object.md#customer_object-individual_name) respectives de l’objet Customer, auxquelles vous pouvez accéder par voie programmatique en récupérant l’objet Customer directement avec 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) dans un *webhook* (A webhook is a real-time push notification sent to your application as a JSON payload through HTTPS requests). Le [nom](https://docs.stripe.com/api/customers/object.md#customer_object-name) de l’objet Customer sera également défini sur business_name ou individual_name, dans cette commande. ```json { "object": { "id": "cus_HQmikpKnGHkNwW", "object": "customer", ... "name": "Stripe, Inc.""business_name": "Stripe, Inc." ..."individual_name": "Jenny Rosen" ... } } ``` Vous pouvez également consulter les noms des clients dans le [Dashboard](https://dashboard.stripe.com/customers). ### À propos de la session Checkout Les noms du client sont également enregistrés dans les hachages `collected_information` et `customer_details` de l’objet Checkout Session, sous : - [collected_information.business_name](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-collected_information-business_name) et [collected_information.individual_name](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-collected_information-individual_name) - [customer_details.business_name](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-customer_details-business_name) et [customer_details.individual_name](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-customer_details-individual_name) ```json { "object": { "id": "cs_test_a1dJwt0TCJTBsDkbK7RcoyJ91vJxe2Y", "object": "checkout.session", ... "collected_information": {"business_name": "Stripe, Inc.", "individual_name": "Jenny Rosen" }, ... "customer": "cus_id_of_new_customer", "customer_details": { ..."business_name": "Stripe, Inc.", "individual_name": "Jenny Rosen", "name": "Stripe, Inc." }, ... } } ``` Après chaque session Checkout réussie, Stripe envoie 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 les valeurs collectées, que vous pouvez écouter dans un *webhook* (A webhook is a real-time push notification sent to your application as a JSON payload through HTTPS requests).