IntegratePayroc CloudConfigure your payment device

Configure Payroc Cloud for a non-Android device

You can use Payroc Cloud to send instructions from a POS to an IDTech or Ingenico payment device that doesn’t use an Android operating system.

As there is no direct connection between the POS, the payment device, and our gateway, you need to download our middleware so that they can communicate with each other. Our middleware can run on a host machine that has a Windows or Linux operating system.

Important: Each host machine running middleware can connect by USB to only one payment device at a time.

How it works

Payroc Cloud diagram

Initiate a transaction

  1. The POS sends an instruction to our gateway.
  2. Our gateway sends the instruction to the middleware.
  3. The middleware starts the payment on the payment device.
  4. The middleware confirms it received the instruction by sending a response to our gateway.
  5. Our gateway returns an identifier to the POS for the payment instruction.

Run the transaction

  1. The payment device captures the transaction details.
  2. The payment device sends the transaction details to the middleware.
  3. The middleware sends the transaction details to our gateway.
  4. Our gateway sends the transaction details to the processor.
  5. The processor returns a response to our gateway.
  6. Our gateway returns a response to the middleware.
  7. The middleware sends the response to the payment device.

Get a link to the transaction

  1. The POS sends a request to our gateway to check the status of the instruction.
  2. Our gateway sends the response to the POS that contains a HATEOAS link to view the transaction.

View the transaction

  1. The POS sends a request to our gateway to view the details of the transaction.
  2. Our gateway sends a response to the POS that contains the details about the transaction.

Integration steps

To use Payroc Cloud on a non-Android device, complete the following steps:

  1. Prepare your host machine for configuration.
  2. Configure Payroc Cloud for a non-Android device.

Before you begin

To meet the requirements for configuration, your host machine must have Java 8 or later installed. If you use a Windows 32-bit host machine, make sure you have installed 32-bit Java and configured its path.

Step 1. Prepare your host machine for configuration

  1. Connect the payment device to a USB port on the host machine.
  2. Go to our Github repository and download Payroc Cloud Middleware from the release files.
  3. Extract the files from the zipped folder.

Step 2. Configure Payroc Cloud for a non-Android device

To configure Payroc Cloud, go to the following guides: