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

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

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

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

概要

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

カードに対して対象のトークンリクエスタ一覧を取得します。
要求します。 プッシュ URL 選択したトークンリクエスタ用に。
エンドユーザーをトークンリクエスタの体験画面にリダイレクトして、 トークン化.

前提条件

エンドユーザーはイシュアアプリケーションで認証されます。
イシュアアプリケーションはD1 SDKを初期化し、ログインを完了しています。
消費者とカードはD1に登録されています。

エンドユーザー体験

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

フロー

対象のトークンリクエスタを取得

トークンリクエスタにプッシュする

シーケンス図

対象のトークンリクエスタを取得

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

各トークンリクエスタには次が含まれます。

表示名。
ブランドロゴ。
1つ以上の対応プロビジョニング方法（例: Android、iOS、またはWeb）。

fun getEligibleTokenRequestors(d1Task: D1Task, cardID: String) {
    activity.lifecycleScope.launch(Dispatchers.Main) {
        try {
            val tkRequestorList = withContext(Dispatchers.IO) {
                d1Task.pushProvisioningService.getTokenRequestorList(
                    cardID
                ).await()
            }

            // サーバーからの 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 // トークンリクエスタのプロビジョニング方法
            }
        } catch (exception: D1Exception) {
            // D1 SDK 統合 – エラー管理のセクションを参照してください
        }
    }
}

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)
}

let cardID = "" // 例: サーバーから取得
        
do {
    let service = try d1Task.pushProvisioningService()
    let tokenRequestors = try await service.tokenRequestorList(cardID)
    // tokenRequestors をUIに表示します
    for tokenRequestor in tokenRequestors {
        print("ID: \(tokenRequestor.id ?? \"\")")
        print("Name: \(tokenRequestor.name ?? \"\")")

        if let asset = tokenRequestor.asset?.first,
           let imageData = Data(base64Encoded: asset.encodedData) {
            let image = UIImage(data: imageData)
            _ = image
        }
    }
} catch let d1Error as D1Error {
    // D1 SDK 統合 – エラー管理のセクションを参照してください
} catch let error {
    // その他のエラーを処理します
}

let cardID = "" // 取得元は、例えばバックエンドなど

d1Task.tokenRequestorList(cardID) { tokenRequestors, error in
    if let error = error {
        // D1 SDK の統合エラー管理のセクションを参照してください
    } else if let tokenRequestors = tokenRequestors {
        // tokenRequestors をUIに表示します
        for tokenRequestor in tokenRequestors {
            print("ID: \(tokenRequestor.id ?? \"\")")
            print("Name: \(tokenRequestor.name ?? \"\")")

            if let asset = tokenRequestor.asset?.first,
               let imageData = Data(base64Encoded: asset.encodedData) {
                let image = UIImage(data: imageData)
                _ = image
            }
        }
    }
}

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

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

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

fun pushCardToTokenRequestor(d1Task: D1Task, cardID: String, tokenRequestor: TokenRequestor) {
    val appURL = "d1demoapp://com.thalesgroup.gemalto.d1.validation/PushToSchemeResult" // イシュアアプリのカスタムURL。トークンリクエスタは、デジタル化フローの完了時にこれをコールバックします
    val tcsAccepted = true

    // Click to Payでは、MastercardのtokenRequester.id属性値は50123197928です。
    activity.lifecycleScope.launch(Dispatchers.Main) {
        try {
            val pushUrl = withContext(Dispatchers.IO) {
                d1Task.pushProvisioningService.addDigitalCardToScheme(
                    cardID,
                    tokenRequestor,
                    appURL,
                    tcsAccepted
                ).await()
            }
            // トークンリクエスタアプリケーションを起動
            activity.startActivity(Intent(Intent.ACTION_VIEW, Uri.parse(pushUrl)))
        } catch (exception: D1Exception) {
            // D1 SDK 統合 – エラー管理のセクションを参照してください
        }
    }
}

//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
    )
}

let provisionMethod = PushProvisioningService.ProvisioningMethod(pushHandler: "pushHandler", platformType: "iOS")
let tokenRequestor = PushProvisioningService.TokenRequestor(id: "test", name: "test", asset: nil, provisioningMethods: [provisionMethod])
let cardID = "" // 例: サーバーから取得
let appURL = "test://sample.com.demo/tokenRequestorsPage"
// ディープリンク機構を使用して設定されたイシュアのappURL。
// トークンリクエスタアプリは、このURLにコールバックしてカードプッシュ情報の結果を渡します。
do {
    let service = try d1Task.pushProvisioningService()
    let provisionString = try await service.addDigitalCardToScheme(cardID,
                                                                   tokenRequestor: tokenRequestor,
                                                                   appURL: appURL,
                                                                   termsAndConditionsAccepted: true)
    if let provisionURL = URL(string: provisionString) {
        if await UIApplication.shared.canOpenURL(provisionURL) {
            await UIApplication.shared.open(provisionURL)
        }
    }
} catch let d1Error as D1Error {
    // D1 SDK 統合 – エラー管理のセクションを参照してください
} catch let error {
    // その他のエラーを処理します
}

let cardID = "" // 取得元は、例えばバックエンドなど

// トークン化フロー後にトークンリクエスタが呼び出すイシュアアプリケーションのディープリンクURL。
let appURL = "test://sample.com.demo/tokenRequestorsPage"

// tokenRequestorはエンドユーザーによって選択され、tokenRequestorList()によって返されます。

d1Task.addDigitalCardToScheme(
    cardID,
    tokenRequestor: tokenRequestor,
    appURL: appURL,
    termsAndConditionsAccepted: true
) { provisionString, error in
    if let error = error {
        // D1 SDK の統合エラー管理のセクションを参照してください
    } else if let provisionString = provisionString,
              let pushUrl = URL(string: provisionString),
              UIApplication.shared.canOpenURL(pushUrl) {
        UIApplication.shared.open(pushUrl)
    }
}

次に起こること

D1 SDKはプッシュ URLを返します。
イシュアアプリケーションは、プッシュ URLをトークンリクエスタアプリケーションまたはWebビューで開きます。
トークンリクエスタがトークン化フローを実行します。
フローが完了すると、トークンリクエスタはエンドユーザーをイシュアアプリケーションに戻します。 appURL.

設定するには appURL、イシュアアプリケーションにディープリンクを実装します: Android, iOS.
トークンリクエスタは、トークン化結果をイシュアアプリケーションに返します。詳細は、Mastercardガイドを参照してください: トークンリクエスタからの応答を受け取る.

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

D1 SDK への完全なアクセスについては、ご確認ください API リファレンス.

前へスキームへのプッシュを実装する

次へ表示と制御を実装する

最終更新 3 か月前

役に立ちましたか？