Collecter le numéro de téléphone des clients avec Checkout
Vous pouvez activer la collecte du numéro de téléphone dans Checkout si vous en avez besoin pour la livraison ou la facturation. Ne collectez le numéro de téléphone que si vous en avez besoin pour la transaction. L’activation est possible pour toutes les sessions des modes payment
et subscription
(la collecte du numéro de téléphone n’est pas prise en charge en mode setup
). Dans ce guide, nous partons du principe que vous avez déjà intégré Checkout. Si ce n’est pas le cas, consultez notre guide.
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]
sur true
lors de la création d’une session Checkout.
Note
L’exemple de code ci-dessus crée une session en mode payment
avec collecte du numéro de téléphone activée. Pour activer la collecte du numéro de téléphone en mode subscription
, apportez les modifications surlignées en vert dans votre requête de création de session en mode subscription
.
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.
Après la session
Après la session, vous pouvez récupérer le numéro de téléphone des clients à partir des objets Customer ou Checkout Session résultants :
- Sur l’objet Customer : Checkout enregistre les numéros de téléphone collectés dans la propriété
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 ou en écoutant l’événementcustomer.created
à l’aide d’un webhook. Vous pouvez également consulter le numéro de téléphone du client dans le Dashboard.
- Sur la session Checkout : le numéro de téléphone du client est également enregistré dans le hachage
customer_details
de l’objet Checkout Session, souscustomer_details.phone
. Après chaque session Checkout réussie, Stripe émet l’événementcheckout.session.completed
contenant l’objet Checkout Session (et le numéro de téléphone), que vous pouvez écouter à l’aide d’un webhook.
Collecte du numéro de téléphone des clients existants
Si l’on transmet un objet Customer existant avec une propriété phone
renseignée à la session Checkout, 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
de l’objet Customer, écrasant tout numéro de téléphone précédemment enregistré.
Modifier un numéro de téléphone à l’aide du 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) dans le portail client.