デジタルウォレットにプッシュする

デジタルウォレットへのプッシュ

このガイドを使用して、D1 SDK を使ってカードをイシュアアプリケーションからデジタルウォレットアプリケーションへプッシュします。サポートされるウォレットアプリケーションは Google Pay、Samsung Pay、Apple Pay です。

エンドユーザーがタップしたときにこの API を呼び出します ウォレットに追加 そしてカードのデジタル化状態が NOT_DIGITIZEDの場合。状態を取得するには、以下を参照してくださいカードのデジタル化状態を取得.

概要

イシュアアプリケーションは D1 SDK を呼び出します addDigitalCardToOEM() API を使用してプッシュプロビジョニングフローを開始します。D1 SDK と D1 バックエンドは次の処理を行います。

D1 に保存されているエンドユーザーとカードデータを検証します。
ウォレットアプリケーションと TSP に必要なペイロードを準備します。
ウォレットアプリケーションを呼び出してトークン化を開始します。
結果を返して、イシュアアプリケーションが UI を更新できるようにします。

次を呼び出すのは addDigitalCardToOEM() D1 SDK が返した後にのみ NOT_DIGITIZED から getCardDigitizationState().
Android で Google Pay を使用する場合は、 onActivityResult を実装して、ウォレットの結果が D1 SDK に戻されるようにする必要があります。
2024 年 6 月 10 日以降、 Google Wallet には Android 9 以上が必要です。

フロー

シーケンス図

前提条件

エンドユーザーアカウントとカードが D1 に登録されていること。
D1 SDK が初期化されていること。
イシュアアプリケーションが D1 SDK のログイン API を呼び出していること。

High-level sequence for pushing a card to a digital wallet

プラットフォーム統合

Android 2.4.0 以降では、次を使用します D1PushWallet.addDigitalCardToOEM().

//activity: OEM プッシュプロビジョニング用の現在のアクティビティ。
//cardID: 受信したカード ID。
fun pushCardToWallet_v2_4_0(d1Task: D1Task, cardID: String, activity: Activity) {
    val wallet = OEMPayType.GOOGLE_PAY //GOOGLE_PAY, SAMSUNG_PAY, NONE
    val callback: D1Task.Callback<Any?> = object : D1Task.Callback<Any?> {

        override fun onSuccess(data: Any?) {
            // サーバーからの `digitalCardStatus` オブジェクトを処理します。
        }

        override fun onError(exception: D1Exception) {
            // D1 SDK 統合 - エラー管理セクションを参照してください。
        }
    }
    val d1PushWallet : D1PushWallet = d1Task.d1PushWallet
    d1PushWallet.addDigitalCardToOEM(cardID, wallet, activity, callback)
}

// 注意: すべてのコールバックイベントを SDK に転送するために `onActivityResult` メソッドを実装してください。

// Activity Result: `onActivityResult` メソッドは GPay SDK からイシュアアプリで受信され、結果の処理のために D1 SDK に返されます。
override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
    d1Task.handleCardResult(requestCode, resultCode, data);
}

iOS では、次を使用します addDigitalCardToOEM(_:viewController:completion:).

let cardID = "" // たとえばバックエンドから、イシュアアプリケーションによって取得される
let viewController = /* Apple Pay UI を表示している現在の UIViewController インスタンス */

d1Task.addDigitalCardToOEM(cardID, viewController: viewController) { error in
    if let error = error {
        // D1 SDK 統合のエラー管理セクションを参照してください
    } else {
        // UI を更新します。たとえば、カードが Apple Wallet に追加されたことを確認します
    }
}

D1 SDK の詳細については、次を参照してください API リファレンス.

前へカードのデジタル化状態を取得する次へApple Wallet拡張機能

最終更新 2 か月前

役に立ちましたか？

//activity: OEM プッシュプロビジョニング用の現在のアクティビティ。
//cardID: 受信したカード ID。
fun pushCardToWallet_v2_4_0(d1Task: D1Task, cardID: String, activity: Activity) {
    val wallet = OEMPayType.GOOGLE_PAY //GOOGLE_PAY, SAMSUNG_PAY, NONE
    val callback: D1Task.Callback<Any?> = object : D1Task.Callback<Any?> {

        override fun onSuccess(data: Any?) {
            // サーバーからの `digitalCardStatus` オブジェクトを処理します。
        }

        override fun onError(exception: D1Exception) {
            // D1 SDK 統合 - エラー管理セクションを参照してください。
        }
    }
    val d1PushWallet : D1PushWallet = d1Task.d1PushWallet
    d1PushWallet.addDigitalCardToOEM(cardID, wallet, activity, callback)
}

// 注意: すべてのコールバックイベントを SDK に転送するために `onActivityResult` メソッドを実装してください。

// Activity Result: `onActivityResult` メソッドは GPay SDK からイシュアアプリで受信され、結果の処理のために D1 SDK に返されます。
override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
    d1Task.handleCardResult(requestCode, resultCode, data);
}