コンテンツにスキップ
アカウント作成/サインイン
Stripe ドキュメントのロゴ
/
アカウントを作成サインイン
概要構築済みのシステムをアップグレード
オンライン決済
概要ユースケースを見つけるManaged Payments を使用する
対面決済
決済手段
決済シナリオ
決済以外の機能

住所を収集する

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

Stripe がで提供する支払いページまたは埋め込み支払いフォームを使用すると、請求書と配送先住所を徴収することができます。

請求先住所を収集する

デフォルトでは、Checkout セッションは、税金の計算などの目的で必要な場合にのみ顧客の請求先住所を収集します。請求先住所を常に収集するには、Checkout セッションの作成時に billing_address_collection を required に設定します。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
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"

配送先住所を収集する

Checkout で顧客の配送先住所を収集するには、Checkout セッションの作成時に shipping_address_collection パラメーターを渡します。配送先住所を収集するときは、配送先の国も指定する必要があります。2 文字の ISO 国コード の配列を含む allowed_countries プロパティを設定します。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
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"

顧客がセッションを完了すると、収集された配送先住所は、Checkout Session オブジェクトの shipping_details プロパティに保存され、checkout.session.completed Webhook のペイロードに組み込まれます。また、ダッシュボードの支払い詳細ページにも配送先情報が表示されます。

参照情報