D1 SDK によるオプトアウト

概要

このページでは、イシュアアプリケーションが D1 SDK を使用して Click to Pay からオプトアウトする方法を説明します。

D1 SDK には、2 つのオプトアウト API があります:

optOutCard Click to Pay から 1 枚のカードを削除します。
optOutConsumer エンドユーザーの Click to Pay からすべてのカードを削除します。

D1 が Click to Pay ディレクトリおよび決済ネットワークとのバックエンド連携をオーケストレーションしている間に、エンドユーザーがイシュアアプリケーションから直接オプトアウトを開始したい場合は、これらの SDK フローを使用します。

クイックリンク

適切な SDK API を選択する

`optOutCard`

使用する optOutCard エンドユーザーが Click to Pay から特定のカードを 1 枚だけ削除したい場合。

このオプションでは、ほかに登録済みのカードは変更されません。

`optOutConsumer`

使用する optOutConsumer エンドユーザーが Click to Pay プロファイル全体を削除したい場合。

このオプションでは、そのエンドユーザーの Click to Pay に登録されているすべてのカードが削除されます。

フロー

下の図は、SDK ベースのオプトアウトフロー全体を示しています:

シーケンス図

SDK フローはバックエンドのオプトアウトフローと機能的には同じですが、イシュアアプリケーションから直接開始されます。

次のシーケンス図は、イシュアアプリケーションから開始されるフローを示しています:

重要なポイント

どちらの操作も非同期です。
即時結果には、次のステータスが含まれます SUCCESSFUL または PENDING、および operationID.
使用する D1 SDK によるプロファイル取得オプトアウト前に、イシュアアプリケーションが現在の Click to Pay 状態を表示する必要がある場合。
optOutCard 決済ネットワーク側から 1 枚のデジタルカードを削除します。
optOutConsumer 登録済みカード全体にわたって、エンドユーザーの Click to Pay プロファイル全体を削除します。
最終結果は、 D1 API の概要の Get Operation エンドポイント、または D1 Notifications を通じても追跡できます。

これらの図は、イシュアアプリケーションから開始されるオプトアウトフローを示しています。

optOutConsumer 同じ SDK パターンに従いますが、 optOutCard、ただしエンドユーザーに紐づくすべてのカードに適用されます。

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

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

の SDK API `optOutCard`

D1 SDK 4.2.0 以降、 optOutCard (Android / iOS) は D1 SDK を通じて利用できます。

この API は、エンドユーザーが特定の 1 枚のカードだけをオプトアウトしたい場合に使用します。

fun optOutClick2Pay(d1Task: D1Task, cardID: String) {

    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().optOutCard(
        cardID,
        callback
    )
}

let cardID = ""
do {
    let status = try await d1Task.clickToPayService().optOutCard(cardID)
    switch status {
    case .pending(let operationID):
        // Click to Pay へのオプトアウトは保留中です。
        print(operationID)
    case .successful(let operationID):
        // Click to Pay へのオプトアウトに成功しました。
        print(operationID)
    }
} catch {
    // エラーを処理します。
}

使用する optOutCard イシュアアプリケーションがカード一覧を表示し、エンドユーザーが削除するカードを 1 枚選択する場合。

の SDK API `optOutConsumer`

D1 SDK 4.3.0 以降、 optOutConsumer (Android / iOS) は D1 SDK を通じて利用できます。

この API は、エンドユーザーが一度の操作で Click to Pay からすべてのカードをオプトアウトしたい場合に使用します。

fun optOutConsumerClick2Pay(d1Task: D1Task) {
    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().optOutConsumer(
        callback
    )
}

do {
    let status = try await d1Task.clickToPayService().optOutConsumer()
    switch status {
    case .pending(operationID: let operationID):
        // 保留中のシナリオを処理
        print(operationID)
    case .successful(operationID: let operationID):
        // 成功シナリオを処理
        print(operationID)
    }
} catch let error {
    // エラーを処理します。
}

使用する optOutConsumer 慎重に。

この操作により、エンドユーザーの Click to Pay カードがすべて削除されます。

前へD1 API でオプトアウトする次へClick to Pay を実装する（加盟店）

最終更新 14 日前

役に立ちましたか？

こんばんは

概要

適切な SDK API を選択する

optOutCard

optOutConsumer

フロー