
#25 カード番号のトークン化⑤〜トークン化時のメタデータとlistTokensが空で応答する原因〜
はじめに
カード番号のトークン化(=プロビジョニング)において、モバイルのWalletアプリ(AppleウォレットやGoogleウォレット)に非接触ICカードを発行したり、非対面加盟店のCOFでトークン化したカード情報を渡すのと同時に、それに付随する情報(メタデータ)も一緒に渡しています。
今回はそのメタデータが何者かと、メタデータに関係するイシュアApp - Walletアプリ間の会話でつまづきやすいポイント(※よく相談受けるポイント)を解説してしまいます。
※:Google push provisioning API のウォレットの状態を読み取るlistTokensメソッドが空で応答される
プロビジョニングとメタデータ
カード情報のトークン化①ではApple Walletへプロビジョニングするイメージで書きましたが、Google Walletも同様で、モバイルへトークン番号で非接触ICカードを発行しているのがプロビジョニングです。
そして、プロビジョニングでは"非接触ICカードを発行する"のと同時に、そのカードに付随する情報(メタデータ)も、リクエスト元(トークンリクエスター)へ一緒に渡されます。※以下の青吹き出し


物理(板)カードの発行にはないデジタルならではの話ですね。
メタデータの内容
では実際その付随情報(メタデータ)って何だ?というと、主に以下のような情報です。
カード名称や説明
カードアート(券面画像データ)
規約URL
プライバシーポリシーURL
イシュア連絡先
イシュアアプリ情報(package name)
Walletでカードの詳細情報として表示する情報と考えるとわかりやすいです。
メタデータの設定
メタデータはプロビジョニング時にモバイルに一緒に落ちる情報ということは分かりましたが、では誰がどこに設定するか?ですが、これは単純にイシュアがTSPに事前に登録している情報です。

WalletAppとイシュアApp
先述の通り、メタデータにはイシュアアプリ情報があります。これはつまりプロビジョニングの際に付随情報として"このカードのイシュアアプリはこれですよ"という情報を落としているわけです。
私はよくモバイルのプロビジョニング及びその後のアプリでのハンドリングに関する相談を受けるのですが、Google Payに対応するにあたって多くつまづくポイントが、「listTokensの応答が空で返ってくる」という相談です。
listTokensメソッドはGoogle Pay push provisioning APIで"イシュアAppがGoogle Walletに対してトークンのリストをください"と単純にリクエストするものです。
イシュアAppは単純にくださいとリクエストするんですが、Google Walletはリクエスト元のAppが何者かわかっているので、リクエスト元のAppに対応したトークンしか応答しません(キーがメタデータのイシュアアプリ情報になっている)。
つまり、以下のようにGoogle Walletに3つのカードが入っている場合は「card A」のみが応答される仕組みになっています(当然の話)。

そのため、事前にcard AのイシュアがTSPへイシュアアプリ情報の登録せずにプロビジョニングしてからlistTokens()した場合、"あなたのアプリに応答できるカードはありません"、つまりイシュアアプリがlistTokens()しても空っぽで返ってきてしまう、というわけです。

ちなみにAppleのpasses()メソッドで同じことが言えるのですが、日本のApple Pay特有のちょっと複雑な理由(#17 「Apple PayからFelica系決済サービスが消える日」をよんで)もあったりで、主にGoogle Payでつまづく印象です。
また、イシュアアプリ情報はイシュアAppがWalletアプリに対して、照会をかけるだけでなく、逆にWalletアプリからイシュアAppを特定するのにも使われる、つまり双方向に使われるものなので、UI/UX上非常に重要な役割を果たします。
特段の理由がない限りはTSPに設定して置くことが推奨されます。
まとめ
今回はプロビジョニングにおけるメタデータと、その中のイシュアアプリ情報の役割について説明しました。メタデータのTSPへの設定は最初に登録のミス及び失念をしてしまってサービスを開始してしまうと、TSPの修正をするだけでは問題が収束せず、再度のプロビジョニングをしないとモバイルWalletに落ちてしまったメタデータは更新されません。
板の世界で間違ったカードを発行してしまい差し替えをする、ということよりは楽に見えますがその影響度合いは相当なものになることも考えられます。
しっかりと仕様を理解して検証と登録漏れのないようにすることが求められます。当然ですね(笑)