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`	Simulates the cardholder being prompted for and entering an offline PIN. The resulting charge has cardholder_verification_method set to `offline_pin`.
	`offline_pin_sca_retry`	Simulates an SCA-triggered retry flow where a cardholder’s initial contactless charge fails and the reader then prompts the user to insert their card and enter their offline PIN. The resulting charge has cardholder_verification_method set to `offline_pin`.
	`online_pin_cvm`	Simulates a cardholder being prompted for and entering an online PIN. The resulting charge has cardholder_verification_method set to `online_pin`.
	`online_pin_sca_retry`	Simulates an SCA-triggered retry flow where a cardholder’s initial contactless charge fails and the reader then prompts the user to input their online PIN. The final charge has cardholder_verification_method set to `online_pin`.

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

注

Using these specific cards for saving directly without charging and SetupIntents returns a setup_intent_authentication_failure response.

テストカード番号	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. We also notify you of refund failures using the `refund.failed` webhook event. This simulated error is only supported in the JavaScript SDK.

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

サーバー主導型の実装を使用する場合、リーダーでのカード保有者のタップまたはリーダーへのカードの挿入をシミュレーションするには、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` コールバックを受信します。
`SimulateReaderUpdateRequiredForOffline`	A required update is past due and takes 1 minute. If operating offline, reader connection is unavailable. Your `BluetoothReaderDelegate` receives the `didStartInstallingUpdate` callback.
`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 a sandbox. 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	When using readers featuring a cardholder-facing screen, insert (or tap, if supported) the test card. If the card requires a PIN, the payment declines with `offline_pin_required` and requests PIN entry if the reader supports chip entry. Enter `1234` to complete the test payment.
03	When using readers featuring a cardholder-facing screen, insert (or tap, if supported) the test card. If the card requires a PIN, the payment declines with `online_or_offline_pin_required` and requests PIN entry. Enter any 4-digit PIN to complete the test payment.
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 を使用してください。

注