# Collecter des adresses physiques

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

# Full hosted page

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

You can collect billing and shipping addresses from your customers during checkout.

## Collect a billing address

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 collecter une adresse de facturation de façon continue, définissez `billing_address_collection` à `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"
```

## Collect a shipping address

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 vers lesquels vous souhaitez autoriser la livraison. Configurez la propriété `allowed_countries` avec un tableau de [codes à deux lettres de pays ISO](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 termine la session, l’objet [Checkout Session](https://docs.stripe.com/api/checkout/sessions/object.md) enregistre l’adresse de livraison collectée sur la propriété `shipping_details` et l’inclut dans la charge utile de l’objet `checkout.session.completed` *webhook* (A webhook is a real-time push notification sent to your application as a JSON payload through HTTPS requests). Vous pouvez également consulter les informations de livraison dans la page des informations de paiement du Dashboard.

## See also

- [Charge for shipping](https://docs.stripe.com/payments/during-payment/charge-shipping.md)
- [Collect phone numbers](https://docs.stripe.com/payments/checkout/phone-numbers.md)


# Full embedded page

> This is a Full embedded page for when payment-ui is embedded-page. View the full page at https://docs.stripe.com/payments/collect-addresses?payment-ui=embedded-page.

You can collect billing and shipping addresses from your customers during checkout.

## Collect a billing address

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 collecter une adresse de facturation de façon continue, définissez `billing_address_collection` à `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"
```

## Collect a shipping address

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 vers lesquels vous souhaitez autoriser la livraison. Configurez la propriété `allowed_countries` avec un tableau de [codes à deux lettres de pays ISO](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 termine la session, l’objet [Checkout Session](https://docs.stripe.com/api/checkout/sessions/object.md) enregistre l’adresse de livraison collectée sur la propriété `shipping_details` et l’inclut dans la charge utile de l’objet `checkout.session.completed` *webhook* (A webhook is a real-time push notification sent to your application as a JSON payload through HTTPS requests). Vous pouvez également consulter les informations de livraison dans la page des informations de paiement du Dashboard.

## See also

- [Charge for shipping](https://docs.stripe.com/payments/during-payment/charge-shipping.md)
- [Collect phone numbers](https://docs.stripe.com/payments/checkout/phone-numbers.md)