コンテンツにスキップ
アカウントを作成
または
サインイン
Stripe ドキュメントのロゴ
/
AI に質問する
アカウントを作成
サインイン
始める
支払い
売上
プラットフォームおよびマーケットプレイス
資金管理
開発者向けリソース
概要
Stripe Payments について
構築済みのシステムをアップグレード
支払いの分析
オンライン決済
概要ユースケースを見つけるManaged Payments
Payment Links を使用する
決済ページを構築
高度なシステムを構築
アプリ内実装を構築
決済手段
決済手段を追加
決済手段を管理
Link による購入の迅速化
支払いインターフェイス
Payment Links
Checkout
Web Elements
アプリ内 Elements
決済シナリオ
複数の通貨を扱う
カスタムの決済フロー
柔軟なアクワイアリング
オーケストレーション
店頭支払い
端末
    概要
    対面支払いを受け付ける
    導入方法の設計
    リーダーを選択
    導入方法の設計
    クイックスタート
    サンプルアプリケーション
    テスト
    Terminal の設定
    実装方法を設定する
    リーダーに接続する
    決済の受け付け
    カード支払いを回収
    追加の支払い方法
    オフライン決済を受け付ける
    通信販売/電話販売の決済
    地域的な考慮事項
    購入時
    チップを回収する
    将来の使用に備えて支払い情報を収集して保存する
    柔軟なオーソリ
    決済後
    返金の取引
    領収書の提供
    Checkout のカスタマイズ
    カートの表示
    画面上の入力を収集
    スワイプで取得されたデータを収集
    NFC 機器のタップによって取得したデータを収集
    Apps on Devices
    リーダーを管理
    リーダーの注文、返品、交換
    リーダーの登録
    場所とゾーンの管理
    リーダーの設定
    リーダーを監視する
    暗号化
    リファレンス
    API リファレンス
    モバイルリーダー
    スマートリーダー
    SDK 移行ガイド
    デプロイのチェックリスト
    Stripe Terminal リーダー製品シート
決済にとどまらない機能
会社を設立する
仮想通貨
Financial Connections
Climate
ホーム支払いTerminal

注

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

画面上の入力を収集する

Terminal を使用して、顧客から入力を収集します。

リーダー: Stripe Reader S700 および BBPOS WisePOS E

Terminal スマートリーダーを使用すると、入力フォームを表示して、顧客から情報を収集できます。6 つの入力タイプから選択でき、さまざまなユースケースで利用できます。

  • phone または email 入力でロイヤルティ引き換えのための顧客識別子を収集し、バックエンドで処理します。
  • signature 入力で権利放棄と同意を顧客に認めてもらいます。
  • selection または text 入力で、アンケートへの回答を顧客に依頼します。

入力フォームは、支払い前、支払い後、支払いサイクル外のいつでも表示することができます。

サポートされている入力タイプ

対応している入力タイプ。

注

collect_inputs を使用して、機密データ (保護された健康情報や顧客の決済カード情報など)、または法律によって制限されている情報を収集することはできません。

入力を収集する

SDK リファレンス

  • collectInputs (iOS)
  • iOS SDK 4.4.0 以降

スマートリーダーがオフラインで実行中であっても顧客情報を収集できます。

Terminal のスマートリーダーを使用して入力を収集するには、Terminal SDK で collectInputs を呼び出します。SDK はリーダーと通信して、構築済みの UI を表示します。一度に最大 5 件の入力を指定でき、リーダーはそれらを順番に収集します。顧客がデータを入力すると、SDK は収集したデータをコールバックで返します。

