Collecter les noms des clients

Recouvrez les noms d’entreprise et d’entrepreneurs individuels en tant que champs de première classe dans Checkout.

Vous pouvez activer la collecte de noms sur le formulaire de paiement pour collecter les noms d’entreprises ou d’entrepreneurs individuels auprès de vos clients. Les informations sont disponibles une fois la session terminée.

Ces noms de première classe 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

Paiement ajoute des champs de nom de niveau supérieur au formulaire de paiement dans les coordonnées.

Activer la collecte de noms

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

Remarque

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.

Récupérer les noms recouvrés

Après la session, vous pouvez récupérer les noms d’entreprises ou d’entrepreneurs individuels des clients à partir des objets Customer ou Checkout Session suivants :

À propos du client

Checkout enregistre les noms collectés dans leurs propriétés business_name ou 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, ou en écoutant l’événement customer.created dans un webhook.

Le nom de l’objet Customer sera également défini sur business_name ou individual_name, dans cette commande.

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

À 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 :

{
  "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 contenant l’objet Checkout Session et les valeurs collectées, que vous pouvez écouter dans un webhook.