決済後にカード詳細を保存する
対面支払いを受け、カード保有者が物理的に存在しない場合にカード詳細を保存して、後で使用することができます。
Stripe Terminal を使用して、店舗でカードで購入した支払いの詳細を保存できます。 card_
決済が成功すると、再利用可能な card
PaymentMethod が generated_
属性に返されます。次のようにいくつかのユースケースがあります。
- ジムの顧客が初回セッションと会員制サブスクリプションの支払いを対面で行います。取引により、将来のメンバーシップの自動更新に使用する
generated_
が設定されます。card - 衣料品店の顧客が、レジで購入するときにメールアドレスを提供します。取引により、顧客レコードと、関連付けられた保存済み
generated_
が作成されます。これにより、顧客が後でその店のウェブサイトにログインし、同じカードを使用して注文できます。card
初回の対面支払いでは、標準的な Terminal の支払いについて、ライアビリティシフトや、低価格 (特定の市場の場合) という特典を受けられますが、generated_
を使用する後続の支払いは、非対面カード支払いのオンライン取引であり、ライアビリティシフトはありません。
注
Apple Pay や Google Pay などのデジタルウォレット支払いは保存できず、generated_
が作成されません。ただし、特定の業種のビジネス向けに、Stripe はデジタルウォレットの決済手段を保存できる制限付きプライベートベータ機能を提供しています。アクセスをリクエストするには、stripe-terminal-betas@stripe.com までお問い合わせください。
顧客を作成する
将来の支払いに備えてカードを設定するには、カードを Customer (顧客) に関連付ける必要があります。顧客がビジネスでアカウントを作成する際に、Customer オブジェクトを作成します。Customer オブジェクトを使用すると、支払い方法を再利用したり、複数の支払いを追跡したりできます。
作成に成功すると、Customer オブジェクトが返されます。オブジェクトで顧客の id
を調べて、その値を後で取得できるようにデータベースに保存できます。
これらの顧客は、ダッシュボードの顧客ページで見つけることができます。
PaymentIntent を作成する
Request a generated_
when you create a PaymentIntent by specifying a value for setup_future_usage. If you intend to only reuse the payment method when the customer is present in the checkout flow, use on_
. Otherwise, use off_
.
注
Visa, Mastercard, American Express, Discover, and co-branded eftpos cards are supported as card_
payment methods that can be saved as type card
.
Collect and process a payment method
When the customer is ready to pay and has consented to their card details being saved, pass allow_redisplay as always
or limited
into the process_
or collect_
ベータ call. The value indicates the degree to which a payment method can be shown in a customer checkout flow.
If you use the collect_
flow, which allows access to useful data like card brand and funding from the PaymentMethod before confirming it, you must also separately confirm the PaymentIntent.
Access the generated_card
A successful payment with a card that supports future use returns a PaymentIntent in the requires_
or succeeded
state, with a generated_
attribute containing the reusable PaymentMethod. If you passed the customer ID into the PaymentIntent creation call, the reusable PaymentMethod is automatically attached to the Customer object. Otherwise, you can manually attach it in a separate call.
Always verify that the PaymentIntent.latest_charge contains a generated_
value. Digital wallet payments might not create a generated card. If that happens, and you require a reusable payment method, you have two options:
- Prompt the cardholder to save a different card using the flow to save a card without taking a payment.
- 対面支払いを返金し、取引が失敗したことを示し、カード保有者に別のカードを使用するように指示します。
法令遵守
顧客の支払いの詳細を保存する際、適用されるすべての法律、規制、ネットワークの規則に準拠する責任はお客様にあります。たとえば、欧州データ保護委員会は、支払いの詳細の保存に関するガイダンスを発行しています。これらの要件は通常、以降の購入時の決済フローでの顧客の支払い方法を提示する、顧客がお客様のウェブサイトやアプリを使用していないときに請求するなど、将来に備えて顧客の支払い方法を保存する場合に適用されます。
支払い方法の詳細を保存する趣旨、顧客がオプトインできるようにする規約を、ウェブサイトおよびアプリに追加します。顧客がオフラインのときに顧客に請求する予定の場合は、少なくとも以下に関する説明を規約に含めてください。
- 指定された取引で顧客の代理として単独の支払いまたは一連の支払いを開始することをお客様に許可するという、顧客からお客様への同意
- 予期される支払い時期と支払い頻度 (たとえば、請求が予定されている分割払いまたはサブスクリプションの決済なのか、あるいは予定されていないトップアップなのか)。
- 決済金額の決定方法。
- サブスクリプションサービスに使用される支払い方法を設定する場合は、キャンセルに関するポリシー。
これらの規約に関する顧客の書面による同意の記録を必ず保管してください。
支払い方法を保存した場合、その使用は、規約に記載された特定の用途にのみ使用できます。顧客がオフラインであるときに請求し、さらに顧客の支払い方法を保存して、以降の購入に備えた保存済みの支払方法として顧客に提示する場合は、顧客から明示的に同意を収集する必要があります。そのための方法の 1 つとして、「今後の使用に備えて支払い方法を保存する」チェックボックスの使用があります。
Saving digital walletsベータ
If your MCC is in one of the following ranges, you might be eligible to participate in a limited beta for saving digital wallet payment methods. For more details, contact stripe-terminal-betas@stripe.com.
- Car Rental Agencies (3351 - 3500)
- Lodging – Hotels, Motels, Resorts (3501 - 3999)
- Steamship and Cruise Lines (4411)
- Boat Rentals and Leasing (4457)
- Lodging - Hotels, Motels, Resorts, Central Reservations Services (Not Elsewhere Classified) (7011)
- Trailer Parks and Campgrounds (7033)
- Equipment, Tool, Furniture, and Appliance Rental and Leasing (7394)
- Car Rental Agencies (Not Elsewhere Classified) (7512)
- Truck and Utility Trailer Rentals (7513)
- Motor Home and Recreational Vehicle Rentals (7519)
When you save a digital wallet payment method, the generated_
has allow_
, because checkout flows are prohibited from presenting saved digital wallets as a payment option. You can only charge saved digital wallet payment methods for off_session payments.