Payroc CloudConfigure your device

Android (POS on a different device)

View as MarkdownOpen in Claude

Use our Android (POS on a separate device) configuration to connect your POS to an Android payment device that is running the Payroc App. Your POS and the payment device don’t need to be on the same network or in the same location, but they must be connected to the internet.

Your POS system manages the checkout experience and sends instructions to the payment device, while the Payroc App processes the payment.

How it works

The following diagram describes the flow of a transaction between your POS, our gateway, and the payment device.
Payroc Cloud diagram

Initiate a transaction

  1. Your POS 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 your 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. Your POS sends a request to our gateway to check the status of the instruction.
  2. Our gateway sends the response to your POS that contains a HATEOAS link to view the transaction.

View the transaction

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

Integration journey

  1. Use our API to send sale instructions to the payment device.
  2. Test your integration with our Payroc Cloud Simulator.