D1 SDK によるカード登録

概要

このページでは、イシュアアプリケーションが D1 SDK を使用してカードおよびそのエンドユーザーを Click to Pay に登録する方法を説明します。

イシュアアプリケーションが次を呼び出します 登録、これはイシュアバックエンドが呼び出すのと同じバックエンドの Click to Pay 登録操作をトリガーします D1 API.

D1 が Click to Pay ディレクトリおよび決済ネットワークとのバックエンド相互作用をオーケストレーションしている間に、エンドユーザーがイシュアアプリケーションのユーザーインターフェース上で直接 Click to Pay 登録を開始するようにしたい場合は、この SDK フローを使用します。

フロー

次の図は、SDK の Click to Pay 登録フローの主な手順を示しています:

シーケンス図

D1 SDK 4.2.0 以降では、バックエンドフローの追加により、 登録 (Android / iOS）API も利用できます D1 SDK.

前提条件

SDK フローには、バックエンドフローと同じ前提条件と制限があります。詳細は、前提条件.

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

重要なポイント

イシュアアプリケーションは、消費者情報を提供する必要があります。参照してください: ConsumerInfo (SDK API).
登録は非同期操作です。最終結果は次のいずれかの方法で取得できます:
- コールバックのステータス（SUCCESSFUL または PENDING),
- を呼び出す、 Get Operation で利用できるエンドポイント D1 API、または
- D1 通知を有効にする。SDK フローでは、イシュアはさらにアプリ内プッシュ通知をイシュアバックエンド通知に加えて有効にすることもできます。
決済ネットワークに関連付けられた TSP が、一般的なデジタル化フローをトリガーします。

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

イシュアアプリケーションが D1 バックエンドから Click to Pay 登録通知を受信できるようにする前に、プッシュ通知が次のように設定されていることを確認してください:

プッシュ通知を設定する

で示されている必要な操作を実行しますプッシュ通知の設定.

プッシュ通知トークンを登録する

登録するプッシュ通知トークン.

メッセージ通知に登録する

登録するメッセージ通知.

これらの手順が完了すると、イシュアアプリケーションは次のようなプッシュ通知の受信を開始できます: clickToPayEnrolment と clickToPayOptOutCard.

D1 SDK が次の種類のプッシュ通知を受信すると clickToPayEnrolment (Android / iOS）または clickToPayOptOutCard (Android / iOS）、イシュアアプリケーションは通知を確認して、Click to Pay 登録操作またはオプトアウトが成功したかどうかを判断します。

SDK API

fun enrolClick2Pay(d1Task: D1Task, cardID: String) {
    // ユーザー入力またはバックエンドから受信した消費者情報。
    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().enrol(
        cardID,
        consumerInfo,
        "Bella Lin",
        billingAddress,
        callback
    )
}

public void enrolClick2Pay(@NonNull D1Task d1Task, @NonNull String cardID) {
    // ユーザー入力またはバックエンドから受信した消費者情報。
    ConsumerInfo consumerInfo = new ConsumerInfo(
        "Bella", 
        "ミドルネーム", 
        "Lin", 
        "en-US", 
        "+65", 
        "99998888", 
        "email@thalesgroup.com"
    );
    BillingAddress billingAddress = new BillingAddress("CZ");

    D1Task.Callback<Status> callback = new D1Task.Callback<Status>() {
        @Override
        public void onSuccess(Status data) {
            // Click to Pay への登録に成功
            Status status = data;
            String operationID = data.operationID;
        }

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

let cardID = ""
let name = "Bella Lin"
let consumerInfo = ConsumerInfo(firstName: "Bella",
                                middleName: nil,
                                lastName: "Lin",
                                language: "en-US",
                                phoneNumberCountryCode: "+65",
                                phoneNumber: "99998888",
                                email: "email@thalesgroup.com")

let billingAddress = BillingAddress(line1: "1230 Rue de Rivoli",
                                    line2: nil,
                                    line3: nil,
                                    city: "Paris",
                                    state: "75",
                                    zipCode: "75000",
                                    countryCode: "FR")
do {
    let status = try await d1Task.clickToPayService().enrol(cardID,
                                                            consumerInfo: consumerInfo,
                                                            name: name,
                                                            billingAddress: billingAddress)
    switch status {
    case .pending(let operationID):
        // Click to Pay への登録は保留中です。
        print(operationID)
    case .successful(let operationID):
        // Click to Pay への登録に成功しました。
        print(operationID)
    }
} catch {
    // エラーを処理します。
}

前へD1 API によるカード登録次へ自動登録によるカード登録

最終更新 11 日前

役に立ちましたか？