Get Card Payment Token Devices

The Get Card Payment Token Devices endpoint enables you to retrieve a list of devices associated with a payment token. You can retrieve the details by making a GET request to the Payment Token Devices endpoint. For example:

{{base-url}}/cards/{{publicToken}}/payment-tokens/{{token-id}}/devices

A successful response will return an HTTP 200 response code. Below is an example response:

[
    {
        "gpsID": 18,
        "index": 1,
        "gpsStatus": "A",
        "paymentSchemeStatus": "A",
        "bindDate": "31/12/2025 00:00:00",
        "statusDate": "11/12/2028 00:00:00",
        "deviceID": "ABC"
    }
]

The following table describes each of the fields included in the response.

Field

Description

gpsID

Thredd Issuer (Program Manager) Code. Assigned by Thredd.

index

Visa device index (Func 01 only).

gpsStatus

Device status on the Thredd system. Options include:

  • A = Active
  • D = Deleted (once in this status, it is normally never changed)
  • I = Inactive
  • N = Not Tokenised
  • P = Pending
  • S = Suspended
  • U = Unknown
  • X = Deactivated

paymentSchemeStatus

Device status on the Payment Network. Options include:

  • A = Active
  • D = Deleted (once in this status, it is normally never changed)
  • I = Inactive
  • N = Not Tokenised
  • P = Pending
  • S = Suspended
  • U = Unknown
  • X = Deactivated

bindDate

Date/Time (in GMT) initial binding message is received.

statusDate

Date/Time binding last changed.

deviceID

Unique ID of the secure element in the device.

👍

API Explorer

See the Get a list of Card Payment Token Devices endpoint.