OTPでバインディングを有効化

ワンタイムパスワード（OTP）は、 ID&V 保留中のデバイスバインディングを有効化するための方法として使用されます。

このページは、次のフローの続きです：デバイスバインディングの作成（黄色いフロー）.

前提条件：

すでに開始しています createBinding または resumeBinding.
イシュアはOTPベースのID&V方法（例： OTP_SMS).
あなたの加盟店アプリはエンドユーザーからOTPを収集できます。

フロー

ステップ

説明

エンドユーザーはOTPオプション（SMS、メールまたはオンラインバンキング）を選択します。

加盟店アプリは選択をThalesバックエンドに転送します。

3–5

Thalesバックエンドは VTS および イシュア に選択されたチャネルでOTPを配信するよう要求します。

エンドユーザーは加盟店アプリにOTPを入力します。加盟店アプリがUIを所有します。

7–8

ThalesバックエンドはVTSおよびイシュアとOTPを検証します。

Thales SDKは結果を受け取り、ローカルでバインディングを有効化します。

Thalesバックエンドは加盟店/PSPバックエンドにバインディングが有効であることを通知します。

SDK統合

1. OTPのID&V方法を選択する

の間に createBinding または resumeBinding、次のOTP ID&V方法のいずれかを選択します：

OTP_SMS
OTP_EMAIL
OTP_ONLINE_BANKING

アプリケーションが選択した ID&V メソッドを正常に送信すると、 onIssuerAuthenticationReady コールバックがアプリケーションに返されます。さもなければ、 onError コールバックが返されます。

@Override
public void onIssuerAuthenticationRequired(PendingBindingSession pendingBindingSession) { 
    // OTP_SMS ID&Vメソッドを送信する
    for (IDVMethod idvMethod : pendingBindingSession.getIdvMethods()) {
        if (idvMethod.getType().equals(IDVType.OTP_SMS)) {
            pendingBindingSession.submitIdvMethod(idvMethod);
        }
    }
}

@Override
public void onIssuerAuthenticationReady(PendingBindingSession pendingBindingSession, 
                                        @Nullable OtpActivationStatus status) {
    
}

@Override
public void onError(TMGClientException exception) { 
    // エラーがあるか確認する
    int errorCode = exception.getErrorCode();
    int errorMessage = exception.getMessage();
}

guard let idvSession = VisaService.shared.idvSession else {
    // idvセッションがない
    return
}
// 1. idvメソッドの一覧を表示する
do {
    let idvMethods = try idvSession.idvMethods
    let selectedIdvMethod = idvMethods[0] // ユーザーがOTP idvメソッド（OTP_SMS）を選択
    
    // 2. idvメソッドを送信する
    idvSession.selectIDVMethod(selectedIdvMethod) { (result) in
        if let otpActivationStatus = result {
            let maxOtpVerificationAllowed = otpActivationStatus.maxOTPVerificationAllowed
            let maxOtpRequestsAllowed = otpActivationStatus.maxOTPRequestsAllowed
            let otpExpiration = otpActivationStatus.otpExpiration
            
            // 3. OTPを入力するページを表示する
        }
    }
} catch let error {
    // エラーを処理する
}

// 4. ステップ2（selectIDVMethod）の失敗はcompletionHandlerで処理されます。
VisaService.shared.completionHandler = { (session, error) in
    // 5. selectIDVMethodのエラーか確認する。
    if let session = session,
        let error = error,
        error.description == TMGError.invalidIdvMethod.description {
        VisaService.shared.idvSession = session
        // 6. IDVフローを再試行する。
    }
}

2. バインディングを有効化する

加盟店アプリでOTPを収集し、次に activateBinding を呼び出します IDVSession.

@Override
public void onIssuerAuthenticationReady(IDVSession idvSession, 
                                        @Nullable OtpActivationStatus status) { 
    // バインディングを有効化する
    String otp;
    idvSession.activateBinding(otp);
}

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

結果は次で返されます onSuccess または onIssuerAuthenticationError.

有効化に失敗した場合、 IDVSession で返される onIssuerAuthenticationError を使って再試行してください。

// 1. ユーザー入力からのOTP値
let otp = ""

guard let idvSession = VisaService.shared.idvSession else {
    // idvセッションがない
    return
}
// 2. activateを呼ぶ
idvSession.activateBinding(withValue: otp)

VisaService.shared.completionHandler = { (session, error) in
    // 2. バインディング成功
    if error == nil {
        
    } else if let error = error,
                let session = session,
                error.description == TMGError.serverErrorWrongOTP.description {
        VisaService.shared.idvSession = session
        // 3. OTP入力を再試行し、エラーメッセージを表示する
    }
}

結果は次で返されます completionHandler.

有効化に失敗した場合、 completionHandler は IDVSession を返し、再試行のためのエラーを返します。

前へアプリ間でバインディングを有効化次へカスタマーサービスでバインディングを有効化

最終更新 5 か月前

役に立ちましたか？