デバイスバインディングを作成

Mastercard Token Authentication Framework (TAF) は、デバイスバインディングから始まります。

前提条件:

• カードはすでにトークン化を完了しています。加盟店はすでに srcDigitalTokenId を Thales バックエンドから取得しています。
• デバイスは、指紋認証や Face ID などのデバイス認証をサポートしています。

トークンをデバイスにバインドする前に、イシュア側バックエンドがエンドユーザーを認証します（ID&V）。イシュア側バックエンドはエンドユーザーに OTP を送信します。エンドユーザーは加盟店アプリケーションで OTP を入力します。

加盟店アプリケーションがバインディング作成フローを開始します

バインディングフローを開始します。

ステップ	説明
1-2	エンドユーザーは（加盟店アプリケーションを通じて）、Thales SDK を呼び出すことで ID&V フローを開始します。 tokenId と新しい correlationId （トラブルシューティング用）。
3-7	Thales SDK は Thales バックエンドを呼び出し、そこから Mastercard にアクセスして利用可能な ID&V メソッドを取得します。
8-9	加盟店アプリケーションは利用可能な ID&V メソッドを表示し、エンドユーザーに 1 つ選択するよう求めます。選択肢は SMS またはメールです。

ID&V メソッドの一覧は IDVSession オブジェクトから取得できます。

Android

次を使用して IDVSession オブジェクトを使って getIdvMethods 対応している ID&V メソッドの一覧を取得します。

public void createBinding(@NonNull MastercardTAFHelper mastercardTAFHelper, @NonNull String tokenID, @NonNull String correlationID) {

    mastercardTAFHelper.createBinding(tokenID,
            correlationID,
            new TokenBindingListener() {

                @Override
                public void onIssuerAuthenticationReady(@NonNull IDVSession idvSession) {

                }

                @Override
                public void onIssuerAuthenticationRequired(IDVSession idvSession) {
                    // idv メソッドの一覧を取得
                    List<IDVMethod> idvMethods = idvSession.getIdvMethods();
                }

                @Override
                public void onIssuerAuthenticationError(@NonNull IDVSession pendingBindingSession, TMGClientException tmgClientException) {
                    // エラーを確認するか再試行します
                }

                @Override
                public void onDeviceAuthentication(DeviceAuthentication deviceAuthentication) {
                    // 生体認証を使用してデバイス認証を実行
                }

                @Override
                public void onSuccess() {
                    // バインディング作成成功時の UI を処理
                }

                @Override
                public void onError(TMGClientException exception) {
                    // エラーがあるか確認
                }
            });
}

iOS

次を使用して IDVSession オブジェクトを使って idvMethods 対応している ID&V メソッドの一覧を取得します。

// Mastercard フローに必要なプロパティを保持するシングルトンクラス
class MastercardService {
    static var shared = MastercardService()
    var idvSession: MastercardTAFHelper.IDVSession? = nil
    var completionHandler: ((MastercardTAFHelper.IDVSession?, TMGError?) -> Void)? = nil
}

let tokenID: String = ""
let correlationID: String = ""
// バインディング作成を開始
mastercardTAFHelper.createBinding(forTokenID: tokenID, correlationID: correlationID, 
    idvSessionHandler: { idvSession in
        // idv セッションをローカルに保持
        MastercardService.shared.idvSession = idvSession
        // idv メソッドの一覧
        let methods = idvSession.idvMethods
        // idv メソッドをユーザーに表示
    },
    deviceAuthenticationHandler: { auth in
        // Face ID
        let customMessage = "" // カスタムメッセージを渡します。例: "Face ID で認証"
        auth.startAuthentication(withMessage: customMessage)
    }, 
    completionHandler: { session, error in
        // completion ハンドラーをローカルに保持
        MastercardService.shared.completionHandler?(session, error)
        // バインディング成功
        if error == nil {
            
        }
        // 失敗時はエラーを処理するか idv セッションを再試行
    }
)

エンドユーザーの選択と OTP 送信

エンドユーザーは ID&V メソッドを選択し、OTP を受け取ります。

ステップ	説明
1-2	エンドユーザーが ID&V メソッドを選択し、加盟店アプリケーションはその選択を Thales SDK に渡します。
3-7	Thales SDK は Thales バックエンドを呼び出して Mastercard にアクセスし、OTP を生成します。その後、イシュア側バックエンドが選択されたチャネルを通じてエンドユーザーに OTP を送信します。

Android

