Your client application will connect to the backend Mediator. And then it will send requests addressed to a certain PIN Pad connected to the Mediator. The PIN Pad, after processing your request, will respond back to the Mediator – and in turn – your app will receive the response.

Client credentials

In order to connect to the PIN Pad Mediator, you need to have the following credentials (provided by Netevia):

Client ID
Client Secret

Endpoints

These are the endpoints for the remote Mediator API:

dev environment: https://pinpad.netevia.dev
production environment: Coming soon

Connection and communication flow

The following is the general flow for connecting and communicating with the Mediator.
Detailed information about Mediator's API methods are provided in the Mediator API section.

Get the Access Token using your client credentials. Include that token in each subsequent request.
Get the list of available PIN Pads currently connected to the Mediator, and their serial numbers.
Build a request message for the PIN Pad and send it to the Mediator, specifying the target PIN Pad's serial number. You will receive a request ID from the Mediator as a response.
Poll the Mediator to check if there is a response from the PIN Pad. If there is, parse it accordingly.