# 住所を収集する

請求先住所と配送先住所を収集する方法について説明します。

# ホスト型ページ

> This is a ホスト型ページ for when payment-ui is stripe-hosted. View the full page at https://docs.stripe.com/payments/collect-addresses?payment-ui=stripe-hosted.

決済中に顧客から請求先住所と配送先住所を収集することができます。

## 請求先住所を収集する

デフォルトでは、Checkout セッションは、税金の計算などの目的で必要な場合にのみ顧客の請求先住所を収集します。請求先住所を常に収集するには、[Checkout セッションの作成](https://docs.stripe.com/api/checkout/sessions/create.md)時に `billing_address_collection` を `required` に設定します。

```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"
```

## 配送先住所を収集する

Checkout で顧客の配送先住所を収集するには、[Checkout セッションの作成](https://docs.stripe.com/api/checkout/sessions/create.md)時に `shipping_address_collection` パラメーターを渡します。配送先住所を収集するときは、配送先の国も指定する必要があります。[2 文字の ISO 国コード](https://www.nationsonline.org/oneworld/country_code_list.htm) の配列を含む `allowed_countries` プロパティを設定します。

```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"
```

顧客がセッションを完了すると、収集された配送先住所は、[Checkout Session](https://docs.stripe.com/api/checkout/sessions/object.md) オブジェクトの `shipping_details` プロパティに保存され、`checkout.session.completed` *Webhook* (A webhook is a real-time push notification sent to your application as a JSON payload through HTTPS requests) のペイロードに組み込まれます。また、ダッシュボードの支払い詳細ページにも配送先情報が表示されます。

## See also

- [配送料金を請求](https://docs.stripe.com/payments/during-payment/charge-shipping.md)
- [電話番号を収集](https://docs.stripe.com/payments/checkout/phone-numbers.md)


# 埋め込み型ページ

> This is a 埋め込み型ページ for when payment-ui is embedded-form. View the full page at https://docs.stripe.com/payments/collect-addresses?payment-ui=embedded-form.

決済中に顧客から請求先住所と配送先住所を収集することができます。

## 請求先住所を収集する

デフォルトでは、Checkout セッションは、税金の計算などの目的で必要な場合にのみ顧客の請求先住所を収集します。請求先住所を常に収集するには、[Checkout セッションの作成](https://docs.stripe.com/api/checkout/sessions/create.md)時に `billing_address_collection` を `required` に設定します。

```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"
```

## 配送先住所を収集する

Checkout で顧客の配送先住所を収集するには、[Checkout セッションの作成](https://docs.stripe.com/api/checkout/sessions/create.md)時に `shipping_address_collection` パラメーターを渡します。配送先住所を収集するときは、配送先の国も指定する必要があります。[2 文字の ISO 国コード](https://www.nationsonline.org/oneworld/country_code_list.htm) の配列を含む `allowed_countries` プロパティを設定します。

```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"
```

顧客がセッションを完了すると、収集された配送先住所は、[Checkout Session](https://docs.stripe.com/api/checkout/sessions/object.md) オブジェクトの `shipping_details` プロパティに保存され、`checkout.session.completed` *Webhook* (A webhook is a real-time push notification sent to your application as a JSON payload through HTTPS requests) のペイロードに組み込まれます。また、ダッシュボードの支払い詳細ページにも配送先情報が表示されます。

## See also

- [配送料金を請求](https://docs.stripe.com/payments/during-payment/charge-shipping.md)
- [電話番号を収集](https://docs.stripe.com/payments/checkout/phone-numbers.md)