Skip to main content

Get Asset

This method is used to retrieve card assets such as card imagery, issuer icon, etc. These assets are identified by GUIDs returned from a call to GetCardMetadata.

Required API Key Permissions: NetworkTokenizationGeneralAccess

Request Headers: Authentication and Authorization* denotes a required field

HTTP Request HeaderDescription
tx-tokenex-id*Like a username, this ID logically segments your tokenized data.
tx-apikey*Controls your access to individual function in the API

Request Body Parameters:

ParameterTypeDescription
tokenstringThe TokenEx token that represents the PAN and has an associated network token.
assetGuidstringThe GUID which represents a card asset.

Response Body Parameters:

ParameterTypeDescription
successboolIndicator if the request was successfully processed by TokenEx.
referenceNumberstringTokenEx reference number for the transaction.
errorstringTokenEx Error Code and human readable description.
messagestringHuman readable message about response from TokenEx.
networkResponse.contentTypestring enumThe type of asset. Possible values: CARD_ART_FOREGROUND, CARD_ART_BACKGROUND, ICON_ISSUER, TERMS_AND_CONDITIONS, COMBINED_BACKGROUND, ICON_PAYMENT_NETWORK, ICON_COBRAND, ICON_CARD.
networkResponse.messageIdstringUnique message identifier (GUID format) of this command.
networkResponse.conversationIdstringMessage identifier assigned for the entire conversation (GUID format). Typically, it is generated by the initiator of the flow.
networkResponse.statusCodestringThe four-digit status code.
networkResponse.statusMessagestringHuman readable comments about the status.
networkResponse.contentMimes[].typestring enumThe MIME type of the content. Possible values: IMAGE/PNG, IMAGE/JPEG, IMAGE/PDF, IMAGE/SVG+XML, TEXT/HTML, TEXT/PLAIN, APPLICATION/PDF, TEXT/XML
networkResponse.contentMimes[].assetObjectBase64 encoded stringThe value of asset object.
POST /v2/NetworkToken/GetAsset HTTP/1.1
Host: test-api.tokenex.com
tx-apikey: YourAPIKey
tx-tokenex-id: YourTokenExID
Content-Type: application/json

{
"AssetGuid": "ff46730d-0288-4d96-aaf7-e6352a726118",
"Token": "476120FDallZ7718"
}