CollectInputsViewController.swift
Swift
let signatureInput = try SignatureInputBuilder(title: "Please sign") .setStripeDescription("Please sign if you agree to the terms and conditions") .setSkipButtonText("skip form") .setSubmitButtonText("Submit signature") .build() let firstSelectionButton = try SelectionButtonBuilder(style: .primary, text: "Yes", id: "yes_id") .build() let secondSelectionButton = try SelectionButtonBuilder(style: .secondary, text: "No", id: "no_id") .build() let firstToggle = try ToggleBuilder(defaultValue: .enabled) .setTitle("Sign up for promotional emails") .build() let selectionInput = try SelectionInputBuilder(title: "Choose an option") .setStripeDescription("Were you happy with our customer service?") .setRequired(true) .setSelectionButtons([firstSelectionButton, secondSelectionButton]) .setToggles([firstToggle]) .build() let collectInputsParams = try CollectInputsParametersBuilder( inputs: [signatureInput, selectionInput] ).build() let cancelable = Terminal.shared.collectInputs(collectInputsParams) { (collectInputsResult, error) in if let error = error { // Placeholder for handling error } else if let result = collectInputsResult { // Placeholder for handling collected inputs } }

カスタマイズ

すべての入力タイプでデザインと動作をカスタマイズすることができます。

  • 重要な入力が確実に収集されるように、required として設定します。必須入力の場合、スキップボタンは非表示になります。
  • title と description を使用して、リーダー画面で入力ごとに表示するテキストを指定し、顧客にコンテキストを提供します。
フィールド名
最大文字数
title
40
description
selection フォームで使用する場合は 500、他のタイプのフォームで使用する場合は 100
submit_button
30
skip_button
14
  • テキストに改行 を加えて、書式を改善します。
  • 最大 4 つのトグルを追加して、顧客がブール値のオプション、契約、またはオプトインを有効または無効にできるようにします。
メールと選択フォームに含まれるトグル

トグルを含むメールアドレスと選択フォーム

フィールド名
最大文字数
title
50、説明のトグル使用時は 25
description
50、タイトルのトグル使用時は 25
  • selection タイプの入力では、style パラメーターを使用して choices の強調や強調解除ができます。
選択項目のスタイル

プライマリ選択とセカンダリ選択の項目スタイル。

顧客とのやり取り

リーダーが入力の収集を開始すると、リストから最初の入力が表示されます。

顧客がすべての入力を完了すると、リーダーは 3 秒間にわたって移行状態に変わり、後続のリクエストを待ちます。3 秒経過しても後続のリクエストがなかった場合、リーダーはスプラッシュ画面に戻ります。

注

お客様は、この機能の使用に対して適用され、該当する法律と規制のすべてを理解してこれに準拠する責任をすべて負うものとされ、その使用に関連して、規定に従い、必要なすべての同意、承認、ライセンス、権利および許可を取得する必要があります。Terminal スマートリーダ-によって収集される入力、またはスマートリーダーから表示される出力を使用して顧客と契約を結ぶ場合、または顧客に通知を提供する場合、その契約または通知の法的な妥当性と法的強制力を確保することは、お客様の責任になります。

入力データを受信する

すべての入力の収集またはスキップが完了すると、Terminal SDK は収集されたデータを返します。

  • 署名タイプの入力に対して返されるデータは、SVG 形式の文字列になります。
  • 選択タイプの入力に対して返されるデータは、選択されたボタンの text フィールドおよび id フィールドです。
  • 電話、メール、テキスト、数値の各入力に対して返されるデータは、顧客のレスポンスの文字列になります。
  • 顧客がオプションの入力をスキップした場合、skipped ブール値が true に設定されます。
  • トグルごとに、入力トグルリストのインデックスに対応する enabled、disabled、または skipped が返されます。

Terminal SDK は、アクションのキャンセル、回収のタイムアウト、その他のエラーが発生した場合にエラーを返します。

構築したシステムをテストする

SDK のシミュレーションされたリーダーを使用して、実装をテストできます。入力情報の収集をテストする前に、まずシミュレーションされたインターネットリーダーに接続する必要があります。

シミュレーションされたリーダーは、以下のシナリオのシミュレーションに対応しています。

  • 入力をスキップすることなく入力情報の収集に成功
  • 不要な入力をすべてスキップして入力情報の収集に成功
  • タイムアウトのため、入力情報の収集に失敗

入力情報の収集の成功をシミュレーションする場合、SDK はタイプに基づいて各入力にハードコード化された値を返します。

CollectInputsViewController.swift
Swift
// Simulated internet reader must already be connected Terminal.shared.simulatorConfiguration.simulatedCollectInputsResult = SimulatedCollectInputsResultSucceeded( simulatedCollectInputsSkipBehavior: .none ) let collectInputsParams = try CollectInputsParametersBuilder( inputs: // Placeholder for specifying the inputs you want to simulate collecting ).build() let cancelable = Terminal.shared.collectInputs(collectInputsParams) { (collectInputsResult, error) in if let error = error { // Placeholder for handling error } else if let result = collectInputsResult { // Placeholder for handling collected inputs } }
このページはお役に立ちましたか。
はいいいえ
お困りのことがございましたら 、サポートにお問い合わせください。
早期アクセスプログラムにご参加ください。
変更ログをご覧ください。
ご不明な点がございましたら、お問い合わせください。
LLM ですか?llms.txt を読んでください。
Powered by Markdoc