IngenicoTurkey

This article describes the implementation of the Ingenico Turkey in the LS Pay engine. Ingenico communicates with a DLL file called GMPSmartDLL.

Setup

Pre-requisites

  • Ingenico USB driver: Driver for COM port communications.

Connect the terminal and make sure the GMPSmartDLL (version 15.22), provided by Ingenico, is located in the "C:\LSPay\Ingenico" folder.

Files:

  • "GMPSmartDLL.dll" - the DLL file used to communicate to the terminal.

Settings

  • COM port: COM port used by the terminal.
  • Terminal Id: The id of the terminal - used for admin features, ex. standalone refund and reporting.
  • Admin password: Password that is needed to perform admin features such as standalone refund and Z report.

Hardware

Tested on Windows 10 using the iWE280 terminal and version 15.22 of the GMPSmartDLL.

Other Notes

  • Additional ID = Json string containing the Bank ID, ID for referenced refund, Receipt ID and InstallmentCount.

Capabilities

IEAManagement

  • IPairOnTerminal
  • ILineItems
  • IPrinter
    • IReceiptPrinting
    • IReprint
      • IReprintLast
      • IReprintReceipt

IEFT

  • IPED
  • IReport
  • ISession
  • ITransactionDetails

Appendix

Purchase flow

  • StartSession
  • SendTransactionDetails (Online invoice feature - Inposia)
  • AddLineItems
    • All line items listed in the POS/ECR added to the transaction with detailed information, including offers using the ILineItems interface
  • Purchase (CASH/CARD/VOUCHER).
    • Do this until the total amount has been paid
    • Cash payments are also required to be sent to the terminal
  • PrintAsync (IReceiptPrinting)
    • Terminal prints out payment slips
    • (Optional) Add custom user message with 'receiptLines' parameter
    • (Optional) To print a QR code, add 'QR:' as a prefix to the QR code. Ex - 'QR:This is the QR code'
  • FinishSession

Cancel

Cancel is not supported, but the process to "cancel" the transaction after the details have been sent

  1. Void all payments, in current session, one by one
  2. Remove all line items
  3. FinishSession

NOTE: step 2 is always required when canceling after SendTransactionDetails

LineItems

Required

  • Quantity (int)
  • Unit price (decimal)
  • Tax index (int)

Tax index is a zero based index of the department table on the terminal

Reversal

  • StartSession
  • SendTransactionDetails
  • Refund/Void
  • FinishSession

NOTE: No line items are needed to perform Refund/Void.

CreditNote (GiderPusulasi)

  • StartSession
  • SendCreditNoteDetails
  • AddLineItems
  • Refund
    • TenderType = Voucher
  • PrintAsync (IReceiptPrinting)
  • FinishSession