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
gpsIDGPS Issuer (Program Manager) Code. Assigned by GPS.
indexVisa device index (Func 01 only).
gpsStatusDevice status on the GPS 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.