Skip to main content

Terminals

Some Adapters integrated in the IXOPAY platform are using protocols based on the ISO 8583 standard (like GICC, e.Link). The ISO 8583 is a low-level protocol, communicating directly with the Acquirer's authorization host and is also used by card schemes (Visa, MasterCard etc.) internally.

Adapters using a ISO 8583 interface require some additional configuration due to the nature of the protocol (see Terminal configuration). In theory, each Connector represents a digital POS terminal. Since in the ISO 8583 protocol each Terminal can only process one Transaction at a time, The IXOPAY platform supports the creation of multiple Terminal IDs per Connector to allow simultaneous processing of multiple transactions.

note

In case you do not see the Terminal Tab for an Adapter integrated using a protocol based on the ISO 8583 standard, make sure to check your User Permissions for the merchant.connector.terminal.* Permissions

Terminal Permissions
Terminal Permissions

Terminal Configuration​

To configure Terminal IDs for your Connector please follow these steps:

  1. Navigate to the Connector Detail Overview
  2. Select the Tab Terminals
  3. Click + Terminal to configure a new Terminal ID (see Terminals)
  4. Fill in the unique Terminal ID,
  5. Change the System Trace Audit Number (STAN) - prefilled starting from zero
  6. Change the Capture Reference - prefilled starting from zero
  7. Enable the Terminal and click + Create.

After creating the Terminal it can be edited using the Edit Action button.

Connector Detail Overview
Connector Detail Overview
Terminals
Terminals
Create New Terminal
Create New Terminal
info

In case you do not know which IDs to configure, please get in touch with our Support Team in the IXOPAY Customer Experience Portal.

Error Handling​

As described above one Terminal ID can only process one Transaction simultaneously. The Terminal ID is blocked during the transaction processing by the IXOPAY platform and, depending on the integration, any further incoming transaction for this Connector will wait for a few seconds to be processed. If no Terminal ID becomes available, the transaction will end up in the error state with error reason "too many concurrent requests" (Transaction List filtered for this Connector). In this case simply add additional Terminal IDs for all Transactions to be processed.

Last updated on