Tags Pairing
API for getting device ID using SensePass tags.
This API should be called once on new tag assignment for a register, then the register saves the device ID for the next transactions until un-pairing proccess occur.
API Interface
Pair Tag with a register
POST
https://api.sensepass.com/api/devices/match
API for getting device ID using SensePass tags.
Request Body
pinCode
string
SensePass Tag ID - it's located below the QR code, for example: 53K-HMD-786
apiKey*
string
Location or Merchant API key
deviceId
string
Optional - Device ID of existing register, will add the tag to this device instead of creating a new device ID
posName
string
The name of the register, this value will be shown in merchant dashboard and partners dashboard
emvTerminalType
string
create an EMV Terminal for the matched device. choose a type out of sensepass supported devices: Dejavoo Clover Adyen Verifone Flex CloudIM KCP VIVA
agentConfig
JSONObject
key value pair of emv terminal specific settings
deviceAliasKey is the device ID created for the tag.
{
"name": "POS",
"deviceAliasKey": "syi2vm59le3zf7r9og29ezz12xin95vxhewuzdhu0c4cqizeu9d3yvs8rhn60el4eqr4iq6qozrguyw7rgrgqiec6abb9ftygfhvvwl9ar833i1ztnghj7k9zkrvrw5e8ykd2bueemddgcygwci3q12u4fu07ivxm1i7tw50wog7n9mu1pirdj0cg188mbvdf4axxpgc98udh71kxnu9i56yrm207msqrtl0hj44mvoibt4nanvenr06hpq9h9tq",
"merchantUID": "string",
"branchUID": "string",
"pinCode": "string",
"clientBoxes": [
"https://pay.sensepass.com/c_EG9RW3DMJ4WDRF7KFN5A0ICSB0UU16"
]
}
Examples
Creating a new device ID for a tag
{
"pinCode": "111-222-333",
"apiKey": "a1b2c3d4e5f6g7h8",
"posName": "NewYorkBranchPos"
}
Attaching a tag to existing device ID
{
"pinCode": "111-222-333",
"apiKey": "a1b2c3d4e5f6g7h8",
"posName": "NewYorkBranchPos",
"deviceId": "rti3vm59le3zf7r9og29ezz12xin95vxhewuzdhu0c4cqizeu9d3yvs8rhn60el4eqr4iq6qozrguyw7rgrgqiec6abb9ftygfhvvwl9ar833i1ztnghj7k9zkrvrw5e8ykd2bueemddgcygwci3q12u4fu07ivxm1i7tw50wog7n9mu1pirdj0cg188mbvdf4axxpgc98udh71kxnu9i56yrm207msqrtl0hj44mvoibt4nanvenr06hpq9h9bg"
}
Pair Response
{
"name": "POS",
"deviceAliasKey": "syi2vm59le3zf7r9og29ezz12xin95vxhewuzdhu0c4cqizeu9d3yvs8rhn60el4eqr4iq6qozrguyw7rgrgqiec6abb9ftygfhvvwl9ar833i1ztnghj7k9zkrvrw5e8ykd2bueemddgcygwci3q12u4fu07ivxm1i7tw50wog7n9mu1pirdj0cg188mbvdf4axxpgc98udh71kxnu9i56yrm207msqrtl0hj44mvoibt4nanvenr06hpq9h9tq",
"merchantUID": "string",
"branchUID": "string",
"pinCode": "string",
"clientBoxes": [
"https://pay.sensepass.com/c_EG9RW3DMJ4WDRF7KFN5A0ICSB0UU16"
]
}
New EMV terminal Creation
{
"apiKey": "a1b2c3d4e5f6g7h8",
"posName": "NewPosWithTerminal",
"emvTerminalType": "KCP"
}
EMV terminal creation response
{
"name": "NewPosWithTerminal",
"deviceAliasKey": "syi2vm59le3zf7r9og29ezz12xin95vxhewuzdhu0c4cqizeu9d3yvs8rhn60el4eqr4iq6qozrguyw7rgrgqiec6abb9ftygfhvvwl9ar833i1ztnghj7k9zkrvrw5e8ykd2bueemddgcygwci3q12u4fu07ivxm1i7tw50wog7n9mu1pirdj0cg188mbvdf4axxpgc98udh71kxnu9i56yrm207msqrtl0hj44mvoibt4nanvenr06hpq9h9tq",
"agentUUID": "xwj88sclyblma09lnu49857gn6iva2"
}
Last updated
Was this helpful?