IntegratePayroc CloudConfigure your payment device

Configure Payroc Cloud for a non-Android device

You can use Payroc Cloud to send instructions to IDTech and Ingenico devices that don’t use an Android operating system and don’t run the Payroc App.

To use Payroc Cloud on a non-Android device, you must configure Payroc Cloud on the device using the middleware solution that we provide. The middleware facilitates the communication between your POS, our gateway, and the payment device. You can run the middleware solution on either a Windows or Linux host machine.

How it works

Payroc Cloud diagram

Initiate a transaction

  1. The POS running the middleware sends an instruction to our gateway.
  2. Our gateway passes the instruction to the payment device.
  3. The payment device confirms that it has received the instruction.
  4. Our gateway sends a response to the POS that contains an identifier for the instruction.

Run the transaction

  1. The payment device captures the card details.
  2. The payment device sends the transaction details to our gateway.
  3. Our gateway sends the transaction details to the processor.
  4. The processor sends a response to our gateway.
  5. Our gateway 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: