# Physische Adressen erfassen

Erfahren Sie, wie Sie Rechnungs- und Versandadressen erfassen.

# Gehostete Seite

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

Sie können Rechnungs- und Versandadressen Ihrer Kundinnen und Kunden während des Bezahlvorgangs erfassen.

## Rechnungsadresse erfassen

Standardmäßig wird in einer Checkout-Sitzung die Rechnungsadresse eines Kunden/einer Kundin nur dann erfasst, wenn dies erforderlich ist (zum Beispiel um Steuern zu berechnen). Um eine Rechnungsadresse immer zu erfassen, setzen Sie `billing_address_collection` auf `required`, wenn Sie eine [Checkout-Sitzung erstellen](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"
```

## Versandadresse erfassen

Um die Versandadresse einer Kundin/eines Kunden in Checkout zu erfassen, übergeben Sie beim [Erstellen einer Checkout-Sitzung](https://docs.stripe.com/api/checkout/sessions/create.md) den Parameter `shipping_address_collection`. Wenn Sie eine Versandadresse erfassen, müssen Sie auch angeben, in welche Länder der Versand zulässig ist. Konfigurieren Sie die Eigenschaft `allowed_countries` mit einem Array aus [zweistelligen ISO-Ländercodes](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"
```

Wenn der Kunde/die Kundin die Sitzung abschließt, speichert das [Checkout Session](https://docs.stripe.com/api/checkout/sessions/object.md)-Objekt die erfasste Versandadresse in der Eigenschaft `shipping_details` und nimmt sie in die Nutzlast des *Webhooks* (A webhook is a real-time push notification sent to your application as a JSON payload through HTTPS requests) `checkout.session.completed` auf. Sie können die Versandinformationen auch im Dashboard auf der Seite mit den Zahlungsdetails einsehen.

## See also

- [Versandkosten berechnen](https://docs.stripe.com/payments/during-payment/charge-shipping.md)
- [Telefonnummern erfassen](https://docs.stripe.com/payments/checkout/phone-numbers.md)


# Eingebettete Seite

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

Sie können Rechnungs- und Versandadressen Ihrer Kundinnen und Kunden während des Bezahlvorgangs erfassen.

## Rechnungsadresse erfassen

Standardmäßig wird in einer Checkout-Sitzung die Rechnungsadresse eines Kunden/einer Kundin nur dann erfasst, wenn dies erforderlich ist (zum Beispiel um Steuern zu berechnen). Um eine Rechnungsadresse immer zu erfassen, setzen Sie `billing_address_collection` auf `required`, wenn Sie eine [Checkout-Sitzung erstellen](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"
```

## Versandadresse erfassen

Um die Versandadresse einer Kundin/eines Kunden in Checkout zu erfassen, übergeben Sie beim [Erstellen einer Checkout-Sitzung](https://docs.stripe.com/api/checkout/sessions/create.md) den Parameter `shipping_address_collection`. Wenn Sie eine Versandadresse erfassen, müssen Sie auch angeben, in welche Länder der Versand zulässig ist. Konfigurieren Sie die Eigenschaft `allowed_countries` mit einem Array aus [zweistelligen ISO-Ländercodes](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"
```

Wenn der Kunde/die Kundin die Sitzung abschließt, speichert das [Checkout Session](https://docs.stripe.com/api/checkout/sessions/object.md)-Objekt die erfasste Versandadresse in der Eigenschaft `shipping_details` und nimmt sie in die Nutzlast des *Webhooks* (A webhook is a real-time push notification sent to your application as a JSON payload through HTTPS requests) `checkout.session.completed` auf. Sie können die Versandinformationen auch im Dashboard auf der Seite mit den Zahlungsdetails einsehen.

## See also

- [Versandkosten berechnen](https://docs.stripe.com/payments/during-payment/charge-shipping.md)
- [Telefonnummern erfassen](https://docs.stripe.com/payments/checkout/phone-numbers.md)