APIプロトコル

プロトコルとメッセージ形式

イシュアゲートウェイAPIはRPCスタイルのAPIです。各メソッドはHTTPエンドポイントに対応します。リクエストとレスポンスはJSONペイロードを使用します。

A 200 OK HTTPステータスはリクエストが成功したことを意味します。

Swaggerファイル

トークナイゼーションサービスAPI（イシュアゲートウェイAPI）はSwagger（OpenAPI）定義として利用可能です。クライアントコードを生成したり、リクエストを検証するために使用してください。

OpenAPI定義をダウンロード：

• インバウンド（イシュアバックエンド → トークナイゼーションサービス）
• アウトバウンド（トークナイゼーションサービス → イシュアバックエンド）

API概要

APIにはインバウンドとアウトバウンドのエンドポイントがあります：

• アウトバウンド：トークナイゼーションサービスが イシュアバックエンド.
• インバウンド： イシュアバックエンド がトークナイゼーションサービスを呼び出します。

アウトバウンド

THALES から イシュアへのリクエスト	説明
NotifyVirtualCardChange	このリクエストはトークナイゼーションサービスがトークンの状態の変更をイシュアバックエンドに通知するために使用します。
RequestCardDigitalization	このリクエストはトークナイゼーションサービスが資金用カードのデジタル化に対するイシュアバックエンドの同意を求めるために使用します。
CheckCardEligibility	このリクエストはトークナイゼーションサービスが資金用カードがトークナイゼーションの対象となるかどうかを確認するために使用します。
SendOTP	このリクエストはトークナイゼーションサービスがステップアップ認証のために決済ネットワークが生成したOTPを送信するために使用します。イシュアバックエンドは選択された方法でエンドユーザーにOTPを送信する必要があります。

インバウンド

イシュアから THALES へのリクエスト	説明
UpdateCard	このリクエストはイシュアバックエンドがカード情報を更新するために使用します。例えば： - 資金用カードのPANと有効期限（カード更新時） - カードプロファイル
UpdateCardState	このリクエストはイシュアバックエンドがカードまたはトークンの状態更新を要求するために使用します。
GetCardInfo	このリクエストはイシュアバックエンドが特定の資金用カードに対して発行されたトークン情報を取得するために使用します。
SendMessage	Apple Pay限定。このリクエストはイシュアバックエンドがウォレットアプリ内のエンドユーザーにテキストメッセージを送信するために使用します。

開発上の考慮事項

イシュアゲートウェイAPIはほとんどの操作でステートフルです。イシュアバックエンドはトークナイゼーションサービスのリクエストを正しく処理するためにセッション状態を管理する必要があります。

登録（Enrollment）

• 複数のAPIコールを使用します。
• 各ステップで返される必要な情報を保存してください。
• 次を使用してください x-correlation-id ヘッダーを使用して同じセッションからのすべてのリクエストを相関させてください。

LCM（ライフサイクル管理）

• 完了および未完了のシナリオを管理するためにトークナイゼーションサービスに依存してください。
• 次を使用してください x-correlation-id ヘッダーを使用して同じセッションからのすべてのリクエストを相関させてください。