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

メモ

このページはまだ日本語ではご利用いただけません。より多くの言語で文書が閲覧できるように現在取り組んでいます。準備が整い次第、翻訳版を提供いたしますので、もう少しお待ちください。

カード支払いを回収する

Stripe Terminal を使用したカード支払いの回収ができるように、アプリケーションとバックエンドを準備します。

Stripe Terminal で支払いを回収するには、アプリケーションに決済フローを記述する必要があります。Stripe Terminal SDK を使用して、1 つの支払いセッションを表すオブジェクトである PaymentIntent (支払いインテント) を作成して更新します。

Terminal の組み込みは支払いプロセスにおける失敗に対応できるように設計されており、支払いプロセスを複数のステップに分割し、各ステップを安全に再試行できるようになっています。

  1. PaymentIntent を作成します。
  2. 決済を処理します。顧客のカードの承認は、SDK が決済を処理するときに行われます。
  3. (オプション) 支払いをキャプチャーする

PaymentIntent を作成する
クライアント側
サーバー側

支払いを回収する最初のステップは、支払いフローを開始することです。顧客がチェックアウトを開始するとき、アプリケーションは PaymentIntent オブジェクトを作成する必要があります。これは、Stripe での新しい支払いセッションを表します。

クライアント側またはサーバー側で PaymentIntent を作成できます。

テスト金額を使用して、さまざまな結果を生成してみてください。00 で終わる金額では、支払いが承認されます。

よくある間違い

クレジットカードが拒否された場合は、決済インテントを再作成しないでください。代わりに、同じ決済インテントを再利用して、二重請求を回避します。

クライアント側

クライアントから PaymentIntent を作成します。

警告

アプリが Verifone P400 に接続されている場合は、iOS SDK から PaymentIntent を作成できません。代わりに、サーバー側で PaymentIntent を作成し、SDK の Terminal.retrievePaymentIntent メソッドを使用して、アプリ内に PaymentIntent を取得する必要があります。

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

class PaymentViewController: UIViewController {

    // ...

    // Action for a "Checkout" button
    func checkoutAction() throws {
        let params = try PaymentIntentParametersBuilder(amount: 1000, currency: "usd").build()
        Terminal.shared.createPaymentIntent(params) { createResult, createError in
            if let error = createError {
                print("createPaymentIntent failed: \(error)")
            } else if let paymentIntent = createResult {
                print("createPaymentIntent succeeded")
                // ...
            }

        }
    }

    // ...
}

サーバー側

支払いの開始に必要な情報がアプリですぐに利用できない場合は、サーバで PaymentIntent を作成することができます。

次の例は、サーバで PaymentIntent を作成する方法を示しています。

Command Line
curl
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_intents \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "amount"=1000 \
  -d "currency"="usd" \
  -d "payment_method_types[]"="card_present" \
  -d "capture_method"="manual"

Terminal の支払いでは、payment_method_types パラメータに card_present が含まれている必要があります。

以下のように決済フローを制御できます。

  • card_present 支払いの支払いフローを完全に制御するには、capture_method を manual に設定します。これにより、支払いを確定する前に照合ステップを追加できます。
  • 1 ステップで支払いのオーソリとキャプチャーを行うには、capture_method を automatic に設定します。

オーストラリアで決済を受け付けるには、capture_method をautomaticまたは manual_preferred に設定する必要があります。詳細については、Stripe のオーストラリアのドキュメントをご覧ください。カナダで Interac 支払いを受け付けるには、payment_method_types に interac_present も含める必要があります。詳細については、Stripe のカナダのドキュメントをご覧ください。

PaymentIntent には、個々の PaymentIntent に固有のキーである client secret が含まれています。client secret を使用するには、これをサーバーで PaymentIntent から取得し、クライアント側に渡す必要があります。

Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
post '/create_payment_intent' do
  intent = # ... Create or retrieve the PaymentIntent
  {client_secret: intent.client_secret}.to_json
end

PaymentIntent を取得するには、client secret を使用して retrievePaymentIntent を呼び出します。

PaymentIntent を取得したら、それを使用して processPaymentIntent を呼び出します。

PaymentViewController.swift
Swift
Objective-C
No results
func checkoutButtonAction() {
    // ... Fetch the client secret from your backend
    Terminal.shared.retrievePaymentIntent(clientSecret: clientSecret) { retrieveResult, retrieveError in
        if let error = retrieveError {
            print("retrievePaymentIntent failed: \(error)")
        }
        else if let paymentIntent = retrieveResult {
            print("retrievePaymentIntent succeeded: \(paymentIntent)")
            // ...
        }
    }
}

