v1

latestOpenAPI 3.0.02026-07-2352269214.0 KB

Request to provide the next list of commands to be executed on a device

This method is used by TSH to request the pending commands to be executed on a device.</br> It is used for reading/updating the content of a device (e.g. topup).</br> The TES has to return the list of commands that needs to be executed on the device after checking the previous commands responses.</br>

post/getCardCommands

Headers

x-actor-idstring required

HTTP header identifying the actor initiating the request.

Request body

issuerIdstring required

cardIdstring required

Unique identifier of the card.

purchaseIdstring

The Purchase Identifier. Unique for each purchase.<br/> It is provided when the call is related to topup initiated from wallet.

deviceIdstring required

The Device Identifier. Unique for each device.

The operation for which the commands are requested

responseTimeMsnumber double

Total time of all executed commands listed in responses array in milliseconds.

statusCodenumber

Status code to the request

Status code	Description
0	OK
111	Missing mandatory parameter
112	Bad parameter format
113	Unknown issuer
117	Unknown device
118	Unknown session
119	Unknown virtual card
159	Card is blacklisted
160	Card is deleted
162	Card has unsufficient balance
163	Card product not eligible
167	Card is already provisioned
172	Invalid card, unsupported system code
173	Invalid card, unsupported service
177	Invalid card, invalid area data
178	Invalid card, card status is in-station
191	Card is expired
192	Reader mode attempt exceeded allowed threshold
221	Device or wallet server not accessible
231	Device unexpected error
232	Device out of memory error
321	Operation already on-going for this device
322	Time to live of the operation expired
323	Operation incomplete
911	Operation failed
921	Unexpected server error

statusMessagestring

Textual status message

Response

getCardCommands response payload