Collecter les adresses physiques

Lorsque vous utilisez une page paiement hébergée par Stripe ou un formulaire de paiement intégré, vous pouvez collecter les adresses de facturation et de livraison.

Collecter une adresse de facturation

Par défaut, une session Checkout ne collecte l’adresse de facturation d’un client que lorsque cela est nécessaire (par exemple, pour calculer les taxes). Pour toujours collecter une adresse de facturation, définissez billing_address_collection sur required lorsque vous créez une session Checkout.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d billing_address_collection=required \
  -d "automatic_tax[enabled]"=true \
  -d mode=payment \
  --data-urlencode success_url="https://example.com/success"

Collecter une adresse de livraison

Pour collecter l’adresse de livraison d’un client dans Checkout, transmettez le paramètre shipping_address_collection lorsque vous créez une session Checkout. Lorsque vous collectez une adresse de livraison, vous devez également préciser les pays pour lesquels vous autorisez la livraison. Configurez la propriété allowed_countries à l’aide du tableau des codes pays ISO à deux lettres.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d billing_address_collection=required \
  -d "shipping_address_collection[allowed_countries][]"=US \
  -d "shipping_address_collection[allowed_countries][]"=CA \
  -d "automatic_tax[enabled]"=true \
  -d mode=payment \
  --data-urlencode success_url="https://example.com/success"

Lorsque le client clôture la session, l’objet Session Checkout enregistre l’adresse de livraison collectée dans la propriété shipping_details et l’inclut dans la charge utile du webhook checkout.session.completed. Vous pouvez également consulter les informations de livraison dans le Dashboard, sur la page contenant les détails du paiement.