トークンリクエスタへプッシュする（Token Connect）

トークンリクエスタへのプッシュ（Token Connect）

このガイドを使用して、イシュアアプリケーションから トークンリクエスタ へカードを Mastercard MDES Token Connect.

トークンリクエスタには、eコマース加盟店やウォレットプロバイダーが含まれます。

Mastercard製品ドキュメントについては、次を参照してください MDES Token Connectの概要.

概要

Token Connectを使用すると、イシュアアプリケーションは次を行います：

1. カードに対して有効なトークンリクエスタの一覧を取得します。

2. 次を要求します プッシュURL 選択したトークンリクエスタ向けの。

3. エンドユーザーをトークンリクエスタの画面にリダイレクトして、 トークン化.

前提条件

• エンドユーザーはイシュアアプリケーションで認証されます。

• イシュアアプリケーションはD1 SDKを初期化し、ログインを完了しています。

• 消費者とカードはD1に登録されています。

エンドユーザー体験

以下の図は、Token Connectの代表的なフローを示しています。同じパターンは、Token Connect準拠のすべてのトークンリクエスタに適用されます。

Token Connectを使用してカードをトークンリクエスタへプッシュする場合のエンドユーザー体験の例。

フロー

有効なトークンリクエスタを取得

カードに対して有効なトークンリクエスタを取得します。

トークンリクエスタへプッシュ

選択したトークンリクエスタ用のプッシュURLを生成し、エンドユーザーをリダイレクトします。

シーケンス図

1

有効なトークンリクエスタを取得

イシュアアプリケーションはD1 SDKを使用して、指定したカードに対するToken Connect対応のトークンリクエスタ一覧を取得します。

各トークンリクエスタには以下が含まれます：

• 表示名。

• ブランドロゴ。

• 1つ以上のサポートされるプロビジョニング方法（例：Android、iOS、またはWeb）。

有効なトークンリクエスタを選択するためのイシュアアプリケーションUIの例。

Android

fun getEligibleTokenRequestors(d1Task: D1Task, cardID: String) {
    val callback: D1Task.Callback<List<TokenRequestor>> = object : D1Task.Callback<List<TokenRequestor>> {

        override fun onSuccess(tkRequestorList: List<TokenRequestor>) {
            // サーバーから受け取ったtkRequestorListオブジェクトを処理します。
            // 上のサンプル画像のようにUIに表示する例です。
            for (tkRequestor : TokenRequestor in tkRequestorList) {
                val tkRequestorID : String = tkRequestor.id
                val tkRequestorName : String = tkRequestor.name
                val tkRequestorAssets : MutableList<AssetContent>? = tkRequestor.assets // トークンリクエスタのロゴ。
                val tkrProvisioningMethods : MutableList<ProvisioningMethod> = tkRequestor.provisioningMethods // トークンリクエスタのプロビジョニング方法。
            }
        }

        override fun onError(exception: D1Exception) {
            // D1 SDK 統合 - エラー管理セクションを参照してください。
        }
    }

    d1Task.getTokenRequestorList(cardID, callback)
}

iOS

2

カードをトークンリクエスタへプッシュする

エンドユーザーがトークンリクエスタを選択した後、イシュアアプリケーションは次を要求します プッシュURL を呼び出して addDigitalCardToScheme().

その後、イシュアアプリケーションは返されたプッシュURLを使用して、エンドユーザーをトークンリクエスタにリダイレクトします。

Token Connectのプッシュフローを開始するためのイシュアアプリケーションUIの例。

Android

// cardID: getConsumerDetails APIで受信。
// tokenRequestor: ユーザーが選択。
fun pushCardToTokenRequestor(d1Task: D1Task, cardID: String, tokenRequestor: TokenRequestor) {
    val appURL = "d1demoapp://com.thalesgroup.gemalto.d1.validation/PushToSchemeResult" // デジタル化フロー完了時にトークンリクエスタがコールバックするイシュアアプリのカスタムURL。
    val tcsAccepted = true

    val callback: D1Task.Callback<String> = object : D1Task.Callback<String> {

        override fun onSuccess(pushUrl: String) {
            // トークンリクエスタアプリケーションを起動します。
            getActivity().startActivity(Intent(Intent.ACTION_VIEW, Uri.parse(pushUrl)))
        }

        override fun onError(exception: D1Exception) {
            // D1 SDK 統合 - エラー管理セクションを参照してください。
        }
    }

    // Click to Payの場合、MastercardのtokenRequestor.id属性値は50123197928です。
    d1Task.addDigitalCardToScheme(
        cardID,
        tokenRequestor,
        appURL,
        tcsAccepted,
        callback
    )
}

iOS

次に起こること

• D1 SDKがプッシュURLを返します。

• イシュアアプリケーションは、トークンリクエスタアプリケーション内またはWebビューでプッシュURLを開きます。

• トークンリクエスタがトークン化フローを実行します。

• フローが完了すると、トークンリクエスタは次を使用してエンドユーザーをイシュアアプリケーションに戻します appURL.

• 設定するには appURL、イシュアアプリケーションにディープリンクを実装します： Android, iOS.

• トークンリクエスタはトークン化結果をイシュアアプリケーションに返します。詳細は、Mastercardのガイドを参照してください： トークンリクエスタからの応答を受信.

Mastercard 簡略化されたアクティベーション はサポートされていません。

D1 SDKへのフルアクセスについては、次を確認してください API リファレンス.