This section documents the SPIn REST API methods for running transactions and managing terminal payments.

Prerequisites

  • iPOSpays-powered Dejavoo terminal

  • Login credential to iPOSpays

For Sandbox (UAT)

Users should be onboarded on iPOSpays sandbox(UAT) environment as a merchant and have a valid TPN.

For Production (Live)

Users should be onboarded on iPOSpays production environment as a merchant and have a valid TPN.

If you do not have a TPN, contact your ISO or devsupport@dejavoo.io

Steps to Setup

Step 1: Login to iPOSpays

Step 2: Enable SPIn for your TPN.

  • Go to S.T.E.A.M -> Edit Parameters -> search and select your TPN
  • Click Edit Parameter
  • Click Integrations
  • Under Type of Integrations, select SPIn and Choose Cloud under Spin Mode.
  • Copy the Register ID and Auth Key. You will need these values when calling the API from the Host System.

Watch This Video for a Visual Walkthrough of the Steps

SPIn Proxy (Troubleshooting)

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

  • Login to iPOSpays
  • Click “Troubleshooting SPIn Proxy”
  • Enter your TPN
  • Click “Check POS 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. In this case, please reach out to us at support@dejavoosystems.com.

We also offer simulated testing to 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 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. For failed connections, contact support at support@dejavoosystems.com.

Auth Key Check:

  • Click “Check Register Connection” and select “Show Auth Key.”
  • Confirm 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. For failed connections, contact support at support@dejavoosystems.com.

Sample Source Code

Error Codes and Their Meaning

For a complete list of error codes and their explanations, please visit our Error Codes Reference Page.

Last updated on November 11, 2026