Accéder directement au contenu
Créez un compte
 ou
connecter-vous
Logo de la documentation Stripe
/
Créez un compte
Connectez-vous
AperçuMettre votre intégration à niveau
Paiements en ligne
PrésentationTrouver votre cas d'usageManaged Payments
Créer une page de paiement
Moyens de paiement
Interfaces de paiement
Scénarios de paiement
Paiements par TPE
Au-delà des paiements

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.

Vous pouvez activer la collecte des numéros de téléphone sur toutes les sessions Checkout en 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
Côté serveur

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.

Command Line
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 \
  -d ui_mode=custom \
  --data-urlencode return_url="https://example.com/return"

Collecter le numéro de téléphone du client
Côté client

Créez une entrée de numéro de téléphone pour recueillir le numéro de téléphone de votre client. Appelez updatePhoneNumber lorsque votre client a terminé la saisie pour enregistrer le numéro de téléphone.

En fonction de la conception de votre formulaire de paiement, vous pouvez appeler updatePhoneNumber de l’une des manières suivantes :

  • Directement avant l’envoi du paiement.
  • Avant de passer à l’étape suivante, par exemple en cliquant sur un bouton Enregistrer, si votre formulaire comporte plusieurs étapes.

Vous êtes responsable de la validation et de la mise en forme des numéros de téléphone avant d’appeler updatePhoneNumber.

index.html
<input type="tel" id="phone-number" />
checkout.js
stripe.initCheckout({fetchClientSecret}).then((checkout) => {
  const phoneNumberInput = document.getElementById('phone-number');

  phoneNumberInput.addEventListener('blur', () => {
    checkout.updatePhoneNumber(phoneNumberInput.value);
  });
});

Récupérer le numéro de téléphone
Côté serveur

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.
Cette page vous a-t-elle été utile ?
OuiNon