littlefish_payments_pos_verifone 10.0.8

The implementation package for the verifone nexo intent integration layer

littlefish_payments_pos_verifone

A Flutter package that provides integration between Littlefish Payments and Verifone Point of Sale (POS) terminals using the NEXO protocol.

Features

This package supports the following operations with Verifone terminals:

• Process purchase transactions
• Process cash withdrawal transactions
• Process cash purchase transactions
• Process reversals
• Close batches
• Print batch reports and receipts
• Get terminal information
• Get batch numbers
• Get transaction information

Usage

// Initialize the gateway
final gateway = LittleFishVerifonePOSGateway('your_package_name');
await gateway.initialise(settings: yourSettings);

// Process a purchase
final result = await gateway.processPurchase(
  businessId: 'your_business_id',
  merchantId: 'your_merchant_id',
  amount: 100.0,
  isoCurrencyCode: 'ZAR',
  transactionId: 'your_transaction_id',
  reference: 'your_reference',
);

// Close a batch
final settlementResult = await gateway.closeBatch(
  'your_business_id',
  'your_merchant_id',
);

// Get terminal information
final terminalData = await gateway.getTerminalInfo('your_business_id');

// Print a receipt
final printResult = await gateway.printPaymentReceipt(
  businessId: 'your_business_id',
  transactionId: 'your_transaction_id',
  printOption: ReceiptPrintOption.customer,
);

Implementation Details

This package uses Android Intents to communicate with Verifone terminals via the NEXO protocol, which defines XML-based messages for payment operations.

All operations follow a consistent pattern:

1. Validate readiness
2. Check permissions
3. Execute intent with XML payload
4. Parse and handle response

The implementation is based on the NEXO Interface Specification for Verifone Retail terminals, which defines the XML structure for various payment operations.

Requirements

• Flutter SDK: '>=3.3.0 <4.0.0'
• A Verifone terminal supporting NEXO protocol
• Android device for terminal communication