コンテンツにスキップ
アカウントを作成
または
サインイン
Stripe ドキュメントのロゴ
/
アカウントを作成
サインイン
概要構築済みのシステムをアップグレード
オンライン決済
概要ユースケースを見つけるManaged Payments
決済手段
支払いインターフェイス
決済シナリオ
店頭支払い
端末
他の Stripe プロダクト

注

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

スワイプデータを収集する非公開プレビュー

Terminal を使用してリーダーのハードウェアインターフェイスでデータを収集します。

ページをコピー

プライベートプレビュー

データ収集の非公開ベータ版へのアクセスをリクエストする場合は、次の情報を添えて terminal-collect-data@stripe.com までお問い合わせください。

  • ユースケース
  • 端末装置とシステムタイプ
  • 磁気ストライプのデータフォーマット
  • プロバイダー (サードパーティーのカードプロバイダーを利用している場合)

Use the Terminal SDK and the reader’s hardware interfaces (such as the magnetic stripe reader) to read non-PCI payment methods such as gift cards. This feature isn’t available offline.

カードをスワイプした後、 Terminal SDK はトークン化されたデータオブジェクトを提供します。このトークンを使用して、バックエンドでクリアテキストの追跡データを安全に取得します。

Terminal リーダーは、以下のフォーマットに沿ったクリアテキストの磁気ストライプデータのみを読み取り、保存します。

  • カードデータはトラック 2 でのみ使用できます。
  • カードデータは、ISO/IEC-7813 のトラック 2 の開始点 ; と終了点 ? のみを使用します。区切り文字は使用しません。
  • カードデータは数字のみで構成されます。

承認済みのフォーマットとカード番号が一致しない場合は、カードのフォーマットと BIN 範囲をご用意のうえ、Terminal チームにお問い合わせください。

スワイプデータの収集は、以下で利用できます。

データを収集

Terminal.collectData() を使用して、POS アプリケーションからのデータ収集を求めます。関数に渡す設定で、受信する収集データのタイプ (磁気ストライプなど) を指定します。カードをスワイプすると、SDK はデータを表すトークンを返します。スワイプが失敗した場合はエラーを返します。導入時にこのトークンを使用してデータを参照します。

PaymentViewController.swift
import UIKit
import StripeTerminal

class PaymentViewController: UIViewController {
    func readGiftCard() throws {
        let config = try CollectDataConfigurationBuilder().setCollectDataType(.magstripe).build()
        self.cancelable = Terminal.shared.collectData(config) { collectedData, collectError in
            if let error = collectError {
                // Handle read errors
                print("Collect data failed: \(error)")
            } else if let data = collectedData, let stripeId = data.stripeId {
                print("Received collected data token: \(stripeId)")
            }
        }
    }
}

Fetch collected data

When you need to perform operations such as redeeming a gift card, fetch the cleartext data from your backend using the collected data token. The collected data is stored on Stripe’s servers for 24 hours.

Command Line
curl https://api.stripe.com/v1/terminal/reader_collected_data/tmrcd_xxxxxxxx \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

注

Stripe doesn’t perform and isn’t responsible for the authentication of collected data or the authorization of transactions using collected data. Stripe isn’t liable for any illegal conduct or fraud by any third party associated with the collected data.

このページはお役に立ちましたか。
はいいいえ
お困りのことがございましたら 、サポートにお問い合わせください。
早期アクセスプログラムにご参加ください。
変更ログをご覧ください。
ご不明な点がございましたら、お問い合わせください。
LLM ですか？llms.txt を読んでください。
Powered by Markdoc