コンテンツにスキップ
アカウントを作成
または
サインイン
Stripe ドキュメントのロゴ
/
アカウントを作成
サインイン
概要構築済みのシステムをアップグレード
オンライン決済
概要ユースケースを見つけるManaged Payments
決済ページを構築
決済手段
支払いインターフェイス
決済シナリオ
店頭支払い
決済にとどまらない機能

顧客の電話番号を収集する

顧客が支払いを行うときに、配送や請求処理のために電話番号を収集します。

電話番号の収集は、paymentおよびsubscription環境の Checkout セッションで有効にできます (電話番号の収集は setup モードではサポートされていません)。電話番号は、取引に必要な場合にのみ収集してください。

電話番号の収集を有効にする
サーバー側

電話番号の収集を有効にするには、Checkout セッションを作成する際に、phone_number_collection[enabled] を true に設定します。

Command Line
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price_data][unit_amount]"=1000 \
  -d "line_items[0][price_data][product_data][name]"=T-shirt \
  -d "line_items[0][price_data][currency]"=eur \
  -d "line_items[0][quantity]"=2 \
  -d "phone_number_collection[enabled]"=true \
  -d mode=payment \
  -d ui_mode=custom \
  --data-urlencode return_url="https://example.com/return"

顧客の電話番号を収集する
クライアント側

電話番号の入力欄を作成して、顧客の電話番号を収集します。顧客が電話番号を入力して保存したら、updatePhoneNumber を呼び出します。

決済フォームのデザインに応じて、次の方法で updatePhoneNumber を呼び出すことができます。

  • 支払いの送信の直前。
  • 次のステップに進む前 (フォームが複数のステップからなる場合の保存ボタンのクリック時など)。

updatePhoneNumber を呼び出す前に、電話番号を確認して形式を調整する必要があります。

index.html
<input type="tel" id="phone-number" />
checkout.js
stripe.initCheckout({fetchClientSecret}).then((checkout) => {
  const phoneNumberInput = document.getElementById('phone-number');

  phoneNumberInput.addEventListener('blur', () => {
    checkout.updatePhoneNumber(phoneNumberInput.value);
  });
});

電話番号を取得する
サーバー側

セッション後、Customer オブジェクトまたは Checkout Session オブジェクトから顧客の電話番号を取得できます。

  • Customer の動作:Checkout は、収集された電話番号を Customer オブジェクトの phone プロパティに保存します。これは、API で Customer オブジェクトを直接取得してプログラムでアクセスするか、Webhook で customer.created イベントをリッスンして取得できます。顧客の電話番号は、ダッシュボードで確認することもできます。
  • Checkout Session の動作:顧客の電話番号は、Checkout Session オブジェクトの customer_details ハッシュの customer_details.phone にも保存されます。Checkout セッションが成功すると毎回、Stripe は Checkout Session オブジェクト (および電話番号) が含まれた checkout.session.completed イベントを送信します。これは、Webhook でリッスンできます。
このページはお役に立ちましたか。
はいいいえ