リーダーに接続する
アプリケーションを Stripe Terminal リーダーに接続します。
注
まだリーダーを選択していない場合は、利用可能な Terminal リーダーを比較して、ニーズに最適なリーダーを選択してください。
iPhone のタッチ決済では、ユーザーは、互換性のある iPhone と Stripe Terminal SDK で対面の非接触型決済を受け付けることができます。iPhone のタッチ決済は、Visa、Mastercard、アメリカン・エキスプレス、ディスカバーの非接触型カードと NFC ベースのモバイルウォレット (Apple Pay、Google Pay、Samsung Pay) に対応しています。iPhone のタッチ決済は、Terminal iOS SDK に含まれ、iOS モバイルアプリで直接支払いを受け付けることができます。
場所を作成するサーバー側ダッシュボード![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
リーダーを使用する実際の場所ごとに場所を作成します。display_
をビジネスを表す名前に設定します。リーダーに接続する際にビジネスの名前を明示的に指定しない限り、顧客のデバイスのタップ画面に display_
が表示されます。必要に応じて既存の場所を編集すると、このテキストを変更できます。
リーダーを頻繁に移動させる必要があるビジネスの場合、場所にはビジネスが主に行われている場所を示す住所を使用できます。
API を使用して場所を作成するには、Create location (場所の作成) リクエストを使用します。
場所がアメリカの場合は以下が必要です。
line1
city
state
postal_
code country
ダッシュボードで場所を作成するには、場所ページの +New (新規) ボタンをクリックします。
リーダーを検出する![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
discoverReaders メソッドを使用して、お使いの iPhone がタッチ決済に対応しているかを判断します。対応デバイスの条件を満たしていないデバイスでアプリケーションが実行された場合、completion
ハンドラがエラーで呼び出されます。
リーダーに接続する![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
iPhoneのタッチ決済での決済の受け付けを開始するには、検出されたリーダーを connectLocalMobileReader
メソッドに指定します。また、リーダーに必要になる可能性のある更新を処理するため、デリゲートを作成する必要もあります。
on_
を指定したデスティネーション支払いを使用する場合、SCPLocalMobileConnectionConfiguration
に連結アカウント ID も指定する必要があります。
任意で、支払い回収画面で買い手に表示する名前を指定できます。名前を指定しない場合、指定された場所に関連付けられている display_
が表示されます。
デバイスの設定を処理する![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
互換性のある iPhone のタッチ決済リーダーに接続する際、設定の更新が必要になる場合があり、そのために数分かかることがあります。加盟店の待ち時間を短縮するために、前もってバックグラウンドでリーダーを接続しておくことをお勧めします。
設定のステップを処理して、顧客に待機を求めるメッセージを表示するために、アプリケーションで SCPLocalMobileReaderDelegate
を実装していることを確認してください。設定のステップはソフトウェア更新として表示されるため、必要に応じて進捗状況を加盟店に表示することができます。
口座の関連付けおよび Apple 利用規約![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
ユーザーがリーダーに初めて接続すると、Apple の iPhone のタッチ決済利用規約が表示されます。Apple に登録するには、Apple によって表示される利用規約に同意する前に、ビジネスを表す有効な Apple ID を指定する必要があります。この操作は、Stripe アカウントごとに 1 回のみ実行する必要があります。このフローは、他のモバイルデバイスで使用する場合も含めて、同じ Stripe アカウントを使用する以降の接続では表示されません。
それぞれの連結アカウントは、次の場合に利用規約に同意する必要があります。
- Connect ユーザーがダイレクト支払いを作成する
- Connect ユーザーがデスティネーション支払いを作成し、
on_
アカウントを指定するbehalf_ of
![](https://b.stripecdn.com/docs-statics-srv/assets/ttpoi-account-linking-steps.56bc5c0bb037a98f788a7e8d43d0c87e.png)
Apple ID アカウントを関連付けて、タッチ決済による決済を受け付ける
iPhone は、iPhone のタッチ決済の connectLocalMobileReader
を呼び出すと、24 時間以内にアプリ全体で一意の Stripe アカウントを最大 3 件使用できます。同じ 24 時間以内に同一デバイスで別のアカウントが使用されると、connectLocalMobileReader
メソッドは SCPErrorAppleBuiltInReaderMerchantBlocked) エラーを発生させます。
口座の関連付けについて、詳細は Apple iPhone のタッチ決済 FAQ の「iPhoneのタッチ決済のビジネス情報」セクションをご覧ください。
接続切断に対処する![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
アプリケーションがバックグラウンドになるか、iPhone のインターネット接続が失われると、リーダーは切断されます。これを処理する方法は 2 つあります。
切断を手動で処理する
この接続の切断に対処するには、アプリケーションで SCPTerminalDelegate terminal:didReportUnexpectedReaderDisconnect: デリゲートメソッドを実装する必要があります。このコールバックを使用して、問題が発生したことと、インターネット接続を継続する必要があることをユーザーに通知することができます。さらに、アプリケーションが再びフォアグラウンドになったときに、リーダーに手動で再接続することもできます。
自動的に再接続を試行する
アプリで LocalMobileConnectionConfiguration
の autoReconnectOnUnexpectedDisconnect
を true
に設定し、ReconnectionDelegate
で見つかったコールバックを実装する必要があります。autoReconnectionDelegate
を LocalMobileConnectionConfiguration
に渡す必要もあります。
自動的に再接続を試行すると、以下が発生します。
- 切断が発生すると、SDK は自動的に再接続しようとし、
onReaderReconnectStarted
を介して通知します。接続が切れて、再接続が進行中であることを必ずアプリで知らせてください。Cancelable
オブジェクトを使用して、いつでも再接続の試行を停止できます。
- SDK でリーダーへの再接続が成功すると、
onReaderReconnectSucceeded
を介して通知されます。接続が復元され、通常の動作が続行することを、必ずアプリで知らせてください。 - SDK がリーダーに接続できない場合は、
onReaderReconnectFailed
を介して通知されます。必ず、予期しない切断が発生したことをアプリで知らせてください。
BBPOS および Chipper™ の名称およびロゴは BBPOS Limited の米国および/またはその他の国における商標または登録商標です。Verifone® の名称およびロゴは Verifone の米国および/またはその他の国における商標または登録商標のいずれかです。これらの商標の使用は BBPOS または Verifone による何らかの承認を意味するものではありません。