Skip to main content

In-Person Payments

Components​

The following image shows the architecture of the components required for the integration of the in-person payment system.

PIN Pad​

Multi-bank payment device with anti-tampering protection. There are two main types:

  • Integrated: connected to the POS via USB, Ethernet (local area network), WIFI and GPRS/3G/4G over public network and receive payment orders from the customer's POS.

  • Stand-alone: equipment capable of operating independently without receiving payment orders from the POS. They can operate with WIFI, GPRS/3G/4G or Bluetooth connection.

POS​

Also known as the cash software or PoS (Point of Sale), it is the program that will send the payment orders to the PIN Pad device through the DeviceHub and will also be responsible for closing the order.

In cases where the POS has a printer connected, a payment will not be considered final until the receipt is printed.

DeviceHub​

It is the logical piece that connects the PIN Pad, the gateway and the POS.

The architecture of the platform requires that each PIN Pad connects to the DeviceHub using a different port and pointing to the IP address of the DeviceHub, that is, there cannot be several PIN Pads that attack the same combination of IP address and port.

XML message that integrates the different functionalities of the gateway service. The client must mandatorily integrate the following requests that will be defined later in each of the sections:

  • Initialization – [InitializeDevice].
  • Obtaining the next message – [GetNextMessage].
  • Loading file 3000 – [CallSpecificFunction-20].
  • Loading PinOnline keys – [CallSpecificFunction-4].
  • Authorization – [BeginSellTransaction].
  • Refund - [BeginDevolution].
  • Cancellation – [CallSpecificFunction-0].

The DeviceHub can be installed locally on the POS or on a remote server. This depends on the client's architecture, taking into account their communications solution and their needs.

DeviceHub Cloud

DeviceHub Local

Communications​

Channel through which all the components are interrelated. The main means used will be the Internet connection that the merchant has individually or centrally.

The merchant that integrates the solution must have minimum requirements in terms of bandwidth and connection technology. The minimum bandwidth should be 2MB and the connection technology must be fiber optic or ADSL.

It is advisable to segment the networks to isolate the traffic of the payment solution from other services. This can be achieved by configuring a single access point and through traffic prioritization and quality techniques.