D1 SDK によるプロファイル更新

概要

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

イシュアアプリケーションは次を呼び出せます updateConsumer エンドユーザープロファイルデータを更新するには、または updateCard 1枚のカードのカードレベルデータを更新します。

エンドユーザーにイシュアアプリケーション内で Click to Pay データを直接確認・更新してもらい、D1 が Click to Pay ディレクトリとのバックエンド更新をオーケストレーションする場合に、この SDK フローを使用します。

クイックリンク

適切な SDK API を選択する

`updateConsumer`

使用する updateConsumer Click to Pay に保存されたコンシューマーデータを変更する必要があるとき。

1つの値だけが変更された場合でも、すべてのコンシューマーフィールドを指定してください。

請求先住所も指定した場合、D1 はコンシューマープロファイルにリンクされたすべてのカードの請求先住所を更新します。

`updateCard`

使用する updateCard 1枚の登録済みカードだけを変更する必要があるとき。

この API は、選択したカードの請求先住所を更新し、Visa の場合のみカード所有者名も更新します。

カードの更新またはカードの差し替えにこれらの SDK API を使用しないでください。

代わりに D1 の更新または差し替えフローを使用してください。

フロー

SDK 更新フローは次の手順で進みます:

イシュアアプリケーションが D1 SDK を初期化し、エンドユーザーをログインさせます。
イシュアアプリケーションが現在の Click to Pay プロファイルを取得します。
エンドユーザーがイシュアアプリケーション内で必要なデータを更新します。
イシュアアプリケーションが次を呼び出します updateConsumer または updateCard.
D1 は認証済みのエンドユーザーコンテキストを使用して、リクエストを D1 バックエンドに送信します。
D1 バックエンドが関連する Click to Pay ディレクトリを更新します。
D1 が操作ステータスをイシュアアプリケーションに返します。

シーケンス図

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

詳細なシーケンス図については、次を参照してください Click to Pay プロファイルを更新.

重要なポイント

どちらの操作も非同期です。
即時結果には、次のステータスが含まれます SUCCESSFUL または PENDING、および operationID.
使用する D1 SDK によるプロファイル取得現在の Click to Pay データを使用してイシュアアプリケーションのユーザーインターフェースを事前入力するためのものです。
使用する updateConsumer Click to Pay データを特に更新したい場合にのみ。
イシュアのバックエンドがエンドユーザープロファイルを D1 に保存している場合は、コンシューマー情報を更新 Click to Pay を含むすべてのチャネルを同期したままにしたい場合。
Mastercard では、請求先住所を指定する場合、住所オブジェクト全体を指定してください。

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

次を参照してください。 Click to Pay のプッシュ通知を処理する実装の詳細については、D1 SDK 統合 – D1 SDK による登録のドキュメントを参照してください。

の SDK API `updateConsumer`

使用する updateConsumer イシュアアプリケーションが Click to Pay でエンドユーザープロファイルデータを更新するとき。

この API は、関連するすべての Click to Pay ディレクトリでエンドユーザープロファイルを更新します。請求先住所を指定した場合、D1 は登録済みの各カードの請求先住所も更新します。

fun updateConsumerClick2Pay(d1Task: D1Task) {
    // ユーザー入力から受け取ったコンシューマー情報。
    val consumerInfo = ConsumerInfo(
        "Bella",
        "ミドルネーム",
        "Lin",
        "en-US",
        "+65",
        "99998888",
        "email@thalesgroup.com"
    )
    val billingAddress = BillingAddress("CZ")

    val callback: D1Task.Callback<Status?> =
        object : D1Task.Callback<Status?> {
            override fun onSuccess(data: Status?) {
                // コンシューマーの Click to Pay 更新に成功
                val status: Status? = data
                val operationID = data?.operationID
            }

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

func updateConsumerClick2Pay(d1Task: D1Task) {
    do {
        // ユーザー入力から受け取ったコンシューマー情報。
        let consumerInfo = ConsumerInfo(firstName: "Bella",
                                        middleName: nil,
                                        lastName: "Lin",
                                        language: "en-US",
                                        phoneNumberCountryCode: "+65",
                                        phoneNumber: "99998888",
                                        email: "email@thalesgroup.com")
        let billingAddress = BillingAddress(countryCode: "CZ")
        let status = try await d1Task.clickToPayService().updateConsumer(consumerInfo: consumerInfo,
                                                                         billingAddress: billingAddress)
        switch status {
        case .pending(operationID: let operationID):
            // 保留中のシナリオを処理
            print(operationID)
        case .successful(operationID: let operationID):
            // 成功シナリオを処理
            print(operationID)
        }
    } catch let error {
        // エラーを処理します。
    }
}

コンシューマーデータ一式を常に送信してください。

変更されたフィールドだけを送信しないでください。

の SDK API `updateCard`

使用する updateCard イシュアアプリケーションが Click to Pay で 1 枚の登録済みカードを更新するとき。

この API はカードレベルのデータのみを更新します。請求先住所、またはカードが Visa に属する場合のカード所有者名に使用してください。

fun updateCardClickToPay(d1Task: D1Task, cardID: String, billingAddress: BillingAddress) {

    val callback: D1Task.Callback<Status?> =
        object : D1Task.Callback<Status?> {
            override fun onSuccess(data: Status?) {
                // カードの Click to Pay 更新に成功
                val status: Status? = data
                val operationID = data?.operationID
            }

            override fun onError(exception: D1Exception) {
                // D1 SDK 統合 – エラー管理のセクションを参照してください。
            }
        }
    d1Task.getClickToPayService().updateCard(
        cardID,
        "Bella Lin",
        billingAddress,
        callback
    )
}

do {
    let cardID = ""
    let name = "Bella Lin"
    let billingAddress = BillingAddress(countryCode: "CZ")
    let status = try await d1Task.clickToPayService().updateCard(cardID,
                                                                 name: name,
                                                                 billingAddress: billingAddress)
    switch status {
    case .pending(operationID: let operationID):
        // 保留中のシナリオを処理
        print(operationID)
    case .successful(operationID: let operationID):
        // 成功シナリオを処理
        print(operationID)
    }
} catch let error {
    // エラーを処理します。
}

使用する updateCard 1枚のカードに関連付けられたデータに対してのみ。

エンドユーザープロファイルが変更された場合は、 updateConsumer 代わりに次を使用してください。

前へClick to Pay プロファイルを更新次へClick to Pay からカードをオプトアウト

最終更新 3 か月前

役に立ちましたか？

こんにちは

概要

適切な SDK API を選択する

updateConsumer

updateCard

フロー