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:

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

Request

  • Base URL
    https://gw-pci.pismolabs.io/cards-tokenization
  • URL
    https://gw-pci.pismolabs.io/cards-tokenization/v1/cards/{cardId}/network-tokens/{tokenId}/devices/{deviceId}/binding
  • Auth
    HTTP bearer

Path parameters

cardIdstring required

Pismo 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.

operation_reason'FRAUD' | 'LOST_CARD' | 'STOLEN_CARD' | 'LOST_DEVICE' | 'STOLEN_DEVICE' | 'CUSTOMER_REQUEST' | 'CLOSED' | 'FOUND_DEVICE' required

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?

Changes

No recorded changes to this operation across all 1 revision of this API.