顧客の電話番号を収集する
顧客が支払いを行うときに、配送や請求処理のために電話番号を収集します。
電話番号の収集は、payment および subscription モード セッションのすべてで有効にできます(setup モードでは、電話番号の収集はサポートされていません)。電話番号は取引に必要な場合のみ収集します。
電話番号の収集を有効にする
電話番号の収集を有効にするには、Checkout セッションを作成する際に、phone_number_collection[enabled] を true に設定します。
この例では、payment モードで電話番号の収集が有効化されたセッションを作成します。subscription モードで電話番号の収集を有効にするには、subscription モードのセッション作成リクエストで、ハイライトされたものと同じ変更を行います。
電話番号の収集が有効になっている場合、Checkout は、支払いフォームに「必須の」電話番号フィールドを追加します。配送先住所を収集する場合には、住所フィールドの下に電話番号フィールドが表示されます。それ以外の場合には、Checkout はメールアドレスの入力フィールドの下に電話番号のフィールドを表示します。顧客は 1 回のセッションで電話番号を 1 件のみ入力できます。
電話番号を取得する
After the session, you can retrieve customer phone numbers from the resulting Customer, or Checkout Session objects:
On the Customer: Checkout saves collected phone numbers onto the phone property of the Customer object, which you can access programmatically by either fetching the Customer object directly with the API, or by listening for the customer.created event in a webhook. You can also view the customer’s phone number in the dashboard.
On the Checkout Session: The customer’s phone number is also saved in the customer_details hash of the Checkout Session object, under customer_details.phone. After each successful Checkout Session, Stripe emits the checkout.session.completed event containing the Checkout Session object (and phone number), which you can listen for in a webhook.
既存の顧客の電話番号を収集する
Passing in an existing Customer with a populated phone property to the Checkout Session results in the phone number field being prefilled.
If the customer updates their phone number, this updated value persists on the phone property on the Customer object , overwriting any previously saved phone number.
Update phone numbers with the customer portal
You can allow customers to manage their own accounts (which includes updating their phone numbers) in the customer portal.