決済APIを使って決済してみる

本機能の対象機種はstera terminal standard（ステラターミナルスタンダード）および、stera terinal mobile（ステラターミナルモバイル）です。

stera terminal unit（ステラターミナルユニット）ではご利用いただけません。

stera terminal mobile（ステラターミナルモバイル）は2024年末にリリース予定となります。

Intentを使用することで、決済アプリケーションとの連携をすることができます。

決済アプリケーションでは、下記の機能を提供しています。

■決済アプリケーション機能

・取引の実行

・過去の決済の再印字の実行

・一括日計の実行

決済アプリケーションとの連携は Android™ のIntentを用いて行います。

決済APIを使用すると、下記の決済機能を使用することができます。

■決済アプリケーション機能詳細

・取引（決済）

売上、取消、返品ができます。

金種はクレジットカード決済、電子マネー決済、QRコード決済から選択できます。

練習モードでの呼び出しもできます。

・再印字

過去の取引情報を再印字することができます。

決済アプリケーション上から該当の取引を選択し、レシートに印字します。

・一括日計

一括日計処理を実施できます。

決済の一連の流れは下記のように進みます。

1. 作成するアプリケーション上から、決済アプリケーションのIntentを作成します。

Intent作成後、putExtraメソッドでIntentへ渡すパラメータを設定します。

サンプルコードでは下記パラメータを設定しています。

　・TransactionMode（取引モード）：2（練習モード）

　・TransactionType（取引種別）：1（売上）

　・Amount（金額）：100（円）

　・Tax（税）：10（円）

startActivityForResultメソッドを実行すると、決済アプリケーションへ遷移します。

コードは横スクロールさせて確認することができます。

// 決済アプリアプリケーション用Intentの作成
Intent intentResult = new Intent();
intentResult.setClassName("com.panasonic.smartpayment.android.salesmenu",
        "com.panasonic.smartpayment.android.salesmenu.MainActivity");

// リクエスト用パラメータの設定（例では取引を指定）
intentResult.putExtra("TransactionMode", "2");
intentResult.putExtra("TransactionType", "1");
intentResult.putExtra("Amount", "100");
intentResult.putExtra("Tax", "10");

// 決済アプリケーションへ遷移
startActivityForResult(intentResult, 2);

2.決済アプリケーション上で決済を実行します

決済アプリケーションの画面は下記のようになります。

1で設定した取引モード、取引種別、金額が連携されており、決済アプリケーションに従って決済を進めます。

決済アプリケーション上での決済が完了／キャンセルすると、作成中のアプリケーションへ制御が戻ります。

3. 決済アプリケーションからの戻り値を取得する

決済アプリケーションの実行が終了すると、onActivityResultメソッドが実行されます。

このonActivityResultメソッド内に戻り値に応じたハンドリングを実装してください。

下のサンプルコードでは、getStringExtraメソッドで取得した“PaymentType”の値と、resultCodeの値により次に遷移するページを切替えています。

コードは横スクロールさせて確認することができます。

    protected void onActivityResult(int requestCode, int resultCode, Intent intent) {
        super.onActivityResult(requestCode, resultCode, intent);

        Log.d(TAG, "[in] onActivityResult()");
        Log.d(TAG, "requestCode=" + requestCode);
        Log.d(TAG, "resultCode=" + resultCode);
        Log.d(TAG, "PaymentType=" + intent.getStringExtra("PaymentType"));

        final Intent intentResult = new Intent(CancelReturnActivity.this, ResultActivity.class);
        intentResult.putExtra("TransactionType", mTransactionType);
        if (resultCode == MainActivity.SUCCESS) {
            intentResult.putExtra("Result", getString(R.string.judgetransactionOK));
            intentResult.putExtra("ResultCode", resultCode);
        } else if (resultCode == MainActivity.FAIL) {
            Log.d(TAG, "ErrorCodeCancelReturn=" + intent.getStringExtra("ErrorCode"));
            intentResult.putExtra("Result", getString(R.string.judgetransactionNG));
            intentResult.putExtra("ResultCode", resultCode);
        } else if (resultCode == MainActivity.CANCEL) {
            intentResult.putExtra("Result", getString(R.string.judgetransactionCancel));
            intentResult.putExtra("ResultCode", resultCode);
        } else {
            Log.d(TAG, "CancelReturnActivity got incorrect resultCode. resultCode=" + resultCode);
        }
        startActivity(intentResult);
        Log.d(TAG, "[out] onActivityResult()");
        // Finish this Activity
        finishAndRemoveTask();
    }

 Android は Google LLC の商標です。