get smart tap data
コマンドは、モバイル デバイスにセットアップ情報をリクエストし、環境情報を提供します。環境情報は、現在のコンテキストで送信する必要があるペイロードを決定するためにモバイル デバイスによって使用されます。端末は、次のオペレーションに備えてモバイル デバイスからのレスポンスを使用します。
スマートタップ データ コマンドを取得する
クラ | IN | P1 | P2 | Lc | データ | ル |
---|---|---|---|---|---|---|
90 | 50 | 00 | 00 | xx | サービス リクエストの NDEF レコード | 00 |
サービス リクエストの NDEF レコード
オフセット | 長さ | 説明 | レコードタイプ | ペイロードの形式 | M/O/C |
---|---|---|---|---|---|
0 | 6 | サービス リクエストの NDEF ヘッダー | srq |
NDEF ヘッダー | M |
6 | 2 | サービス リクエストの NDEF バージョン(0001 ) |
バイナリ | M | |
8 | 16 | セッションの NDEF レコード | ses |
M | |
24 | 変 | 販売者の NDEF レコード | mer |
M | |
… | 変 | サービスリストの NDEF レコード | slr |
M | |
… | 変 | POS 機能の記録 | pcr |
O |
販売者の NDEF レコード
オフセット | 長さ | 説明 | レコードタイプ | レコード ID | ペイロードの形式 | M/O/C |
---|---|---|---|---|---|---|
0 | 6 | 販売者の NDEF ヘッダー | mer |
NDEF ヘッダー | M | |
6 | 変 | コレクタ ID NDEF レコード | cld |
プリミティブ | M | |
… | 変 | 店舗 ID ID NDEF レコード | lid |
プリミティブ | O | |
… | 変 | 端末 ID の NDEF レコード | tid |
プリミティブ | O | |
… | 変 | 販売者名の NDEF レコード | 火 | mnr |
RTD_テキスト | O |
… | 変 | 販売者カテゴリの NDEF レコード | mcr |
プリミティブ | O |
コレクタ ID は Google によって割り当てられた番号です。通常は 8 桁の数字です。
販売者カテゴリとは、ネットワークで定義されている販売者のカテゴリを参照する 4 桁の販売者コードです。
サービスリストの NDEF レコード
オフセット | 長さ | 説明 | レコードタイプ | ペイロードの形式 | M/O/C |
---|---|---|---|---|---|
0 | 6 | サービスリストの NDEF ヘッダー | slr |
NDEF ヘッダー | M |
6 | 変 | サービスタイプ リクエスト NDEF レコード 1 | str |
M | |
… | ... | ... | ... | ... | |
… | 変 | サービスタイプ リクエスト NDEF レコード n | str |
O |
サービスタイプ リクエストの NDEF レコード
オフセット | 長さ | 説明 | レコードタイプ | ペイロードの形式 | M/O/C |
---|---|---|---|---|---|
0 | 6 | サービスタイプ リクエストの NDEF ヘッダー | str |
NDEF ヘッダー | M |
6 | 1 | サービスタイプのバイト | バイナリ | M |
サービスタイプのバイト
値 | 説明 |
---|---|
0×00 | すべてのサービス |
0x01 | PPSE を除くすべてのサービス |
0x02 | PPP |
0x03 | ロイヤルティ |
0x04 | 特典 |
0x05 | ギフトカード |
0x06 | ハウスカード |
0x07 | イベントのチケット |
0x08 | フライト |
0x09 | 交通機関 |
0x0A ~ 0x0F | RFU twi |
0×10 | クラウドベースのウォレット |
0×11 | モバイル マーケティング プラットフォーム |
0x12 | 汎用 |
0x12 ~ 0x3F | RFU twi |
0×40 | ウォレットの顧客 |
0x6F | RFU ウォレット固有 |
0x9F | RFU 販売者固有 |
POS 機能の NDEF レコード
オフセット | 長さ | 説明 | レコードタイプ | ペイロードの形式 | M/O/C |
---|---|---|---|---|---|
0 | 6 | POS 機能の NDEF ヘッダー | pcr |
NDEF ヘッダー | M |
6 | 1 | システム機能のビットマップ | バイナリ | M | |
7 | 1 | UI 機能のビットマップ | バイナリ | M | |
8 | 1 | 決済機能に関するビットマップ | バイナリ | M | |
9 | 1 | CVM 機能のビットマップ | バイナリ | M | |
10 | 1 | タップ機能のビットマップ | バイナリ | M |
POS 機能のビットマップ
0x01 | 0x02 | 0x04 | 0x08 | 0×10 | 0×20 | 0×40 | 0×80 | |
---|---|---|---|---|---|---|---|---|
システム | スタンドアロン | 半統合 | 手動操作なし | オンライン | オフライン | MP | zlib のサポート | 未完了 |
UI | プリンタ | プリンタのグラフィック | ディスプレイ | 画像 | 音声 | アニメーション | 動画 | 未完了 |
購入手続き | サポートの支払い | デジタル レシートをサポートする | サポートサービスの発行 | OTA POS データをサポートする | 未完了 | 未完了 | 未完了 | 未完了 |
CVM | オンライン PIN | CD PIN | 署名 | CVM なし | デバイス生成コード | SP 生成コード | ID キャプチャ | 生体認証 |
タップ | パスのみ | 支払いのみ | お支払い | お支払いの引き継ぎ | 未完了 | 未完了 | 未完了 | 未完了 |
スマートタップ データ レスポンスを取得する
get smart tap data
レスポンス メッセージのサービス リクエストの NDEF レコードには、レコード バンドル NDEF レコードか、1 つ以上の暗号化されていない非圧縮サービスの NDEF レコードのリストが含まれています。
スマートタップが APDU よりも大きいレスポンス ペイロードをサポートする方法の詳細については、データ チャンクをご覧ください。
オフセット | 長さ | 説明 | レコードタイプ | ペイロードの形式 | M/O/C |
---|---|---|---|---|---|
0 | 変 | サービス リクエストの NDEF レコード | srs |
M | |
… | 2 | ISO 7816-4 ステータス | バイナリ | M |
サービス レスポンスの NDEF レコード
オフセット | 長さ | 説明 | レコードタイプ | ペイロードの形式 | M/O/C |
---|---|---|---|---|---|
0 | 6 | サービス レスポンス NDEF ヘッダー | srs |
NDEF ヘッダー | M |
6 | 16 | セッションの NDEF レコード | ses |
M | |
22 | 変 | レコード バンドルの NDEF レコード | reb |
C | |
… | 変 | サービス NDEF レコード 1 | asv |
C | |
… | ... | ... | ... | ... | |
… | 変 | サービス NDEF レコード n | asv |
O |
レコード バンドルの NDEF レコード
オフセット | 長さ | 説明 | レコードタイプ | ペイロードの形式 | M/O/C |
---|---|---|---|---|---|
0 | 6 | NDEF ヘッダー | reb |
NDEF ヘッダー | M |
6 | 1 | ペイロードのステータスのビットマップ | バイナリ | M | |
7 | 変 | ペイロード | バイナリ | M |
ペイロード ステータスのビットマップ
0x01 | 0x02 | 0x04 | 0x08 | 0×10 | 0×20 | 0×40 | 0×80 | |
---|---|---|---|---|---|---|---|---|
ペイロードのステータス | 暗号化あり | 圧縮後 | 未完了 | 未完了 | 未完了 | 未完了 | 未完了 | 未完了 |
連結、暗号化なし、解凍されたペイロード
応答データが複数の APDU でチャンクされている可能性がある。まず、ターミナルは reb
レコードのペイロードを取得し、追加のスマートタップ データ レスポンスを取得する場合はそのペイロードを取得し、連結します。 101}
reb
レコードのステータス ビットマップで示されるように、連結されたペイロードは暗号化および zlib 圧縮されます。ペイロードは、まず復号し(該当する場合)、次に解凍する必要があります。ペイロードは、成功したネゴシエーションが発生した場合にのみ暗号化されます。ネゴシエーション レスポンスのステータスが 9500
の場合でも、ネゴシエーションは成功したと見なされ、ペイロードは暗号化されます。ペイロードが圧縮されるのは、POS 機能の NDEF レコードが存在していて、圧縮が許容されていて、圧縮によりペイロードのサイズが縮小される場合のみです。
ペイロードを復号する方法の詳細については、暗号化をご覧ください。
ペイロードが連結、復号、解凍されると、返されるレスポンス データにはサービスの NDEF レコードのリストが含まれます。
オフセット | 長さ | 説明 | レコードタイプ | ペイロードの形式 | M/O/C |
---|---|---|---|---|---|
0 | 変 | サービス NDEF レコード 1 | asv |
O | |
… | ... | ... | ... | ... | |
… | 変 | サービス NDEF レコード n | asv |
O |
サービスの NDEF レコード
オフセット | 長さ | 説明 | レコードタイプ | ペイロードの形式 | M/O/C |
---|---|---|---|---|---|
0 | 6 | サービスの NDEF ヘッダー | asv |
NDEF ヘッダー | M |
6 | 変 | サービス カード発行会社の NDEF レコード | i | サービス カード発行会社のバイトによる PRIMITIVE | M |
… | 変 | サービス オブジェクト NDEF レコード 1 | 変更可能 | M | |
… | ... | ... | ... | ... | ... |
… | 変 | サービス オブジェクト NDEF レコード n | 変更可能 | M |
サービス カード発行会社のバイト
値 | 説明 |
---|---|
0×00 | 指定なし |
0x01 | 販売者が発行 |
0x02 | ウォレットを発行しました |
0x03 | 製造元 |
0x04 ~ 0x2F | RFU twi |
0x30 ~ 0x4F | RFU ウォレット固有 |
0x50 ~ 0x6F | RFU 販売者固有 |
Google ウォレットで
顧客レコードに使用されるサービス カード発行会社のバイトは常に 0x02
であり、残りのサービス カード発行会社レコード ペイロードは常に 0x71797971
です。
現在定義されている他のすべての
サービス オブジェクト レコードに対して Google ウォレットが使用するサービス カード発行会社のバイトは常に 0x01
です。サービス発行者レコードの残りの部分は、発行者のコレクタ ID です。コレクタ ID が存在する場合は、パスを発行したアカウント。存在しない場合は 0x00000000
に設定されます。すべてのクーポン発行者アカウントにコレクタ ID が定義されている必要があります。ただし、パスを発行する発行者アカウントがクーポン発行者アカウントではない場合があるので注意してください。
関連するステータスの単語
カテゴリ | 関連するステータスの単語 |
---|---|
90xx | 9000、9001 - Pass over Payment で使用 |
91xx | 9100、9101 - パス/支払い、9102 - パス オーバー支払い |
92xx | すべて |
93xx | すべて |
94xx | すべて |
95xx | なし |
6xxx | 6A82 |
9100
は追加データがあることを示します。そのため、ターミナルは get additional data
リクエストを行う必要があります。
9001
は、支払いオーバーのタップである場合に支払いに進むことを示します。パスのみのタップまたはパスと支払いのタップの場合、9001
の想定される動作は 9000
と同じです。
9101
と 9102
は、支払いの準備が整っていないこと、および支払いに進むことができないことを示します。
詳しくは、ステータスに関する文言をご覧ください。
その他のスマートタップ データ コマンドを取得する
クラ | IN | P1 | P2 | Lc | データ | ル |
---|---|---|---|---|---|---|
90 | 最高 | 00 | 00 | 00 |
[スマートタップ データを追加] コマンドに、データ ペイロードはありません。
スマートタップのデータ レスポンスを受け取る
オフセット | 長さ | 説明 | レコードタイプ | ペイロードの形式 | M/O/C |
---|---|---|---|---|---|
0 | 変 | ペイロード | バイナリ | M | |
… | 2 | ISO 7816-4 ステータス | バイナリ | M |
関連するステータスの単語
カテゴリ | 関連するステータスの単語 |
---|---|
90xx | 9000 |
91xx | 9100、9101 - パス/支払い、9102 - パス オーバー支払い |
92xx | すべて |
93xx | すべて |
94xx | すべて |
95xx | なし |
6xxx | 6A82 |
9100
は追加データがあることを示します。そのため、ターミナルはさらに get additional data
リクエストを行う必要があります。
9101
と 9102
は支払いの準備ができていないことを示し、ターミナルは支払いに進むことができません。
詳しくは、ステータスに関する文言をご覧ください。