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
Parameter | Type | Description |
---|---|---|
APIKey | string | See Authentication |
TokenExID | string | Your TokenEx ID |
EncryptedTrack | string | The encrypted Track 1 value from the device payload (location based on specific device) |
EncryptionProfile | string | The 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'. |
KSN | string | The Key Serial Number from the device payload (location dependent on specific device) |
RequestFormat | Enum | Format of the data (e.g. Hex(xml: Hex, json: 2), Base64(xml:Base64,json: 1)) |
TokenScheme | Enum | See Standard Token Schemes |
JSON
{
"APIKey": "YourAPIKey",
"TokenExID": "YourTokenExID",
"EncryptedTrack": "0x15489",
"EncryptionProfile": "test",
"KSN": "0x54865",
"RequestFormat": 2,
"TokenScheme": 1
}
Response Parameters
Parameter | Type | Description |
---|---|---|
Token | string | The token as generated by TokenEx that references the sensitive data |
Success | bool | Indicator if the result was successful or not |
ReferenceNumber | string | Reference number for the TokenEx transaction |
Error | string | Error Code and human-readable description |
JSON
{
"Error": "",
"ReferenceNumber": "15102913382030662954",
"Success": true,
"Token": "545454587415454"
}