On This Page
FILTER BY TAG
pilot

Step 1: Create a device

This section describes how to create a device.

Endpoint

Test:
POST
https://apitest.cybersource.com
/tms/v2/devices
Production:
POST
https://api.cybersource.com
/tms/v2/devices
Production in India:
POST
https://api.in.cybersource.com
/tms/v2/devices
Production in Saudi Arabia:
POST
https://api.sa.cybersource.com
/tms/v2/devices
Test in Saudi Arabia:
POST
https://apitest.sa.cybersource.com
/tms/v2/devices

REST Example: Creating a Device

Request
{
  "clientDeviceID": "<CLIENT_DEVICE_ID>",
  "clientDeviceName": "U0lUIERldmljZSBqV0JW",
  "category": "PHONE",
  "manufacturer": "Apple",
  "brand": "iPhone",
  "model": "iPhone 15 Pro Max",
  "operatingSystem": {
    "type": "IOS",
    "version": "26.1",
    "buildId": "23B5044I"
  },
  "certificates": [
    {
      "usage": "SIGNATURE",
      "format": "X509_PEM",
      "value": "<DEVICE_CERTIFICATE>"
    },
    {
      "usage": "ENCRYPTION",
      "format": "X509_PEM",
      "value": "<DEVICE_CERTIFICATE>"
    }
  ]
}
Response to a Successful Request
A successful delete response returns an empty
HTTP 204 No Content
 status.
Response to a Successful Request
{
    "errors": [
        {
            "type": "forbidden",
            "message": "Request not permitted"
        }
    ]
}
RELATED TO THIS PAGE