v1

latestOpenAPI 3.1.0Copyright Pismo2026-07-247702,7523.1 MB

Token lifecycle

Bind Visa device and token

Executes Visa device binding for a given token and device. Device binding establishes that a specific device belongs to a specific cardholder. Once bound, the device can be trusted more in future transactions.

An issuer can use this endpoint to update the status of a specific device linked to a token.

Notes:

This is a PCI endpoint, use the https://gw-pci.pismolabs.io/cards-tokenization environment.
This endpoint takes an account token - an access token encoded with a Pismo account ID

post/v1/cards/{cardId}/network-tokens/{tokenId}/devices/{deviceId}/binding

Path parameters

cardIdstring required

Card ID

tokenIdstring required

Token ID

deviceIdstring required

Device ID (wallet device ID)

Request body

operator_idstring required

Client-generated ID for person or system performing the operation. This is for client monitoring and internal record-keeping.

operation_type'TOKEN_DEVICE_BINDING_REMOVE' | 'TOKEN_DEVICE_BINDING_APPROVE' | 'TOKEN_DEVICE_BINDING_APPROVE_BANK_APP' | 'TOKEN_DEVICE_BINDING_APPROVE_CALL_CENTER' required

Visa device binding lifecycle operation type.

Visa lifecycle operation reason.

activation_codestring

Activation code REQUIRED when operation_type = TOKEN_DEVICE_BINDING_APPROVE_CALL_CENTER.

device_indexinteger required

Visa index number for device ID.

Example request

{
  "device_index": 99
}

Response

Operation successfully executed.

network_ackboolean

Was the network operation acknowledged?