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

請求せずに直接保存

提示されたカードの詳細を収集して、オンライン利用のために保存します。

SetupIntents を使用して、カードに請求することなくカードまたはモバイルウォレットの詳細を収集できます。SetupIntent で card_present の PaymentMethod を直接保存することはできませんが、ほとんどの場合、同じカードを表す再利用可能な generated_card の PaymentMethod を作成できます。顧客の視点からは、これらは同じ決済手段に捉えられます。

SetupIntents を使用して、Visa、Mastercard、アメリカン・エキスプレス、ディスカバー、および提携ブランドの Interac、eftpos、girocard のカード情報を収集できます。SetupIntents は、単独ブランドである Interac、eftpos、girocard のカードには対応していません。

SetupIntents を使用してStripe Terminal でカードを保存するには、次のようにする必要があります。

  1. Customer オブジェクトを作成または取得します。
  2. プロセスを追跡する SetupIntent (支払い方法設定インテント) オブジェクトを作成します。
  3. 顧客の同意を収集してから、支払い方法を収集します。
  4. Stripe に支払い方法の詳細を送信します。

注

この機能の顧客の同意モデルを変更し、レガシーの customer_consent_collected パラメーターの代わりに allow_redisplay パラメーターを必須にしました。実装で customer_consent_collected を使用している場合は、allow_redisplay を使用するように実装を更新する必要があります。この更新は、2025 年 3 月 31 日に React Native 以外のユーザーには必須になり、React Native ユーザーには 2025 年 9 月 30 日に必須になりました。ガイダンスについては、変更ログエントリーをご覧ください。

注

SetupIntents を使用するには、アプリで使っている SDK のバージョンが 2.x であることが必要です。詳細については、移行ガイドをご覧ください。

顧客を作成または取得する

Stripe で保存したカードに請求するには、カードを Customer に関連付ける必要があります。

確定前に、SetupIntent に顧客を含めると、入力した Customer オブジェクトに、生成されたカードの決済手段が自動的に関連付けられます。

以下のコードをサーバーに含めて、新しい Customer を作成します。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl -X POST https://api.stripe.com/v1/customers \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

SetupIntent を作成する

注

SetupIntent を作成する際に 顧客 IDを指定すると、セットアップに成功したときに 顧客にカード決済手段がアタッチされます。顧客 ID を提供しない場合は、別の呼び出しで決済手段をアタッチする必要があります。

SetupIntent は、将来の支払いに備えて顧客の決済手段を設定する意図を示すオブジェクトです。SetupIntent は、この設定プロセスの各ステップを追跡します。Terminal の場合、このプロセスにはカード保有者の同意の収集と記録が含まれます。

SetupIntent を作成して、customer、onBehalfOf (Connect の場合のみ)、usage の各パラメーターを指定できます。

PaymentViewController.swift
Swift
Objective C
No results
import UIKit
import StripeTerminal

class PaymentViewController: UIViewController {

    // Action for a "Save Card" button
    func saveCardAction() throws {
        let params = try SetupIntentParametersBuilder().setCustomer(
"{{CUSTOMER_ID}}"
)
        Terminal.shared.createSetupIntent(params) { createResult, createError in
            if let error = createError {
                print("createSetupIntent failed: \(error)")
            } else if let setupIntent = createResult {
                print("createSetupIntent succeeded")
                // ...
            }
        }
    }

    // ...
}

支払いの開始に必要な情報をアプリですぐに利用できない場合、自社のサーバー側で SetupIntent を作成できます。client secret を使用して retrieveSetupIntent を呼び出してから、取得した SetupIntent を使用して collectSetupIntentPaymentMethod を呼び出します。

保存するために決済手段を収集する

SetupIntent を作成したら、SDK を使用して決済手段を収集し、顧客の同意を得ます。allowRedisplay を always または limited にして、顧客の決済フローで決済手段が表示される頻度を指定します。

注

顧客からの同意を、文書またはアプリケーションのチェックボックスを使用して収集します。ご登録の地域で適用されるすべての法律、規則、および規制に準拠する必要があります。

