トランザクションを認証する

Mastercard Token Authentication Framework（TAF）を使用してトランザクションを認証します。

この呼び出しは Mastercard のペイロードを生成します。TAF の対象となるトランザクションクリプトグラムを取得するために使用します。

認証フロー

チェックアウト時の Mastercard TAF 認証フロー。

SDK統合

Android

呼び出し MastercardTAFHelper.authenticateTransaction.

でデバイス認証を開始 onDeviceAuthentication.

生体認証UIの文字列をカスタマイズできます。

最終結果を次で処理 onSuccess または onError.

public void mastercard_AuthenticateTransaction(@NonNull final String tokenID, @NonNull TransactionContext transactionContext, @NonNull MastercardTAFHelper masterCardTAFHelper, @NonNull FragmentActivity fragmentActivity) {
    masterCardTAFHelper.authenticateTransaction(tokenID, transactionContext, new TransactionListener() {
        @Override
        public void onDeviceAuthentication(DeviceAuthentication deviceAuthentication) {
            CharSequence title = "タイトル";
            CharSequence subTitle = "サブタイトル";
            CharSequence description = "説明";
            CharSequence negativeButtonText = "否定ボタン";
            deviceAuthentication.startAuthentication(fragmentActivity,
                    title,
                    subTitle,
                    description,
                    negativeButtonText);
        }

        @Override
        public void onError(TMGClientException exception) {
            // エラーを確認
            int errorCode = exception.getErrorCode();
            String errorMessage = exception.getMessage();
        }

        @Override
        public void onSuccess(String payload) {
            // Mastercard ペイロードをデコードし、トランザクションのアサーションを検証します
        }
    });
}

onSuccess は Mastercard のペイロードを返します。

onError は TMGClientException をエラーコードとメッセージ付きで返します。

iOS

呼び出し authenticateTransaction と TransactionContext.

でデバイス認証を開始 deviceAuthenticationHandler.

let tokenID = ""
let transContext = MastercardTAFHelper.TransactionContext(merchantName: "ABC", amount: "100", currencyCode: "USD")
// 1. トランザクション認証を開始
mastercardTAFHelper.authenticateTransaction(forTokenID: tokenID, context: transContext,
    deviceAuthenticationHandler: { auth in
        // 2. ユーザー認証を開始
        let customMessage = "" // カスタムメッセージを渡します。例: "Face IDで認証してください"
        auth.startAuthentication(withMessage: customMessage)
    },
    completionHandler: { (mastercardPayload, error) in
        // ペイロード生成に成功
        if error == nil {
        
        } else {
            // エラーを処理
        }
    }
)