Collecter le numéro de téléphone des clients

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.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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" \
  --data-urlencode cancel_url="https://example.com/cancel"

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, 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énement customer.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, sous customer_details.phone. Après chaque session Checkout réussie, Stripe émet l’événement 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.

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 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) dans le portail client.