public void selectIDVMethod(@NonNull MastercardTAFHelper mastercardTAFHelper, @NonNull String tokenID, @NonNull String correlationID, @NonNull FragmentActivity activity) {
    mastercardTAFHelper.createBinding(tokenID,
            correlationID,
            new TokenBindingListener() {

                @Override
                public void onIssuerAuthenticationReady(@NonNull IDVSession idvSession) {
                    // OTP を検証
                }

                @Override
                public void onIssuerAuthenticationRequired(IDVSession idvSession) {
                    // idv メソッドの一覧を取得
                    List<IDVMethod> idvMethods = idvSession.getIdvMethods();

                    // 選択した idv メソッドを送信
                    IDVMethod selectedIdvMethod = idvMethods.get(0);
                    idvSession.selectIDVMethod(selectedIdvMethod);
                }

                @Override
                public void onIssuerAuthenticationError(@NonNull IDVSession pendingBindingSession, TMGClientException tmgClientException) {
                    // エラーを確認するか再試行します
                }

                @Override
                public void onDeviceAuthentication(DeviceAuthentication deviceAuthentication) {
                    // 生体認証を使用してデバイス認証を実行
                }

                @Override
                public void onSuccess() {
                    // バインディング作成成功時の UI を処理
                }

                @Override
                public void onError(TMGClientException exception) {
                    // エラーがあるか確認
                }
            });
}

iOS

guard let idvSession = MastercardService.shared.idvSession else {
    // idv セッションがありません
    return
}
// 1. idv メソッドの一覧を表示
do {
    let idvMethods = try idvSession.idvMethods
    let selectedIdvMethod = idvMethods[0] // ユーザーは利用可能な idvMethods から 1 つ選択します
    
    // 2. idv メソッドを送信
    idvSession.selectIDVMethod(selectedIdvMethod) {
        // 3. OTP 値を入力するページを表示
    }
} catch let error {
    // エラーを処理
}
        
// 4. ステップ 2 の失敗（selectIDVMethod）は completionHandler で処理されます。
MastercardService.shared.completionHandler = { (session, error) in
    // 5. selectIDVMethod のエラーか確認
    if let session = session,
        let error = error,
        error.description == TMGError.invalidIdvMethod.description {
        MastercardService.shared.idvSession = session
        // 6. IDV フローを再試行
    }
}

SDK はバインディングの有効化結果を次を通じて返します onSuccess または onIssuerAuthenticationError。有効化に失敗した場合は、 IDVSession で返されたインスタンスを保持してください onIssuerAuthenticationErrorそれを使用して ID&V フローを再試行します。

OTP 検証

ステップ	説明
1-2	エンドユーザーは加盟店アプリケーションで OTP を入力し、アプリケーションはそれを Thales SDK に送信します。
3-7	SDK は OTP を安全に Mastercard に渡して検証を行い、その結果を加盟店アプリケーションに返します。

Android

public void validateOTP(@NonNull MastercardTAFHelper mastercardTAFHelper, @NonNull String tokenID, @NonNull String correlationID, @NonNull FragmentActivity activity) {
    mastercardTAFHelper.createBinding(tokenID,
            correlationID,
            new TokenBindingListener() {

                @Override
                public void onIssuerAuthenticationReady(@NonNull IDVSession idvSession) {
                    // バインディングを有効化
                    String otp = "12345";
                    idvSession.validateOTP(otp);

                }

                @Override
                public void onIssuerAuthenticationRequired(IDVSession idvSession) {
                    // idv メソッドの一覧を取得
                }

                @Override
                public void onIssuerAuthenticationError(@NonNull IDVSession pendingBindingSession, TMGClientException tmgClientException) {
                    // エラーを確認するか再試行します
                }

                @Override
                public void onDeviceAuthentication(DeviceAuthentication deviceAuthentication) {
                    // 生体認証を使用してデバイス認証を実行
                    CharSequence title = "title"; //生体認証ポップアップに表示する title
                    CharSequence subTitle = "subTitle"; //生体認証ポップアップに表示する subTitle
                    CharSequence description = "description"; // 生体認証ポップアップに表示する description
                    CharSequence negativeButtonText = "negativeButtonText"; // 生体認証ポップアップに表示する拒否ボタンのテキスト
                    deviceAuthentication.startAuthentication(activity,
                            title,
                            subTitle,
                            description,
                            negativeButtonText);
                }

                @Override
                public void onSuccess() {
                    // バインディング作成成功時の UI を処理
                }

                @Override
                public void onError(TMGClientException exception) {
                    // エラーがあるか確認
                }
            });
}

iOS

guard let idvSession = MastercardService.shared.idvSession else {
    // idv セッションがありません
    return
}
do {
    let otp = "123456" // ユーザーが入力した OTP 値
    // 1. OTP 値を送信
    idvSession.validateOTP(otp)
} catch let error {
    // エラーを処理
}
        
// 2. ステップ 1 の validateOTP の失敗は completionHandler で処理されます。
MastercardService.shared.completionHandler = { (session, error) in
    // 3. validateOTP のエラーか確認
    if let session = session,
        let error = error,
        error.description == TMGError.invalidOTPMessage.description {
        MastercardService.shared.idvSession = session
        // 4. IDV フローを再試行
    }
}