# Collecter les adresses physiques

Découvrez comment recueillir les adresses de facturation et de livraison.

# Page hébergée

> This is a Page hébergée for when payment-ui is stripe-hosted. View the full page at https://docs.stripe.com/payments/collect-addresses?payment-ui=stripe-hosted.

Lors du paiement, vous pouvez collecter les adresses de facturation et de livraison de vos clients.

## 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](https://docs.stripe.com/api/checkout/sessions/create.md).

```curl
curl https://api.stripe.com/v1/checkout/sessions \
  -u "<<YOUR_SECRET_KEY>>:" \
  -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](https://docs.stripe.com/api/checkout/sessions/create.md). 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](https://www.nationsonline.org/oneworld/country_code_list.htm).

```curl
curl https://api.stripe.com/v1/checkout/sessions \
  -u "<<YOUR_SECRET_KEY>>:" \
  -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](https://docs.stripe.com/api/checkout/sessions/object.md) enregistre l’adresse de livraison collectée dans la propriété `shipping_details` et l’inclut dans la charge utile du *webhook* (A webhook is a real-time push notification sent to your application as a JSON payload through HTTPS requests) `checkout.session.completed`. Vous pouvez également consulter les informations de livraison dans le Dashboard, sur la page contenant les détails du paiement.

## See also

- [Frais de livraison](https://docs.stripe.com/payments/during-payment/charge-shipping.md)
- [Collecter des numéros de téléphone](https://docs.stripe.com/payments/checkout/phone-numbers.md)


# Page intégrée

> This is a Page intégrée for when payment-ui is embedded-form. View the full page at https://docs.stripe.com/payments/collect-addresses?payment-ui=embedded-form.

Lors du paiement, vous pouvez collecter les adresses de facturation et de livraison de vos clients.

## 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](https://docs.stripe.com/api/checkout/sessions/create.md).

```curl
curl https://api.stripe.com/v1/checkout/sessions \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d billing_address_collection=required \
  -d "automatic_tax[enabled]=true" \
  -d mode=payment \
  -d ui_mode=embedded_page \
  --data-urlencode "return_url=https://example.com/return"
```

## 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](https://docs.stripe.com/api/checkout/sessions/create.md). 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](https://www.nationsonline.org/oneworld/country_code_list.htm).

```curl
curl https://api.stripe.com/v1/checkout/sessions \
  -u "<<YOUR_SECRET_KEY>>:" \
  -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 \
  -d ui_mode=embedded_page \
  --data-urlencode "return_url=https://example.com/return"
```

Lorsque le client clôture la session, l’objet [Session Checkout](https://docs.stripe.com/api/checkout/sessions/object.md) enregistre l’adresse de livraison collectée dans la propriété `shipping_details` et l’inclut dans la charge utile du *webhook* (A webhook is a real-time push notification sent to your application as a JSON payload through HTTPS requests) `checkout.session.completed`. Vous pouvez également consulter les informations de livraison dans le Dashboard, sur la page contenant les détails du paiement.

## See also

- [Frais de livraison](https://docs.stripe.com/payments/during-payment/charge-shipping.md)
- [Collecter des numéros de téléphone](https://docs.stripe.com/payments/checkout/phone-numbers.md)