Android (POS on a different device)

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.

sequenceDiagram
    participant POS as POS
    participant GW as Gateway
    participant D as Device

    rect rgba(0, 81, 194, 0.4)
        Note over POS,D: Initiate a transaction
        POS->>GW: 1. Create instruction
        GW->>D: 2. Send instruction to device
        D-->>GW: 3. Confirm delivery of instruction
        GW-->>POS: 4. Confirm that the device accepted the instruction
    end

    rect rgba(0, 224, 184, 0.3)
        Note over POS,D: Run the transaction
        Note over D: 1. Device captures the card information
        D->>GW: 2. Send transaction details
        Note over GW: 3. Gateway sends transaction details to the processor
        Note over GW: 4. Processor returns a response for the transaction
        GW-->>D: 5. Send transaction response
    end

    rect rgba(0, 81, 194, 0.4)
        Note over POS,D: Get a link to the transaction
        POS->>GW: 1. Get the status of the instruction
        GW-->>POS: 2. Return instruction with a link to the transaction
    end

    rect rgba(0, 224, 184, 0.3)
        Note over POS,D: View the transaction
        POS->>GW: 1. View details of the transaction
        GW-->>POS: 2. Return details of the transaction
    end

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.