Stripe Terminal をテストする

Terminal の組み込みを効果的にテストする方法をご紹介します。

注

Stripe Terminal をテストするプロセスの大半は、Stripe のオンライン決済のテストと類似しています。また、テスト環境では Stripe Terminal でモバイルウォレット (Apple Pay や Google Pay など) を使用することはできません。詳細については、Stripe の一般テストガイドをご覧ください。

Terminal のデプロイを成功させる最善の方法は、システムの各部分をテストすることです。Stripe は各ステージ用のテストツールを用意しています。

リーダーを注文する前に、リーダーシミュレーターで組み込みをテストします。
物理テストカードでハードウェアの組み込みをテストします。

シミュレーションされたリーダー

Stripe Terminal SDK およびサーバー主導型の連携にはシミュレーションされた内蔵カードリーダーが付属しているため、物理ハードウェアに接続することなくアプリを開発してテストすることができます。連携が完了している場合も、構築中であっても、シミュレーションされたリーダーを使用してアプリ内のすべての Terminal フローをエミュレートします。

The simulated reader doesn’t provide a UI. After connecting to it in your app, you can see it working when calls to the Stripe SDK or API succeed.

SDK のシミュレーションされたリーダーは、必要に応じて自動的にカード提示をシミュレーションします。サーバー主導型のシステムでは、構築済みのシステムを更新して、カード提示をシミュレーションします。

シミュレーションされたテストカード

シミュレーションされたリーダーは、シミュレーションされたテストカードを使用するよう設定できます。これにより、POS アプリケーション内のさまざまなフローをテストできるようになります。

支払い方法を収集する前に、以下のテストカード番号またはテスト支払い方法のいずれかを使用して特定のレスポンスを生成するよう、シミュレーションされたリーダーを設定します。

標準的なテストカード

テストカード番号	Test payment method	ブランド
	`visa`	Visa
	`visa_debit`	Visa (デビット)
	`mastercard`	Mastercard
	`mastercard_debit`	Mastercard (デビット)
	`mastercard_prepaid`	Mastercard (プリペイド)
	`amex`	アメリカン・エキスプレス
	`amex2`	アメリカン・エキスプレス
	`discover`	ディスカバー
	`discover2`	ディスカバー
	`diners`	ダイナースクラブ
	`diners_14digits`	ダイナースクラブ (14 桁のカード)
	`jcb`	JCB
	`unionpay`	銀聯
	`interac`	Interac
	`eftpos_au_debit`	eftpos オーストラリア
	`eftpos_au_visa_debit`	eftpos オーストラリア/Visa
	`eftpos_au_mastercard_debit`	eftpos オーストラリア/Mastercard

特定の成功のためのテストカード

テストカード番号	Test payment method	結果
	`offline_pin_cvm`	カード保有者にプロンプトが表示され、保有者がオフライン PIN を入力する操作がシミュレーションされます。生成される支払いで、cardholder_verification_method が `offline_pin` に設定されます。
	`offline_pin_sca_retry`	SCA トリガーの再試行フローがシミュレーションされます。このフローでは、カード保有者の初回の非接触型支払いが失敗し、リーダーから、ユーザーにカードを挿入し、オフライン PIN を入力するように求めるプロンプトが表示されます。生成される支払いで、cardholder_verification_method が `offline_pin` に設定されます。
	`online_pin_cvm`	カード保有者にプロンプトが表示され、保有者がオンライン PIN を入力する操作がシミュレーションされます。生成される支払いで、cardholder_verification_method が `online_pin` に設定されます。
	`online_pin_sca_retry`	SCA トリガーの再試行フローがシミュレーションされます。このフローでは、カード保有者の初回の非接触型支払いが失敗し、リーダーから、ユーザーにオンライン PIN を入力するように求めるプロンプトが表示されます。最終的な支払いで、cardholder_verification_method が `online_pin` に設定されます。

特定のエラーのためのテストカード

注

請求せずに直接保存するために上記のカードを使用すると、SetupIntents で、setup_intent_authentication_failure レスポンスが返されます。

We also notify you of refund failures using the refund.failed webhook event.

テストカード番号	Test payment method	結果
	`charge_declined`	支払いは `card_declined` コードで拒否されます。
	`charge_declined_insufficient_funds`	支払いは `card_declined` コードで拒否されます。decline_code 属性は `insufficient_funds` です。
	`charge_declined_lost_card`	支払いは `card_declined` コードで拒否されます。decline_code 属性は `lost_card` です。
	`charge_declined_stolen_card`	支払いは `card_declined` コードで拒否されます。decline_code 属性は `stolen_card` です。
	`charge_declined_expired_card`	支払いは `expired_card` コードで拒否されます。
	`charge_declined_processing_error`	支払いは `processing_error` コードで拒否されます。
	`refund_fail`	Charge succeeds but refunding a captured charge fails asynchronously with a `failure_reason` of `expired_or_canceled_card`. Because refund failures are asynchronous, the refund will appear to be successful at first and will only have the `failed` status on subsequent fetches.

シミュレーションされたカード提示

