Integration Features

A number of the below terminal features will need to be configured via mx51 Payments. If you would like a feature enabled on your test terminal please direct this request to your mx51 Payments contact.

Mandatory Feature Set

Purchase & refund: A positive/negative transaction driven from the POS to Spice.

Mail Order & Telephone Order (MOTO): This is a card not present transaction used when a customer’s card is not physically available to a merchant to complete a transaction. The POS must flag a transaction as MOTO and the card details of the customer must be entered manually into the EFTPOS terminal.

Terminal based surcharging: This feature automatically adds a predefined surcharge to a purchase transaction at the time the card is presented to the terminal. The POS is required to accept the surcharging field in the response back from the EFTPOS terminal.

Terminal based tipping (Hospitality Only): This feature allows tips entered into the EFTPOS terminal once a purchase request has been sent from the POS. The POS is required to accept the additional tipping field in the response back from the EFTPOS terminal.

Signature Transaction: In the event a signature is required to verify a transaction the POS will receive a response with the signature receipt to print. Spice will display a signature Accept/Decline message to the user. The POS will then need to query Spice to obtain the result. More information on this workflow can be found here.

Integrated printing: The EFTPOS terminal relies on the POS to print receipts and settlement reports from the POS printer.

Crash recovery: In the event that the POS or Spice crashes a recovery workflow is required. Information on how to implement this recovery can be found here.

Ping Test: Prior to each transaction the POS is required to use the HTTP Ping end-point to ensure Spice is running and paired. Information on how to implement the ping test can be found here.

Settlement: A request driven by the POS to settle the EFTPOS terminal via Spice. A settlement is an instruction by the EFTPOS terminal to the bank to finish its day's trading. The merchant will receive all funds prior to the settlement instruction in the next deposit. The POS has the option to store the settlement information for reconciliation.

Additonal Feature Set

POS based Cashout: Cashout is a transaction type that requests funds from the customer's bank to be withdrawn and then those funds are to be provided by the merchant. Cashout is a unique transaction type and needs to be implemented independently of a purchase transaction. This feature allows the merchant to enter the Cashout amount into the POS and then request a Cashout transaction for that total to the EFTPOS terminal. Note: Cashout is only available when selecting Savings or Cheque.

POS based purchase with Cashout: This transaction type combines a purchase and a Cashout transaction into a single request. It is used when a customer requests to withdraw funds from the merchant while completing a purchase. The Cashout amount is entered into the POS along with the purchase. Cashout with purchase is a unique transaction type and needs to be implemented independently of purchase and Cashout. Note: Cashout is only available when selecting Savings or Cheque.

Terminal based purchase with Cashout: This feature asks the cardholder to enter their desired Cashout amount into the EFTPOS terminal at the time of completing a purchase. The POS is required to accept the additional Cashout field in the response back from the EFTPOS terminal. Note: Cashout is only available when selecting Savings or Cheque.

Allow surcharging from POS: If a POS supports surcharges this value can be passed through to the EFTPOS terminal in a seperate field.

POS based tipping: This feature allows tips entered into the POS to be included with the purchase request to the EFTPOS terminal.

Suppress Merchant Password - MOTO & Refund: During a MOTO or Refund transaction the merchant is required to provide a password on the EFTPOS terminal. The password requirement can be suppressed as part of the transaction message from the POS. This is only recommended if the POS has implemented user roles.

Split transactions: This involves splitting the payment amount into two or more transactions made by different payment methods. For example, you could split a purchase or refund so that it is partially for paid with cash and use EFTPOS to pay the remaining amount. Or split the EFTPOS purchase or refund to use two different credit cards.

Settlement inquiry: This feature is a request to the terminal to return the current or a previous dates settlement report. It allows the POS to request a settlement report from the EFTPOS terminal without requiring a settlement. The request will trigger the terminal to prompt the merchant to select the current day or another date and then return the report to the POS.