4. 手動モードをサポートする

概要

手動モードをサポートする予定がある場合は、この手順を完了してください 手動モード の決済体験。

手動モードをサポートしない場合は、次へスキップしてください CDCVM認証を実行.

シーケンスフロー

この決済体験では：

1. エンドユーザーがデバイスのロックを解除します。
2. エンドユーザーがデジタルウォレットアプリケーションを開きます。
3. エンドユーザーが支払いに使用するカードを選択します。
4. アプリケーションがエンドユーザーに認証を求めます。
5. エンドユーザーが〜内でタップします keyValidityPeriod.
6. 取引は、選択した支払いカードで実行されます。
7. 決済が完了した後、または keyValidityPeriod が期限切れになると、NFC Wallet SDK は次回の決済でデフォルトの支払いカードに戻します。

SDK 連携

呼び出します PaymentBusinessService.startAuthentication(...) 手動モードの取引を開始するために。

この呼び出しにより NFC Wallet の決済サービスが有効になります。NFC Wallet SDK は標準の非接触決済コールバックフローを使用して取引を処理します。

次のコールバックが ContactlessPaymentServiceListener からこの順番で呼び出されます：

1. onTransactionStarted
2. onAuthenticationRequired
3. onReadyToTap
4. onTransactionCompleted

// 01 - 必要に応じて、デフォルトカードを一時的に選択したカードに変更します。
DigitalizedCard originalDefault = null;

// エンドユーザーが選択したカードを取得します。
DigitalizedCard selectedCard = getSelectedCard();

// 選択したカードがデフォルトカードでない場合は、元のデフォルトカードを記録し、
// その後、決済を続行する前に、選択したカードをデフォルトとして設定します。
if (!isDefault(selectedCard)) {
    originalDefault = getDefaultCard();  // 元のデフォルトカードを保存します。
    setDefaultCard(selectedCard);        // 選択したカードを新しいデフォルトとして設定します。
}

// 02 - 非接触決済フローのイベントを処理するリスナーを定義します。
private PaymentServiceListener paymentServiceListener = new ContactlessPaymentServiceListener() {
    @Override
    public void onAuthenticationRequired(PaymentService paymentService,
                                          CHVerificationMethod cvm, long cvmResetTimer) {
        // 04 - CDCVM メソッドに従って認証を開始します。
        startInputCvmActivity(cvm);
    }

    @Override
    public void onTransactionCompleted(TransactionContext ctx) {
        // 05a - 取引が成功した後、必要に応じて元のデフォルトカードに戻します。
        setDefaultCard(originalDefault);
    }

    @Override
    public void onError(TransactionContext transactionContext,
                        PaymentServiceErrorCode errorCode, String msg) {
        // 05b - 取引が失敗した後、必要に応じて元のデフォルトカードに戻します。
        setDefaultCard(originalDefault);
    }

    @Override
    public void onTransactionStarted() {
    }

    @Override
    public void onReadyToTap(PaymentService service) {
    }
};


// 03 - 支払い前に認証を開始します。
final PaymentBusinessService paymentBusinessService = PaymentBusinessManager.getPaymentBusinessService();
paymentBusinessService.startAuthentication(paymentServiceListener, PaymentType.CONTACTLESS);