Metadata stored for a token
PCI Booking offers its customers the ability to retrieve metadata information relating to a single token or multiple tokens - while still maintaining PCI compliance by not providing the full card details.
- In order to retrieve the metadata for a list of tokens (by reference), please use the Query Paycard method.
- In order to retrieve the metadata of a single token (by token ID), please use the Retrieve a Paycard Metadata method.
The metadata for a token - whether queried as part of a list or individually, will contain the following information:
Parameter Name | Parameter Type | Description |
---|---|---|
VirtualInfo | Object | Information provided if this token represents a virtual card. Please note, this value will only be returned when retrieving the metadata for a token that represents a virtual card. |
CreatorReference | String | The reference value which was provided during the tokenization process to locate this token. Please note, this value will only be returned when retrieving the metadata for an individual token. |
CreateDate | DateTime | The date and time that this token was created on. |
CardType | String | The type of card that was tokenized. If the card type was not specified during tokenization, this parameter will show unspecified . |
LastDigits | String | The last 4 digits of the card number. |
LeadingDigits | String | The first 6 digits of the card number. |
ExpirationYear | Integer | The year of the card's expiration date. |
ExpirationMonth | Integer | The month of the card's expiration date. |
OwnerID | String | The value provided in the owner ID field during tokenization. |
UserID | String | The username of the user that tokenized this card. |
IssueNumber | String | The value provided in the issue number field during tokenization. |
OwnerName | String | The name on the card as provided during tokenization. |
URI | String | The card URI in PCI Booking. You will need this value in order to perform any sort of action on this card. |
EndRetentionDate | Date Time | The date that the CVV retention period ends. |
CvvExists | Boolean | A boolean value indication if the CVV for this token still exists in PCI Booking. |
AssociatedMerchants | Array of String | An array of the user IDs of the merchants associated with this token. (read more at Associate Paycard with a PCI Booking Customer). |
AssociatedProperties | Array of String | An array of the property IDs of the properties associated with this token. (read more at Associate Paycard with a Property). |
ThreeDSecureInfo | Object | A set of parameters regarding the 3D Secure authentication of this card details. |
ThreeDSecureInfo .ThreeDSSessionID | String | The 3DS session ID (if 3DS was captured through the PCI Booking capture form) |
ThreeDSecureInfo .Indication | String | Indication whether the card was authenticated or rejected when performing 3DS authentication. |
ThreeDSecureInfo .AuthenticationValue | String | The 3DS authentication value A.K.A CAVV |
ThreeDSecureInfo .Eci | String | The 3DS authentication ECI value |
ThreeDSecureInfo .XID | String | The 3DS authentication XID or 3DSTransID (this value is based on which version of 3DS was used) |
ThreeDSecureInfo .Version | String | The 3DS authentication version which was used. |
ThreeDSecureInfo .MerchantName | String | The merchant name that was used for the 3DS authentication. |
Updated over 3 years ago