支払いを処理する
クライアント側

顧客が提示したカードで決済を即時に処理するか、決済の処理に進む前にカード詳細を調べるかを選択できます。大半のユースケースでは、API コール数が少なく抑えられ、統合がシンプルになるため、即時に処理することをお勧めします。ただし、カードの承認前に独自のビジネスロジックを挿入する場合は、収集と確定の 2 段階のフローを使用できます。

PaymentIntent を作成したら、次に決済を処理します。リーダーは顧客に対してカードをタップまたは挿入するように求め、その後、決済が承認されます。

決済の処理中に、カード会員がウォレットからカードを取得するまでに数秒かかったり、決済中にオペレーターに質問したりする可能性があります。

PaymentViewController.swift
Swift
Objective-C
No results
// Action for a "Checkout" button
func checkoutAction() throws {
  let params = try PaymentIntentParametersBuilder(amount: 1000, currency: "usd").build()
  Terminal.shared.createPaymentIntent(params) { createResult, createError in
      if let error = createError {
          print("createPaymentIntent failed: \(error)")
      } else if let paymentIntent = createResult {
          print("createPaymentIntent succeeded")
          self.processCancelable = Terminal.shared.processPaymentIntent(paymentIntent, collectConfig: nil, confirmConfig: nil) { processResult, processError in
              if let error = processError {
                  print("processPaymentIntent failed: \(error)")
              } else if let processedPaymentIntent = processResult {
                  print("processPaymentIntent succeeded")
                  // Notify your backend to capture the PaymentIntent
                  if let stripeId = processedPaymentIntent.stripeId {
                      APIClient.shared.capturePaymentIntent(stripeId) { captureError in
                          if let error = captureError {
                              print("capturePaymentIntent failed: \(error)")
                          } else {
                              print("capturePaymentIntent succeeded")
                          }
                      }
                  } else {
                      print("Payment processed offline");
                  }
              }
          }
      }
  }
}

収集をキャンセルする

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

iOS SDK から返される Cancelable オブジェクトを使用して、PaymentIntent の処理をキャンセルできます。

顧客によるキャンセル

スマートリーダーは、デフォルトで顧客にキャンセルボタンを表示します。これを無効にするには、customerCancellation を .disableIfAvailable に設定します。

キャンセルボタンをタップすると、現在の取引がキャンセルされます。

PaymentViewController.swift
Swift
Objective-C
No results
let collectConfig = try CollectPaymentIntentConfigurationBuilder()
    .setCustomerCancellation(.disableIfAvailable) // turn OFF the cancel button, ON by default
    .build()
Terminal.shared.collectPaymentMethod(paymentIntent: paymentIntent, collectConfig: collectConfig) {
    intentWithPaymentMethod, attachError in
}

イベントを処理する

内蔵ディスプレイのない Stripe M2 などのリーダーを使用して決済手段を収集する場合、決済手段収集プロセスのイベントをアプリからユーザーに表示できるようにする必要があります。これらのイベントは、ユーザーが決済を正常に収集するのに役立ちます (カードを再試行する、別のカードを試す、別の読み取り方法を使用するなど)。

取引が開始されると、SDK は ReaderInputOptions 値をアプリのリーダー表示ハンドラに渡し、受け入れ可能な入力の種類 (Swipe、Insert、Tap など) を示します。アプリの決済 UI で、これらのオプションのいずれかを使用してカードを提示することを求めるプロンプトをユーザーに表示します。

取引中に、SDK がアプリに対して、アプリのリーダー表示ハンドラに ReaderDisplayMessage 値を渡すことで、ユーザーに追加のプロンプト (Retry Card など) を表示するように要求する場合があります。これらのメッセージが決済 UI でユーザーに表示されることを確認してください。

ReaderViewController.swift
Swift
Objective C
No results
// MARK: MobileReaderDelegate - only needed for Bluetooth readers, this is the delegate set during connectReader

 func reader(_ reader: Reader, didRequestReaderInput inputOptions: ReaderInputOptions = []) {
     readerMessageLabel.text = Terminal.stringFromReaderInputOptions(inputOptions)
 }

 func reader(_ reader: Reader, didRequestReaderDisplayMessage displayMessage: ReaderDisplayMessage) {
     readerMessageLabel.text = Terminal.stringFromReaderDisplayMessage(displayMessage)
 }

iPhone のタッチ決済で決済を収集する

