sunmi_mtb 1.0.1

A Flutter plugin for MineSec SoftPOS (MSA) payment integration on Android. Supports checking installation, warm-up, activation, and sale transactions.

sunmi_mtb

A Flutter plugin for MineSec SoftPOS (MSA) payment integration on Android.

Features

• ✅ Check if MineSec SoftPOS app is installed
• 🔥 Warm up the SoftPOS terminal
• 🔑 Activate terminal with activation code
• 💳 Perform sale transactions with typed results

Setup

1. Android Configuration

Your app's MainActivity must extend FlutterFragmentActivity (not FlutterActivity):

import io.flutter.embedding.android.FlutterFragmentActivity

class MainActivity : FlutterFragmentActivity()

Set minSdk to at least 26 in android/app/build.gradle.kts:

defaultConfig {
    minSdk = 26
}

2. Add Dependency

dependencies:
  sunmi_mtb:
    path: packages/sunmi_mtb  # or from git/pub

Usage

import 'package:sunmi_mtb/sunmi_mtb.dart';

// Initialize the plugin
final msa = SunmiMtb();

// Check installation
bool installed = await msa.isInstalled();

// Warm up
String? warmUpResult = await msa.warmUp();

// Activate
String? activationResult = await msa.activate('YOUR_ACTIVATION_CODE');

// Sale transaction
MsaTransactionResult? result = await msa.saleTransaction(
  amount: '15.50',
  posMessageId: 'TRX-123456',  // optional, auto-generated if omitted
);

if (result != null && result.isApproved) {
  print('Payment approved! ID: ${result.tranId}');
}

API Reference

SunmiMtb

Method	Returns	Description
isInstalled()	Future<bool>	Check if MSA app is installed
warmUp()	Future<String?>	Warm up the SoftPOS terminal
activate(code)	Future<String?>	Activate with code from backend
saleTransaction(amount, posMessageId?)	Future<MsaTransactionResult?>	Perform a sale transaction

MsaTransactionResult

Key fields: tranId, tranStatus, approvalCode, totalAmount, paymentMethod, maskedAccount, rrn, trace, mchName, acqTid, acqMid, isApproved, isError.

Platform Support

Android	iOS
✅	❌

Note: This plugin is Android-only as MineSec SoftPOS is an Android application.

Contact

For any inquiries, please reach out to: [e-mail]