Fieldpine Logo Documentation Home  
POS Commands Home

The eft() command directs the POS to invoke connected payment providers and request payment processing. A single command consists of a number of directives to control the processing.

For example eft(amount(4.99) cash(20)) requests an eftpos payment for 4.99 and additionally permitting a $20 cash out operation.

Not all directives apply to every Eftpos vendor, they depend on which Eftpos solution you are using, and what technical ability the supplied interface has.


(All Vendors) Sets the amount of payment to request


Reserved for future use


(All Vendors) Sets any cash out component of this payment request


(All Vendors) Sets the reference code to be used for this transaction. A default value will be supplied if not set. If you manually supply reference codes, you will need to ensure that the requirements of the eftpos provider are met. You must not override this value when using EFTPOS New Zealand V5 integrated eftpos as transaction recovery under restart conditions may not function correctly.


(All Vendors) Defines the type of transaction to be performed.

purchaseRequests a normal eftpos purchase transaction. The amount is specified using amount(X)
cashRequests a cash out only transaction, without an associated purchase. The cash out amount is specified using cash(X)
purchasecashRequests an eftpos purchase transaction with additional cash out. The purchase amount is specified using amount(X) and the cash out with cash(Y)
refundRequests an eftpos refund transaction. Refund transactions may require additional merchant agreements and processes in order to be used. Contact your eftpos acquirer for more information
recoverUsed internally. Do not specify
balanceRequests a balance transaction to allow a customer to see their current balance. Rarely used
onlineflybuyReserved for Flybuy card processing. Contact Fieldpine before use.
noncashSpecialised use. Use only when directed by Fieldpine. Primarily this is used for systems that use a cash out transaction to indicate the charging of a phone card or similar. A seperate txn() is required as otherwise the cash out transaction causes the End of Day to misbalance. Essentially this command is letting the POS know that this "cash out" physical pinpad transaction does not involve the actual flow of cash


(Some Vendors) Sends the command ZZZ directly to the payment interface as a function request. This is used to request processing that is not payment processing. Each interface is free to supply and support whatever functions it wishes, but the names are standardised.

eft(function(Login)) or eft(function(logon))Initiate a Login process. Most systems will do this automatically if required.
eft(function(cpanel))Display a control panel to allow the operator a menu of further choices
eft(function(setenq))Request a settlement enquiry
eft(function(setcut))Request a settlement cutover
eft(function(reprint))Request a reprint of the last print
eft(function(flybuy))Initiate a request to scan Flybuy loyalty card




(Rare) This directive allows you to pass direct values to the underlying provider regardless of POS support for those features. This directive is rarely required.


(All Vendors) Causes a prompt screen to be displayed allowing the operator to manually enter or confirm the amount() and cash() values. This screen is invoked using the screen(standard(16)) PosCommand.

Mixing both prompt and surcharge may block prompt if a surcharge applies.


(Rare) Request the pinpad to display a prompt to allow the customer to swipe their loyalty card now.

eft(disable( [credit] [,cheque] [,saving] ))

(Some Vendors) Requests the pinpad to disable the customer from selecting certain types of accounts. This might be done if a special offer is not valid if paid by credit card, in which case eft(disable(credit)) could be used. Alternatively, if you have added a credit card surcharge, then eft(disable(cheque,saving)) might be used to ensure the customer does not accidentally pay from these accounts, which would then require you to refund the surcharge.


(All Vendors) Calculate if any payment surcharge applies and apply this surcharge now.


15 Aug 2017, P2008(Some Vendors) Reprint the last Eftpos receipt, or other output, received. This command is used when eftpos receipts are being suppressed and a copy is required. Receipt suppression only works while an Eftpos payment is in progress, if the pinpad requests a printout when a payment is not in progress it will be printed.

If a site wishes to not print eftpos receipts by default then the setting EftposReceiptInstant can be defined to

Vendor Support Information

OptionEftpos NZ PC-EftposSmartpay Keylink PlusPayment Express
disable(credit) Yes No No (probably possible)
disable(cheque) Yes. From version P28.
Using either disable(cheque) or disable(saving) will result in both accounts being disabled and "credit only" selected.
No No (probably possible)
printlast Yes No Yes