flutter_nmi #

NMI Payment SDK for iOS & Android (Flutter plugin).

SDK versions #

Platform	ChipDna / NMI SDK
Android	Payment Device SDK 5.4.1 Cassiopeia (full jars)
iOS	ChipDna Mobile 3.16.1 (not yet upgraded to 5.4.1)

minSdkVersion 31
Bluetooth + location permissions (including BLUETOOTH_CONNECT on API 31+)
For TCP/IP SmartPOS (Axium loopback): host app must allow cleartext / loopback (usesCleartextTraffic is declared by the plugin)

Existing Flutter API is preserved. Additive options:

TCP/IP connection: initialize with deviceType: "TcpIp", optional is_smart_pos: "1", pinPadIpAddress, pinPadPort (defaults 0.0.0.0 / 8088), and deviceName
BluetoothDeviceId: pass bluetoothDeviceId (or deviceId) on initialize, or select from the pin-pad list (IDs included)
Offline: FlutterNmi.processOfflineRequest({ 'userReference': '...' })
TMS (Android): initialize with action: "TMSUpdate" forces a TMS update (FullTmsUpdate=FALSE). Add full_tms_update: "1" to download all pin-pad configuration.
Pre-auth / confirm / void (Android):
- preAuth({ amount, userReference, ... }) — Sale with AutoConfirm=FALSE / CloseTransaction=FALSE, ChipDna TippingType=END_OF_DAY (no TipAmount on start). Terminal TMS must allow end-of-day tipping.
- confirmTransaction({ userReference|transactionId, amount, tip? }) — capture; optional tip (dollars) maps to ChipDna TipAmount (or null when 0). Completes to Flutter when ChipDna returns TRANSACTION_RESULT=APPROVED (not only RESULT=TRUE).
- voidTransaction({ userReference|transactionId }) — void open auth; same TRANSACTION_RESULT=APPROVED success mapping as confirm
- Default initialize + action: Transaction remains auto-sale (AutoConfirm=TRUE); optional tip (dollars) maps to ChipDna TipAmount (or null when 0). Sale does not send TippingType=END_OF_DAY.

Tap to Pay / Cloud Commerce AAR and surcharge Flutter APIs are not included in this release.

This project is a Flutter plug-in package.

For help getting started with Flutter, see the online documentation.