latestOpenAPI 3.0.12026-08-10122864.6 KB

15f03804be72

Card token servicing

Retrieve a card's assigned tokens

Returns an array of all Visa tokens assigned to the card specified in the request URL.

get/v1/cards/{card_id}/visa_tokens

Path parameters

card_idstring required

The ID of the card to which the token is assigned.

Query parameters

filter[visa_token_number]string

Filters by visa_token_number

page[number]integer

Page number

page[size]integer

Page size

Response

Successful result of the operation

token_reference_idstring

The unique reference ID of the token to be retrieved.

visa_token_numberstring

The number of the Visa token.

pan_referencestring

Information about the Primary Account Number (PAN) reference.

wallet_type'APPLE' | 'GOOGLE' | 'SAMSUNG'

The type of the wallet.

status'ACTIVE' | 'DEACTIVATED' | 'INACTIVE' | 'SUSPENDED'

The status of the token.

device_idstring

The ID of the bound device associated with the token.

pan_source'KEY_ENTERED' | 'ON_FILE' | 'MOBILE_BANKING_APP' | 'TOKEN' | 'CHIP_DIP' | 'CONTACTLESS_TAP'

The source of the PAN.

created_atstring

The date the token was created. (ISO8601 format)

Example response

[
  {
    "token_reference_id": "DNITHE382228352676336613",
    "visa_token_number": "4111112380202020",
    "pan_reference": "V-3010101010363935797827",
    "wallet_type": "APPLE",
    "status": "ACTIVE",
    "device_id": "dfg5748s-b26b-2020-9ee0-94f0001189830",
    "pan_source": "MOBILE_BANKING_APP",
    "created_at": "2022-09-19T01:31:26.695Z"
  },
  {
    "token_reference_id": "DNITHE382201010676336612",
    "visa_token_number": "4636632389470002",
    "pan_reference": "V-3019278256560935797827",
    "wallet_type": "GOOGLE",
    "status": "INACTIVE",
    "device_id": "d3768ef3-b166-2299-9ee0-994949184830",
    "pan_source": "MOBILE_BANKING_APP",
    "created_at": "2022-09-19T07:31:26.695Z"
  }
]