How do I force the terminal to require a signature for payment?

Follow these steps:

  1. Initiate a purchase
  2. Insert the credit card in with the chip facing down
  3. The EFTPOS terminal will display a chip malfunction error
  4. Do this 2 more times, and the EFTPOS terminal will now prompt to swipe the card
  5. Swipe the card, and select credit.
  6. Press Enter on the EFTPOS terminal to bypass the PIN entry. You will now be prompted to accept to decline the signature

Am I required to include Integrated Settlement in the integration?

No, it is not a mandatory feature.

What is the difference between Integrated Settlement Enquiry and Integrated Settlement?

A settlement enquiry can be run any number of times throughout the day. It will query the terminal to return a list of all the transactions made throughout the day. Settlement should only be run once each 24 hours. It should be run at the end of the day to finalise the takings.

What is RRN?

RRN is the Eftpos terminals receipt number. This is unique per transaction and is used to reconcile POS transactions with bank transactions.

How do I process an offline transaction?

In the cases of a temporary network outage or development environment maintenance, offline transactions can still be made. Any transaction under $50 can be processed via signature.

We recommend only making $1 transactions as there is a financial limit on offline transactions. You can process offline transactions by following these steps:

  1. Initiate a purchase
  2. Once you swipe the card you will get the option to PIN or ENTER
  3. That's when you can press Enter to bypass the PIN (You can only bypass the pin if the prompt say PIN or ENTER)
  4. This will print a signature receipt and will need to be accepted or declined via the POS or EFTPOS terminal to complete the transaction

Where should I be storing the secrets generated by pairing?

All secrets should be stored in a secure location usually with the rest of your application data.

Are there any character requirements for POSID?

POS ID can only be uppercase and alphanumeric with a maximum of 16 characters. Note that if the POS ID contains spaces or special characters pairing will fail.

How do you restart the EFTPOS Terminal?

  1. Unplug the terminal from the power.
  2. Hold down the red button until the terminal switches off.
  3. Long press the green button to start the terminal again
    Note: If the terminal gets stuck you can use the steps above.
    Also see the terminal guide for further terminal information.

Why is it important to keep a persistent connection between the POS and the EFTPOS Terminal?

  1. The main reason is for the user experience. When not making a purchase or pairing, the terminal is currently displaying "disconnected" which can generate complaints because customers think their integration is constantly breaking.
  2. Key rolling can happen at any time and is automatically triggered by the EFTPOS terminal any random points throughout each week. If the terminal is unable to reach the POS after 3 attempts, there is a change the terminal will automatically unpair from the POS.
  3. When the connection is persistent, it is naturally faster to initiate transactions.

Will the scheme_name of transactions paid through Afterpay, be displayed as 'afterpay' or 'mastercard/'Visa'?

Afterpay Card’s BIN number in Australia is 523163 and New Zealand is 428485. This is an exclusive Afterpay BIN and can therefore be used to differentiate Afterpay from other card payment types that are processed as part of your Mastercard (AU) or VISA (NZ) volume. If your Merchant Acquirer provides BIN level data in their summary or transaction level statements, all volume associated with this BIN number will always belong to the Afterpay Card. Some acquirers will offer this as part of standard reporting and for others this option may be available by request.