NETSingapore

Keywords

Terminal: Card reader or pin entry device.

POS: Point of sale system, normally LS Central.

Important information

Recovery mechanism differs depending on the transaction type being recovered. Read more in "Recovery" section.

TransactionId length needs to be exactly 12 characters.

NetSingapore website

Settings

The NETSingapore plugin supports both ethernet and serial port (RS232) communication. Start by setting the connection type and then input the settings required for each connection type.

Serial (RS232) communication

  • Connection needs to be set as "RS232"
  • SecondaryPort needs to have the name of the comport the terminal is connected to.
  • BaudRate can be adjusted if needed.

Ethernet communication

  • Connection needs to be set as "ETH"
  • IPAddress needs to have the IP address of the terminal.
  • MainPort needs the port number of the terminal.

Setting list

Setting key Setting description Default Value Data type
Timeoutvalue Timeout in seconds 120 Int
Connection Connection type ("ETH" or "RS232") RS232 String
SecondaryPort COM port name (RS232 connection only) COM5 String
BaudRate Baud rate (RS232 connection only) 9600 Int
IPAddress Terminal IP Address (ETH connection only) 127.0.0.1 String
MainPort Terminal port number (ETH connection only) 3000 Int
ReceiptLineWidth Receipt line width 40 Int

Payments

Triggering a NETS Sale

​ To initiate a NETS sale, send a PurchaseRequest with no TenderType set (i.e., TenderType="Unknown").

Triggering a NETS Credit Sale

​ To initiate a NETS Credit sale, send a PurchaseRequest with TenderType set to "Credit."

Triggering an OCBC Sale

​ To initiate an OCBC sale, send a PurchaseRequest with an with an AdditionalData item: {Key: "Bank", Value: "OCBC"}

Triggering a QR Payment

  • OCBC:

    • To initiate an OCBC QR payment, send a PurchaseRequest with an with an AdditionalData item: {Key: "Bank", Value: "OCBC"} and then select the QR option at the terminal

  • NETS:

    • To initiate an NETS QR payment, send a PurchaseRequest (No AdditionalData ) then select the QR option on the terminal.

Triggering an Installment

  • OCBC:

    • To initiate an OCBC installment, send a PurchaseRequest with an with an AdditionalData item: {Key: "Bank", Value: "OCBC"} and TenderType="Installment"

  • NETS:

    • To initiate an NETS installment, send a PurchaseRequest with TenderType="Installment" (No AdditionalData ).

Refunds

Refunding a NETS Sale

​ Note: Refunding a NETS sale is not supported. NETS sale transactions need to be voided.

Refunding a NETS Credit Sale

​ To refund a NETS Credit sale, send a RefundRequest with TenderType set to "Credit."

​ Important: Standalone refunds are not supported, therefore RefundRequest.OriginalIds needs to contain the Ids from the transaction being refunded.

Refunding an OCBC Sale

​ To refund an OCBC sale, send a RefundRequest with an with an AdditionalData item: {Key: "Bank", Value: "OCBC"}

​ Note: This is a customization that needs to be implemented in the POS.

Voiding

Voiding a NETS Sale

​ To void a NETS sale, send a VoidRequest with no TenderType set (i.e., TenderType="Unknown").

​ Important: Standalone voids are not supported, therefore VoidRequest.OriginalIds needs to contain the Ids from the transaction being voided.

Voiding a NETS Credit Sale

​ To void a NETS Credit sale, send a VoidRequest with TenderType set to "Credit."

​ Important: Standalone voids are not supported, therefore VoidRequest.OriginalIds needs to contain the Ids from the transaction being voided.

Voiding a NETS installment sale

To void a NETS installment, send a VoidRequest with TenderType="Installment" (No AdditionalData ).

Voiding an OCBC Sale

​ No TenderType is required to void OCBC sales, regardless of if it was an installment.

​ To void an OCBC sale, send a VoidRequest with an AdditionalData item: {Key: "Bank", Value: "OCBC"}

​ Note: This is a customization that needs to be implemented in the POS.

Recovery

In case the POS encounters an error during a transaction, it can trigger a recovery process. Depending on the previous transaction type, different scenarios will occur:

  • If the previous transaction was a NETS transaction, NETS will return the result of the last approved transaction.

    • Known issue: NETS Credit transactions do not return the amount, therefore recovered NETS Credit transactions will have amount 0.

  • If the previous transaction was an approved OCBC transaction, OCBC will attempt to return the result of the last transaction. If OCBC cannot find the result, or if the previous transaction was declined, it will initiate a new transaction on the terminal.

Mid-day Reports and Settlement

Mid-day Report (X Report)

​ OCBC does not support mid-day reports. Therefore, only the mid-day totals from NETS transactions are included in the report.

Settlement Report (Z Report)

​ When you initiate a Z Report, it will start by settling NETS transactions, followed by settling OCBC transactions. The results of both settlements will be combined into a single report.

​ Note: After Z Report, the terminal will be logged out and needs to be logged in again before starting a new transaction.