Detokenization and Tokenization Integration

To begin using this service, you simply need to make a few modifications to the code that is constructing your HTTPS POST to the 3rd-party endpoint.

  1. Update the URL to POST to TokenEx
  2. Add HTTP Header for the intended URL
    • TX_URL
  3. Add your Authentication Headers
    • TX_TokenExID
    • TX_APIKey
  4. Add an HTTP Header to locate the sensitive data within the response to be tokenized using a regular expression
    • TX_ResponseField
  5. Add an HTTP header to apply a token scheme to the data located in the response to be tokenized
    • TX_TokenScheme
  6. Wrap the field in the HTTP Body with three curly braces
    • example: {{{424242XXXXXX4242}}}

HTTP Request Headers

HeaderDescription
TX_TokenExIDYour TokenExID
TX_APIKeyYour API key
TX_URLThe endpoint URL to which TokenEx should POST the detokenized request
TX_ResponseFieldA regular expression to locate the data element in the response to be tokenized
TX_TokenSchemesee Token Schemes
TX_Headers(Optional) Comma-separated list of desired headers received from the endpoint

HTTP Response Headers

HeaderDescription
tx_MessageInformational message about the request. Number of possible matches based on Regular Expression, etc.
tx_tokenize_error_xxxxReports any error in tokenization
tx_thirdpartystatuscodeThe status code received from the third party defined in the tx-url request header
tx_tokenexstatuscodeThe status code for the request to TokenEx