D1 SDK によるプロファイル取得

概要

このページでは、イシュアアプリケーションが D1 SDK を使用して Click to Pay プロファイルを取得する方法を説明します。

イシュアアプリケーションが次を呼び出します getProfiles (Android / iOS) API は、イシュアバックエンドが呼び出す場合と同じバックエンド取得動作をトリガーします Click to Pay の消費者プロフィール取得 API.

エンドユーザーにプロファイルの詳細を更新させたり、カードのオプトアウトを許可したりする前など、イシュアアプリケーションで現在の Click to Pay プロファイルデータを直接表示したい場合に、この SDK フローを使用します。

クイックリンク

フロー

SDK の retrieve-profiles フローは次の手順で進みます:

イシュアアプリケーションが D1 SDK を初期化し、エンドユーザーをログインさせます。
イシュアアプリケーションが Click to Pay の retrieve-profiles オペレーションを呼び出します。
D1 は認証済みのエンドユーザーコンテキストを使用して、リクエストを D1 バックエンドに送信します。
D1 バックエンドが設定済みの Click to Pay ディレクトリを照会します。
D1 が結果を集約し、支払いネットワークごとに最大 1 件のプロファイルをイシュアアプリケーションに返します。

シーケンス図

SDK フローはバックエンドの retrieve-profiles フローと同じ機能動作を持ちますが、イシュアアプリケーションから直接開始されます。

詳細なシーケンス図については、 Click to Pay プロファイルを取得.

重要なポイント

これは非同期オペレーションです。イシュアアプリケーションは、コールバックまたは返された結果で現在のプロファイルを直接受け取ります。
レスポンスには ProfileResult.Profile コレクションが含まれます。各エントリは、1 つの支払いネットワークディレクトリ内の 1 つの Click to Pay プロファイルを表します。
複数の Click to Pay ディレクトリが設定されている場合、D1 はプロファイルを 1 つのレスポンスにまとめます。
エンドユーザーが D1 には存在するものの Click to Pay に登録されていない場合、オペレーションは空のリストを返します。
イシュアアプリケーションが次の呼び出しの前に現在の Click to Pay ステータスを表示する必要がある場合は、このフローを使用します Click to Pay にカードを登録または Click to Pay からカードをオプトアウト.

空のプロファイルリストは有効な機能結果として扱ってください。

通常、これはエンドユーザーが D1 では認識されているものの、まだ Click to Pay プロファイルを持っていないことを意味します。

レスポンスの処理

イシュアアプリケーションは次のデータを想定しておく必要があります:

scheme: 返されたプロファイルの支払いネットワークディレクトリ。
consumerInfo: Click to Pay ディレクトリに保存されている現在のエンドユーザーデータ。
cards: その支払いネットワークの Click to Pay プロファイルに関連付けられたカードの一覧。
message: D1 が部分的なレスポンスしか提供できない場合に返される、トラブルシューティング用のオプションテキスト。

返されたデータを次の用途に使用します:

現在の Click to Pay 登録状態を表示する、
各支払いネットワークディレクトリで利用可能なカードを表示する、
プロファイル更新用のユーザーインターフェースを事前入力する、または
エンドユーザーが次に取るべき適切なアクションを選べるようにする。

オプションの message フィールドをエンドユーザーに解析したり表示したりしないでください。

トラブルシューティング専用に使用してください。

Click to Pay のプッシュ通知を処理する

登録やオプトアウトとは異なり、Click to Pay プロファイルの取得には専用のプッシュ通知フローは必要ありません。

このオペレーションは現在の結果をイシュアアプリケーションに直接返します。プロファイル取得自体については非同期完了イベントは想定されていません。

イシュアアプリケーションでは、登録やオプトアウトなど他のオペレーション向けに、Click to Pay のプッシュ通知を有効にしたままにしておくこともできます。実装の詳細については、 Click to Pay のプッシュ通知を処理する.

SDK API

その getProfiles (Android / iOS) API は D1 SDK を通じて利用できます。

fun getProfilesC2Pay(d1Task: D1Task) {
    val callback: D1Task.Callback<ProfileResult?> = object : D1Task.Callback<ProfileResult?> {
        override fun onSuccess(data: ProfileResult?) {
            // Click to Pay プロファイルの取得に成功
            val profiles: MutableList<Profile?>? = data?.getProfileList()
            val message: String? = data?.getErrorMessage()
            if (!message.isNullOrEmpty()) {
                // メッセージをログに記録し、完全なプロファイルを取得するために再試行することがあります
            }
            // すべてのプロファイルを表示
        }

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

    d1Task.getClickToPayService().getProfiles(
        callback
    )
}

do {
    let profileResult = try await d1Task.clickToPayService().profiles()
    if let message = profileResult.errorMessage {
        // メッセージをログに記録し、完全なプロファイルを取得するために再試行することがあります
    }
    // すべてのプロファイルを表示
} catch let error {
    // エラーを処理します。
}

返されたプロファイルデータを、イシュアアプリケーションのユーザーインターフェースのソースとして使用します。

すべての支払いネットワークがエンドユーザー向けのプロファイルを返すとは想定しないでください。

前へClick to Pay プロファイルを取得次へClick to Pay プロファイルを更新

最終更新 3 か月前

役に立ちましたか？