Manage Ingenico Link and Lane devices

Use Payabli’s device management functions to register, unregister, and list Ingenico Link and Lane devices. For PAX devices, see Manage PAX devices. For AXIUM devices, see Manage AXIUM devices.

Register a device

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

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

1
curl -X POST https://api-sandbox.payabli.com/api/Cloud/register/8cfec329267 \
2
     -H "Authorization: Bearer <token>" \
3
     -H "Content-Type: application/json" \
4
     -d '{
5
  "description": "Front Desk POS",
6
  "registrationCode": "YS7DS5"
7
}'

A successful registration returns a response with the device ID in the body.

1
{
2
  "responseText": "Success",
3
  "isSuccess": true,
4
  "responseData": "6c361c7d-674c-44cc-b790-382b75d1xxx"
5
}

List devices

Send a GET request to /api/Query/devices/{entry} to retrieve the devices registered to a paypoint. For organization-wide results, use /api/Query/devices/org/{orgId}. The response includes every device model registered to the paypoint or organization; see Devices overview for how to tell them apart.

This example lists devices for the 8cfec329267 paypoint.

1
curl -G https://api-sandbox.payabli.com/api/Query/devices/8cfec329267 \
2
     -H "Authorization: Bearer <token>" \
3
     -d fromRecord=0 \
4
     -d limitRecord=20 \
5
     -d sortBy=desc(createdAt)

The response returns matching devices in Records and aggregate totals in Summary. Use Summary.totalRecords and Summary.totalPages with the fromRecord and limitRecord query parameters to page through results.

1
{
2
  "Summary": {
3
    "pageIdentifier": null,
4
    "pageSize": 20,
5
    "totalAmount": 0,
6
    "totalNetAmount": 0,
7
    "totalPages": 2,
8
    "totalRecords": 28
9
  },
10
  "Records": [
11
    {
12
      "deviceId": "499585-389fj484-3jcj8hj3",
13
      "idCloud": 142,
14
      "description": "Front Counter Terminal",
15
      "serialNumber": "SN-90210-XR",
16
      "friendlyName": "Front Counter",
17
      "make": null,
18
      "model": null,
19
      "deviceType": 1,
20
      "deviceStatus": 1,
21
      "deviceOs": null,
22
      "macAddress": "1A2B3C4D5E6F",
23
      "lastHealthCheck": "2026-04-09T14:49:42Z",
24
      "registrationCode": "REG-A1B2C3D4",
25
      "activationAttempts": 0,
26
      "activationCodeExpiry": "2026-04-09T14:49:42Z",
27
      "createdAt": "2026-04-09T01:14:37Z",
28
      "updatedAt": "2026-04-09T14:49:42Z",
29
      "paypointId": 3040,
30
      "paypointDba": "Gruzya Adventure Outfitters",
31
      "paypointLegal": "Gruzya Adventure Outfitters, LLC",
32
      "paypointEntry": "8cfec329267",
33
      "paypointLogo": "https://payabli-public-objects.s3.amazonaws.com/pe3040.png",
34
      "externalPaypointId": "GRUZYA-01",
35
      "parentOrgId": 100,
36
      "parentOrgName": "Mountain View Services",
37
      "transactionCount": 342,
38
      "volumeProcessed": 28650.75
39
    }
40
  ]
41
}

Filter and sort results with query parameters — for example, status(eq)=1 for active devices only. The full list of filterable fields is on the List devices by paypoint API reference; for operator syntax and pagination, see the Filters and conditions reference.

Unregister a device

Send a DELETE request to /api/Cloud/register/{entry}/{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 8cfec329267 paypoint.

1
curl -X DELETE https://api-sandbox.payabli.com/api/Cloud/register/8cfec329267/499585-389fj484-3jcj8hj3 \
2
     -H "Authorization: Bearer <token>"

A successful operation returns a 200 response with the device ID in the body.

1
{
2
  "responseText": "Success",
3
  "isSuccess": true,
4
  "responseData": "6c361c7d-674c-44cc-b790-382b75d1xxx"
5
}

Get signature data from a transaction

Related resources

See these related resources to help you get the most out of Payabli.