サーバー主導型の実装を使用する場合、リーダーでのカード保有者のタップまたはリーダーへのカードの挿入をシミュレーションするには、present_payment_method エンドポイントを使用します。

{
  "id": "tmr_xxx",
  "object": "terminal.reader",
  "action": {
    "failure_code": null,
    "failure_message": null,
    "process_payment_intent": {
      "payment_intent": "pi_xxx"
    },
    "status": "succeeded",
    "type": "process_payment_intent"
  },
  …
}

パラメーターを指定しない場合、シミュレーションされた支払いは、PaymentIntent の支払い方法のタイプに基づき、デフォルトで有効なテストカードになります。以下は、Terminal 支払い方法タイプ用のデフォルトのテストカードです。

支払い方法のタイプ	テストカード番号	Test payment method
`card_present`		`visa`
`card_present` と `interac_present`		`visa`
`interac_present`		`interac`

標準的なテストカードでは、テスト金額を使用して失敗シナリオをシミュレーションすることもできます

シミュレーションされたリーダーの更新

シミュレーションされた Bluetooth リーダーに接続している間に、シミュレーションされたリーダーの更新を設定できます。

Set the Terminal.shared.simulatorConfiguration.availableReaderUpdate to any of the following configurations. Calling connectReader triggers a simulated reader update.

Update configuration	結果
`SimulateReaderUpdateNone`	更新はないため、ユーザに何も伝える必要はありません。
`SimulateReaderUpdateRequired`	必須の更新が提供され、更新に 1 分かかります。`BluetoothReaderDelegate` は `didStartInstallingUpdate` コールバックを受信します。
`SimulateReaderUpdateAvailable`	オプションの更新を利用できます。更新が利用可能であることをユーザーに伝え、`requiredAt` の日付をハイライト表示します。
`SimulateReaderUpdateLowBattery`	必要な更新のインストールが開始されますが、リーダーのバッテリー残量が少ないため失敗します。リーダーへの接続も失敗します。これにより、以前のバージョンのソフトウェアを実行するリーダーがシミュレーションされます。
`SimulateReaderUpdateLowBatterySucceedConnect`	A required update starts to install but fails due to the reader running low on battery. Connecting to the reader succeeds. This simulates the reader running a recent version of software that’s still acceptable. Installing the update is retried when connecting to the reader again.
`SimulateReaderUpdateRandom`	上記のシナリオのランダムな選択。

テスト用の法人カード

テスト用の法人カードを使用し、Stripe Terminal リーダーで支払いをテストします。Stripe ダッシュボードの Terminal タブからリーダーおよびテスト用の法人カードを購入できます。

This physical test card supports both chip entry and contactless payments. It only works with Stripe’s pre-certified readers, and only against the Stripe API in test mode. If you attempt to use your physical test card in live mode, the Stripe API returns an error. Unless stated otherwise, use the PIN 1234 when prompted.

テスト用の法人カードを使用して支払いを作成する際は、末尾が以下の値になる金額を使用して特定のレスポンスを生成します。

小数	結果
00	支払いは承認されます。
01	支払いは `call_issuer` コードで拒否されます。
02	カード保有者向けの画面を備えたリーダーを使用する場合、テストカードを挿入 (または、サポートされている場合はタップ) します。カードで PIN が求められたら、支払いは `offline_pin_required` コードで拒否され、リーダーで PIN の入力が求められます。テスト支払いを完了するには、`1234` を入力します。
03	カード保有者向けの画面を備えたリーダーを使用する場合、テストカードを挿入 (または、サポートされている場合はタップ) します。カードで PIN が求められたら、支払いは `online_or_offline_pin_required` コードで拒否され、リーダーで PIN の入力が求められます。テスト支払いを完了するには、任意の 4 桁の PIN を入力します。
05	支払いは `generic_decline` コードで拒否されます。
55	支払いは `incorrect_pin` コードで拒否されます。
65	支払いは `withdrawal_count_limit_exceeded` コードで拒否されます。
75	支払いは `pin_try_exceeded` コードで拒否されます。

For example, a payment processed using a physical test card for the amount 25.00 USD succeeds; a payment processed for the amount 10.05 USD is declined.

Interac テストカードカナダのみ

To test your Interac integration, you can use the simulated interac test card or an Interac physical test card. You can order it from the Terminal hardware shop in the Dashboard. You can’t use the Stripe-branded physical test as an Interac card.

Interac テストカードは、interac_present 支払いと interac_present 返金の両方で機能します。card_present 支払いをテストする際に使用するのと同じテスト金額を使用できます。特に記載がない限り、要求された場合は PIN 1234 を使用してください。拒否された返金をテストするには、末尾が 01、05、55、65 または 75 の金額で一部返金を作成します。

注

Interac テストカードは、非接触型決済に対応していません。

eftpos テストカードオーストラリアのみ

To test your eftpos integration, you can use the simulated eftpos test card or an eftpos physical test card. You can order it from the Terminal hardware shop in the Dashboard. You can’t use the Stripe-branded physical test card as an eftpos card.

card_present 支払いをテストする際に使用するのと同じテスト金額を使用できます。特に記載がない限り、要求された場合は PIN 1234 を使用してください。

注