You can set the device PIN either at merchant, store or device level. The closer scope has precedence over the wider. Therefore a device PIN at at store level supersedes one at merchant level, and a device PIN at device level supersedes one at store level.

The device PIN must be at least 15 characters long. It must at contain least characters from 3 of these 4 classes:

• Numeric digits
• Upper case letters
• Lower case letters
• Special characters

The characters must not contain repetitions (“AAA”) nor sequences in any order (“abc”, “321”).

Example at Device Level

The endpoint to set the device PIN at device level is PUT /api/v2/Smart/Device/{SDV_xxx}/DevicePin.

If everything is fine, the API responds with 200 OK, and a confirming JSON.

If not successful, it responds with 500 Internal Server Error, and the common error response.

Example at Store Level

The endpoint to set the device PIN at store level is the same – but with a store ID (sic!) – PUT /api/v2/Smart/Device/{STO_xxx}/DevicePin.

If everything is fine, the API responds with 200 OK, and a confirming JSON.

If not successful, it responds with 500 Internal Server Error, and the common error response.

Example at Merchant Level

The endpoint to set the device PIN at store level is the same – but with a merchant ID (sic!) – PUT /api/v2/Smart/Device/{MRC_xxx}/DevicePin.

If everything is fine, the API responds with 200 OK, and a confirming JSON.

If not successful, it responds with 500 Internal Server Error, and the common error response.