Manage Cloud Devices

Use Payabli’s device management functions to register, unregister, and list cloud devices. This guide covers the key operations for managing devices through the API.

​

Register a device

Send a POST request to /api/Cloud/register/{paypointId} to register a new cloud device. See the API reference for this endpoint for full documentation.

The registration code you need varies depending on your device. For an Ingenico device, you need the activation code that appears on the screen after you configure WiFi. For a PAX A920 device, you need the serial number on the back of the device.

This example registers the device with the registration code YS7DS5 to the my-paypoint paypoint, and gives it the description of “Front Desk POS”.

curl --request POST \
    --url https://api-sandbox.payabli.com/api/Cloud/register/my-paypoint \
    --header 'accept: application/json' \
    --header 'content-type: application/*+json' \
    --header 'requestToken: <API TOKEN>' \
    --data '
{
  "registrationCode": "YS7DS5",
  "description": "Front Desk POS"
}'

​

List devices

Send a GET request to /api/Cloud/list/{paypointId} to retrieve a list of registered devices for a paypoint. See the API reference for this endpoint for full documentation.

This example lists devices for the my-paypoint paypoint.

  curl --request GET \
      --url https://api-sandbox.payabli.com/api/Cloud/list/my-paypoint \    
      --header 'accept: application/json' \
      --header 'content-type: application/*+json' \
      --header 'requestToken: <API TOKEN>'

​

Unregister a device

Send a DELETE request to /api/Cloud/register/{paypointId}/{deviceId} to remove a device registration. See the API reference for this endpoint for full documentation.

This example unregisters the device with the deviceId 6c361c7d-674c-44cc-b790-382b75d1xxx from the my-paypoint paypoint.

  curl --request DELETE \
      --url https://api-sandbox.payabli.com/api/Cloud/register/my-paypoint/6c361c7d-674c-44cc-b790-382b75d1xxx \
      --header 'accept: application/json' \
      --header 'content-type: application/*+json' \
      --header 'requestToken: <API TOKEN>'

​

Response format

All device operations return a standardized response format:

  {
      "isSuccess": true,
      "responseText": "Success",
      "responseCode": 1,
      "responseData": "6c361c7d-674c-44cc-b790-382b75d1xxx" // this is the device ID
  }