Sign in

v1

latestOpenAPI 3.0.32026-07-2488203535.0 KB
Devices

Register Cloud Device

Register a new cloud device with the merchant using a registration code.

post/v5/devices

Request body

registration_codestring required

The registration code provided with the device

nicknamestring

Optional nickname for the device

defaultboolean

Whether to set this device as the default cloud device for the merchant

Response

Device registered successfully

object'device' required

String representing the object's type. Always 'device' for device objects.

idstring required

Unique identifier for the device

device_nicknamestring nullable

Nickname assigned to the device

makestring nullable

Device manufacturer

modelstring nullable

Device model

serial_numberstring nullable

Device serial number

registration_status'registered' | 'deregistered' required

Current registration status of the device

last_transaction_datestring date-time nullable

Date and time of the last transaction processed on this device

date_registeredstring date-time nullable

Date and time when the device was registered

date_deregisteredstring date-time nullable

Date and time when the device was deregistered

connection_statusboolean nullable

Whether the device is currently connected

last_connected_datestring date-time nullable

Date and time when the device was last connected

last_disconnected_datestring date-time nullable

Date and time when the device was last disconnected

battery_infoobject nullable

Battery information (only included when current_status=true)

wifi_infoobject nullable

WiFi information (only included when current_status=true)