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.

Updated 6 months ago