支払い方法を収集するには、リーダーに接続する必要があります。アプリが collectSetupIntentPaymentMethod を呼び出した後、接続されたリーダーはカードが提示されるのを待ちます。

PaymentViewController.swift
Swift
Objective-C
No results
import UIKit
import StripeTerminal

class PaymentViewController: UIViewController, ReaderDisplayDelegate {
    // Label for displaying messages from the card reader
    let readerMessageLabel = UILabel(frame: .zero)
    var collectCancelable: Cancelable? = nil

    // ...

    // Action for a "Subscribe" button
    func subscribeAction() throws {
        let params = try SetupIntentParametersBuilder().setCustomer(
"{{CUSTOMER_ID}}"
).build()
        Terminal.shared.createSetupIntent(params) { createResult, createError in
            if let error = createError {
                print("createSetupIntent failed: \(error)")
            } else if let setupIntent = createResult {
                print("createSetupIntent succeeded")
                self.collectCancelable = Terminal.shared.collectSetupIntentPaymentMethod(setupIntent, allowRedisplay: AllowRedisplay.always) { collectResult, collectError in
                    if let error = collectError {
                        print("collectSetupIntentPaymentMethod failed: \(error)")
                    } else if let collectPaymentMethodPaymentIntent = collectResult {
                        print("collectSetupIntentPaymentMethod succeeded")
                        // ... Confirm the SetupIntent
                        Terminal.shared.confirmSetupIntent(collectPaymentMethodPaymentIntent) { confirmResult, confirmError in
                            if let error = confirmError {
                                print("confirmSetupIntent failed: \(error)")
                            } else if let confirmedSetupIntent = confirmResult {
                                print("confirmSetupIntent succeeded")
                            }
                        }
                    }
                }
            }
        }
    }

この方法では、接続されたカードリーダーを使用して支払い方法の暗号化データを収集し、その暗号化データを SetupIntent に関連付けます。

注意

支払い方法の収集はローカルで行われ、次のステップまで SetupIntent オブジェクトのオーソリや更新は必要ありません。

収集をキャンセルする

プログラムによるキャンセル

SDK から返される Cancelable オブジェクトを使用して、決済手段の収集をキャンセルできます。

顧客によるキャンセル

取引の setEnableCustomerCancellation を true に設定すると、スマートリーダーの画面にキャンセルボタンが表示されます。キャンセルボタンをタップすると、現在の取引がキャンセルされます。

PaymentViewController.swift
Swift
Objective-C
No results
let setupConfig = try SetupIntentConfiguration()
    .setEnableCustomerCancellation(true)
    .build()
Terminal.shared.collectSetupIntentPaymentMethod(intent, allowRedisplay: AllowRedisplay.always, setupConfig: setupConfig) {
    collectedSetupIntent, collectError in
}

Stripe に決済手段の詳細を送信する

confirmSetupIntent を使用して、設定を完了させます。

設定が成功すると、SetupIntent の status プロパティの succeeded 値が SetupAttempt.payment_method_details.card_present.generated_card とともに返されます。これは、オンライン決済に利用できる再利用可能な card の決済手段です。

注

SetupIntent.payment_method は、物理的に存在するカードのトークン化を表す card_present PaymentMethod であり、オンラインでは請求できません。今後の支払いでは、代わりに生成されたカードが使用されます。顧客側から見ると、同じ決済手段です。

generated_card の決済手段が、SetupIntent の作成時に指定した顧客に自動的に関連付けられます。SetupIntent の latest_attempt プロパティを展開することで、generated_card の決済手段を取得できます。必ず generated_card の値を確認してください。生成されたカードを使用できない決済手段では、この値が空になるためです。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl -G https://api.stripe.com/v1/setup_intents/
{{SETUP_INTENT_ID}}
 \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "expand[]"=latest_attempt

別の方法として、顧客に関連付けられている支払い方法のリストを取得することで、関連付けられた支払い方法を入手することもできます。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl -G https://api.stripe.com/v1/customers/
{{CUSTOMER_ID}}
/payment_methods \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d type=card

SetupIntent の作成時に顧客を指定しなかった場合は、別個のコールで generated_card を Customer オブジェクトに関連付けることができます。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_methods/
{{PAYMENT_METHOD_ID}}
/attach \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}}

