API references
Search documentation... ⌘K
API references
Open merchant dashboard
Terminals API
All our references

Verify the device-to-terminal connection

Returns one of: - CONNECTED when the provided device is bound to the terminal - RESET_CONNECTION when no device is bound (erase keys/PIN and call /connect-device)

Errors: - UNRECOGNIZED_DEVICE if another device is currently bound - NOT_FOUND if the merchant or terminal cannot be found - NOT_ENABLED if the terminal is disabled - NOT_CONFIGURED if the terminal has no installation linked

Endpoint signature
POST https://api.reservepay.com/terminals/verify-connection HTTP/1.1
Content-Type: application/json
Accept: application/json
{
merchant_id: string,
terminal_id: string,
device_id: string,
}
Returns: string
New to Reservepay? Read our guide on how to call endpoints to get started.
Request arguments
merchant_id string

Required. The merchant ID this terminal belongs to.

terminal_id string

Required. Terminal ID the device is connected to.

device_id string

Required. Device UUID generated on device.

Errors specific to this endpoint
UNRECOGNIZED_DEVICE

The device_id does not match the one bound to the terminal.

NOT_FOUND

Merchant or terminal could not be found.

NOT_ENABLED

The terminal exists but is disabled.

NOT_CONFIGURED

The terminal has no installation linked; assign an installation first.

Errors common to all endpoints
UNHANDLED_ERROR

Raised when the server encounters an unexpected internal error.

INVALID_ARGUMENTS

Raised when the request contains invalid or missing parameters.

BAD_VERSION

Raised when requesting an unsupported or deprecated API version.

CODE SAMPLES
curl
Learn how to run these code samples in your terminal by reading our guide.