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.

FieldDescription
gpsIDThredd Issuer (Program Manager) Code. Assigned by Thredd.
indexVisa device index (Func 01 only).
gpsStatusDevice 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
paymentSchemeStatusDevice 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
bindDateDate/Time (in GMT) initial binding message is received.
statusDateDate/Time binding last changed.
deviceIDUnique ID of the secure element in the device.

👍

API Explorer

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