設定に失敗したら、返されたエラーを調べて原因を特定します。たとえば、顧客から同意を収集できなかったり、Stripe に顧客の同意を通知できなったりした場合、エラーが発生します。

PaymentViewController.swift
Swift
Objective-C
No results
// Action for a "Save Card" button
func saveCardAction() throws {
  let params = try SetupIntentParametersBuilder.setCustomer(
"{{CUSTOMER_ID}}"
).build()
  Terminal.shared.createSetupIntent(params) { createResult, createError in
      if let error = createError {
          print("createSetupIntent failed: \(error)")
      } else if let setupIntent = createResult {
          print("createSetupIntent succeeded")
          self.collectCancelable = Terminal.shared.collectSetupIntentPaymentMethod(setupIntent, AllowRedisplay.always, delegate: self) { collectResult, collectError in
              if let error = collectError {
                  print("collectSetupIntentPaymentMethod failed: \(error)")
              } else if let collectPaymentMethodPaymentIntent = collectResult {
                  print("collectSetupIntentPaymentMethod succeeded")
                  // ... Confirm the SetupIntent
                  Terminal.shared.confirmSetupIntent(collectPaymentMethodPaymentIntent) { confirmResult, confirmError in
                      if let error = confirmError {
                          print("confirmSetupIntent failed: \(error)")
                      } else if let confirmedSetupIntent = confirmResult {
                          print("confirmSetupIntent succeeded")
                      }
                  }
              }
          }
      }
  }
}

モバイルウォレットに関する考慮事項

保存されたモバイルウォレットは、将来のサブスクリプションや、顧客の代理として開始するその他の支払いなど、off_session の支払いにのみ使用できます。デジタルウォレットによる決済手段を保存する際、generated_card には使用上の特定の考慮事項を示す allow_redisplay=limited が設定されます。

モバイルウォレットに請求する際は、PaymentIntent の確定時に必ず off_session=true を渡します。顧客が決済フローを実施している場合は、代わりに Apple Pay と Google Pay の連携を使用して、決済手段の提示を再度求めます。

法令遵守

顧客の支払いの詳細を保存する際、適用されるすべての法律、規制、ネットワークの規則に準拠する責任はお客様にあります。たとえば、欧州データ保護委員会は、支払いの詳細の保存に関するガイダンスを発行しています。これらの要件は通常、以降の購入時の決済フローでの顧客の支払い方法を提示する、顧客がお客様のウェブサイトやアプリを使用していないときに請求するなど、将来に備えて顧客の支払い方法を保存する場合に適用されます。

支払い方法の詳細を保存する趣旨、顧客がオプトインできるようにする規約を、ウェブサイトおよびアプリに追加します。顧客がオフラインのときに顧客に請求する予定の場合は、少なくとも以下に関する説明を規約に含めてください。

  • 指定された取引で顧客の代理として単独の支払いまたは一連の支払いを開始することをお客様に許可するという、顧客からお客様への同意
  • 予期される支払い時期と支払い頻度 (たとえば、請求が予定されている分割払いまたはサブスクリプションの決済なのか、あるいは予定されていないトップアップなのか)。
  • 決済金額の決定方法。
  • サブスクリプションサービスに使用される支払い方法を設定する場合は、キャンセルに関するポリシー。

これらの規約に関する顧客の書面による同意の記録を必ず保管してください。

支払い方法を保存した場合、その使用は、規約に記載された特定の用途にのみ使用できます。顧客がオフラインであるときに請求し、さらに顧客の支払い方法を保存して、以降の購入に備えた保存済みの支払方法として顧客に提示する場合は、顧客から明示的に同意を収集する必要があります。そのための方法の 1 つとして、「今後の使用に備えて支払い方法を保存する」チェックボックスの使用があります。

このページはお役に立ちましたか。
はいいいえ