アプリケーション側で決済を収集する準備ができると、Stripe iOS SDK がその画面を引き継いで収集プロセスを処理します。process payment メソッドを呼び出した後、アプリケーションは実行中のままになりますが、iPhone ではカード会員に全画面のプロンプトが表示され、カードまたは NFC ベースのモバイルウォレットを提示するように求められます。カードの読み取りエラーが発生した場合は、再試行を求めるプロンプトが表示されます。提示に成功すると、成功の表示が返され、アプリケーションに制御が返されます。

iPhone のタッチ決済

支払いの回収

  • 決済を手動でキャプチャーする場合、processPaymentIntent 呼び出しが成功すると、PaymentIntent のステータスが requires_capture になります。
  • 支払いの自動キャプチャーでは、PaymentIntent は succeeded 状態に移行します。

警告

2 日以内に PaymentIntent を手動でキャプチャーする必要があり、キャプチャーしなければオーソリは期限切れになり、売上は顧客にリリースされます。

失敗に対処する

決済の処理に失敗した場合、SDK は更新された PaymentIntent を含むエラーを返します (Stripe によって拒否された場合)。アプリケーションでは、PaymentIntent を調べてエラーの対処方法を判断する必要があります。

PaymentIntent ステータス意味解決策
requires_payment_method支払い方法が拒否されました同じ PaymentIntent を使用して processPaymentIntent を再度呼び出し、別の決済手段の収集を試みます。
requires_confirmation一時的な接続の問題同じ PaymentIntent を使用して processPaymentIntent を再度呼び出し、リクエストを再試行します。
PaymentIntent が nil ですStripe へのリクエストがタイムアウトし、PaymentIntent のステータスが不明です元の PaymentIntent の処理を再試行します。新しく作成しないでください。新しく作成すると、カード会員に複数の承認が発生する可能性があります。

タイムアウトが複数回、連続して発生する場合、接続に問題がある可能性があります。アプリがインターネットと通信できることを確認してください。

二重請求を避ける

PaymentIntent オブジェクトは、Stripe での資金移動を可能にします。1 つの取引を表すには、PaymentIntent を 1 つ使用します。

カードが (残高不足などのために) 拒否された後、同じ PaymentIntent を再利用して、顧客が別のカードで再試行できるようにします。

PaymentIntent を編集する場合、processPaymentIntent を呼び出してリーダーの決済情報を更新する必要があります。

PaymentIntent を Stripe で処理するには、ステータスが requires_payment_method である必要があります。承認済み、キャプチャー済み、キャンセル済みの PaymentIntent をリーダーで処理することはできません。

支払いをキャプチャーする
サーバー側

ステップ 1 の PaymentIntent の作成時に capture_method を manual として定義した場合、SDK はオーソリ済みでキャプチャーはされていない PaymentIntent をアプリケーションに返します。オーソリとキャプチャーの違いについて、詳細を確認してください。

アプリが SDK から確定済みの PaymentIntent を受信したら、その支払いをキャプチャーするようにアプリからバックエンドに対して通知するようにしてください。バックエンドにエンドポイントを作成し、PaymentIntent ID を受け付け、それをキャプチャーするように Stripe API にリクエストを送信します。

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

capture コールが成功すると、PaymentIntent のステータスは succeeded になります。

メモ

キャプチャーされたプラットフォーム手数料が連結アカウントに対して正確であることを確認するために、支払いを手動でキャプチャーする前にそれぞれの PaymentIntent を調べ、必要に応じてプラットフォーム手数料を修正します。

支払いを照合する

ビジネスの支払いアクティビティを監視するため、毎日の最後の作業としてサーバで PaymentIntent と内部注文システムを照合することをお勧めします。

PaymentIntent のステータスが requires_capture のままの場合には、以下の 2 つの可能性があります。

顧客のカード明細上の不要なオーソリ

  • 原因: ユーザーが取引の途中でアプリの決済フローを中止した
  • 解決策:キャプチャーされていない PaymentIntent が、サーバーにある完了済みの注文に関連付けられていない場合には、キャンセルできます。キャンセルされた PaymentIntent を使用して支払いを実行することはできません。

顧客からの売上回収が未完了

  • 原因: 支払いをキャプチャーするようにバックエンドに通知する、アプリからのリクエストのエラー
  • 解決策:キャプチャーされていない PaymentIntent が、サーバにある完了済みの注文に関連付けられており、その注文について他の支払い (現金による支払いなど) を受けていない場合には、この PaymentIntent をキャプチャーできます。

チップを徴収する アメリカのみ

アメリカでは、対象ユーザーは支払いのキャプチャー時にチップを徴収できます。