Get Started

TweezerComm follows the JSON-RPC 2.0 specification to standardize transaction processing between the POS/ECR and Agamento payment application (that runs on Nayax attended devices). JSON-RPC is a lightweight, remote procedure call (RPC) protocol encoded in JSON. It allows client and server communication using structured requests and responses.

Refer to the sections below to learn how to submit requests on TweezerComm.

Server Endpoint

TweezerComm operates over HTTPS using a standard REST API convention. The SPICy Server acts as the entry point for processing JSON-RPC messages. The server endpoint is structured as follows:

https://device_ip:8080/SPICy

All requests are processed at this endpoint using a POST method. Remember to replace device_ip with the actual IP address of your device.

📘

Agamento Port

Agamento listens on port 8080 for TC Lan integration and 9090 for Bonjour integration, allowing communication between the client application and the payment device.

Perform a Request

To request TweezerComm via the SPICy server, the client application must send an adequately formatted JSON-RPC request to the specified endpoint. Below is an example of how to initiate a basic transaction:

{
    "jsonrpc": "2.0",
    "method": "doTransaction",
    "id": "123454352",
    "params": [
        "engine",
        {
            "vuid": "44d96006",
            "amount": 100,
            "tranType": 1
        }
    ]
}

In this request, you need to configure the following parameters:

• jsonrpc: Defines the JSON-RPC version. In this case, always set it to 2.0.
• method: Specifies the method to be used. See methods for a list and description of available methods.
• id: A unique identifier for tracking the request.
• params: This is an array divided into two parts.
  • The first specifies the payment service in this example it is engine.
  • The second part contains the parameters specific to the requested method.

By following this structure, client applications can reliably interact with TweezerComm for secure and efficient payment processing.

See Also