{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["sub-heading","state","img"]},"type":"markdown"},"seo":{"title":"Add a device","description":"Transform your commerce with PXP's unified platform—seamless payments, real-time insights, and global growth in one powerful integration.","lang":"en-UK","siteUrl":"https://developer.pxp.io","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"add-a-device","__idx":0},"children":["Add a device"]},{"$$mdtype":"Tag","name":"SubHeading","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Register a new point-of-sale device and configure its settings."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-1-add-a-device-in-the-unity-portal","__idx":1},"children":["Step 1: Add a device in the Unity Portal"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To add a POS device in the Unity Portal:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://portal.pxp.io","target":"_blank"},"children":["Unity Portal"]},", go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Merchant setup > Sites"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select the site that you want to add a POS device to."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Services"]}," tab."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Pos service"]}," row, click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Edit"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["New POS"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Choose your settings."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]}," to confirm."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your device is added to the list of devices and its state is set to ",{"$$mdtype":"Tag","name":"State","attributes":{"text":"New"},"children":[]},". If this is the first device associated with this site, an HMAC key is also generated and displayed in the top left."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-2-activate-the-device","__idx":2},"children":["Step 2: Activate the device"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To activate a POS device:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Set the device's status to ",{"$$mdtype":"Tag","name":"State","attributes":{"text":"Pending"},"children":[]}," by clicking ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["..."]}," in the ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Actions"]}," column and selecting ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Pending"]},"."]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/set-to-pending.065dd29f6cff465543494a5b62f6ad3b7ed22968a93fbe2c67695405653ae789.552631fd.png","alt":"","framed":false,"withLightbox":true,"className":"screenshot","width":"200px","height":"","align":"center"},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":2},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Turn on the device and connect it to the Internet."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open the POS+ app. Your device then sends its serial number to the POS Service, which returns an HMAC used to authenticate it. The device's state changes to ",{"$$mdtype":"Tag","name":"State","attributes":{"text":"Active"},"children":[]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The device automatically downloads the settings that were configured in the Unity Portal."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your device is now ready to use."]}]},"headings":[{"value":"Add a device","id":"add-a-device","depth":1},{"value":"Step 1: Add a device in the Unity Portal","id":"step-1-add-a-device-in-the-unity-portal","depth":2},{"value":"Step 2: Activate the device","id":"step-2-activate-the-device","depth":2}],"frontmatter":{"seo":{"title":"Add a device"}},"lastModified":"2026-09-09T16:14:22.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/point-of-sale/pos-plus/sdk/add-a-device","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}