How to Integrate a Register with a PIN pad

Merchants using a Cash Register application can use a Dejavoo payment terminal as a PIN pad to process transactions securely. This integration allows merchants to initiate transactions from the Register and complete payments on the PIN pad through SPIn (Secure Payment Interface). This document explains how to configure and enable this integration on the iPOSpays Portal.

Feature Compatibility

• Supported Processors: Supported by all processors

• Supported Fee Types: Supported all Fee Types

• Supported Terminals (PIN pad):

  • Android P Line Terminals: P1, P3, P5, P8, P12, P17

  • Android QD Line Terminals: QD2, QD3, Q3Pro, Q3mini, QD4, QD5

Steps to Integrate a Register with a PIN pad

Step 1: Log In to iPOSpays Portal

Log in to the iPOSpays Portal using your ISO credentials.

Step 2: Locate the TPN

1. From the side menu, click S.T.E.A.M → Edit Parameters.

2. Search for the TPN you want to enable PIN pad integration.

3. Click Edit Parameter.

Step 3: Configure Integration Settings

1. Click Integration.

2. In the Type of Integration field, select SPIn.

3. Choose the required SPIn Mode:

   • SPIn Local

   • SPIn Cloud

SPIn Local Configuration

• Select SPIn Local in the Spin Mode.

• Copy the following details:

  • Register ID

  • Port Number

SPIn Cloud Configuration

• Select SPIn Cloud in the SPIn Mode.

• Copy the following details:

  • Register ID

  • Auth Key

Step 4: Save the Configuration

Once you have configured the required parameters, you have two options:

• Save → Applies the current parameter configuration directly to the selected TPN.

• Save as Template → Saves the current parameter configuration as a reusable template.

Download Parameters on the PIN pad

After enabling Spin Local or Spin Cloud, download the parameters on the terminal

1. Enter the SPIn-enabled CloudPOS TPN on the PIN pad terminal.

2. Perform a Parameter update on the device by clicking Download Parameter.

3. A SUCCESS prompt will appear on the device.

4. Tap OK to proceed.

The PIN pad is now successfully integrated with the Register.

Configure the Register using the credentials based on the selected SPIn mode:

• If Spin Local is enabled, enter the Register ID and Port Number in the Register.

• If Spin Cloud is enabled, enter the Register ID and Auth Key in the Register.

• Enter the transaction amount on the Register and click Submit.

• Once the configuration is complete, the Register is ready to send transaction requests to the PIN pad.

The entered amount is automatically transmitted to the integrated PIN pad, allowing the customer to proceed with the payment. After the transaction is completed on the PIN pad, the transaction status is sent back and displayed on the Register.

SPIn Proxy (Troubleshooting)

SPIn proxy helps integrators ensure that the connection between SPIn and the payment terminal is established.

1. Log in to the iPOSpays portal using ISO or Merchant credentials (available for both ISO and merchants).

2. Navigate to Troubleshooting and select Spin Proxy.

3. Enter the SPIn-enabled CloudPOS TPN in the search box.

4. Click Check POS Connection.

Verify the connection:

• If the arrow between the SPIn logo and the payment terminal logo is lit up in green, it indicates that the connection has been successfully established.

• If the arrow is lit up in red, it means the connection has not been established, and there is an issue.

Simulated testing lets integrators verify if the generated Auth Key and TPN are working and ready to be configured with the Host System.

TPN & Auth Key Check – Short Steps:

TPN Check: Click “Check Register Connection” and select “Show TPN.”

• Confirm the pop-up on the terminal.

Verify the connection:

• If the arrow light is green, the TPN will appear on the portal, indicating a successful connection.

• If the arrow light is red, the connection has failed.

Auth Key Check:

• Click “Check Register Connection” and select “Show Auth Key.”

• Confirm the pop-up on the terminal.

Verify the connection:

• If the arrow light is green, the Auth Key will appear on the portal, indicating a successful connection.

• If the arrow light is red, the connection has failed.