Skip to main content

P2PE Tokenize

This method accepts encrypted data from a POI device such as payment terminal, decrypts the data, and tokenizes the PAN. The token is returned in the response.

URI: https://test-api.tokenex.com/P2PEService.svc/REST/Tokenize

Request Parameters

ParameterTypeDescription
APIKeystringSee Authentication
TokenExIDstringYour TokenEx ID
EncryptedTrackstringThe encrypted Track 1 value from the device payload (location based on specific device)
EncryptionProfilestringThe encryption profile defined by TokenEx associated with keys loaded in the P2PE device

For test devices loaded with the ANSI standard test Triple DES key, this value will be 'test'.
KSNstringThe Key Serial Number from the device payload (location dependent on specific device)
RequestFormatEnumFormat of the data (e.g. Hex(xml: Hex, json: 2), Base64(xml:Base64,json: 1))
TokenSchemeEnumSee Standard Token Schemes
JSON
{
"APIKey": "YourAPIKey",
"TokenExID": "YourTokenExID",
"EncryptedTrack": "0x15489",
"EncryptionProfile": "test",
"KSN": "0x54865",
"RequestFormat": 2,
"TokenScheme": 1
}

Response Parameters

ParameterTypeDescription
TokenstringThe token as generated by TokenEx that references the sensitive data
SuccessboolIndicator if the result was successful or not
ReferenceNumberstringReference number for the TokenEx transaction
ErrorstringError Code and human-readable description
JSON
{
"Error": "",
"ReferenceNumber": "15102913382030662954",
"Success": true,
"Token": "545454587415454"
}