Tokenize With CVV
This endpoint allows you to simultaneously tokenize a data element and associate a CVV with its generated token.
Endpoints
| Environment | URL |
|---|---|
| Test | https://test-htp.tokenex.com/api/sdk/TokenizeWithCVV |
API Parameters
| Parameter | Data Type | Description |
|---|---|---|
| TokenExID | string | The merchant's TokenEx ID. |
| Timestamp | string | The timestamp (UTC) when the hash is generated, in yyyyMMddHHmmss format. |
| AuthenticationKey | string | The Authentication Key generated on the merchant's server. |
| Data | string | The data to be tokenized. |
| TokenScheme | enum | The Token Scheme to be used to tokenize the provided data. See Universal Token Schemes. |
| CVV | string | The CVV to be associated with the generated Token. |
| UseExtendedBIN | bool | Optional parameter: Allows for 8 digit BIN to be returned in the tokenize response (Only available for PCI token scheme). Defaults to false. |
Request
{
"tokenexid": "YourTokenExID",
"timestamp": "20180109161437",
"authenticationKey": "3mHJFag1ICQiwRdSw1QY86WUvt3IDklswf6AA/q+wdU=",
"data": "5454545454545454",
"tokenScheme": "sixTOKENfour",
"cvv": "123",
"useExtendedBin": false
}
Response
- Response
- UseExtendedBIN:true
{
"Error": null,
"Success": true,
"ReferenceNumber": "18010916143712345678",
"Token": "545454587415454",
"TokenHMAC": "QiuCu0FZuu0SUn2gMtRYQSHjkd30LgSf4QMM3yH1Dp0="
}
{
"Error": null,
"Success": true,
"ReferenceNumber": "18010916143712345678",
"Token": "545454587415454",
"TokenHMAC": "QiuCu0FZuu0SUn2gMtRYQSHjkd30LgSf4QMM3yH1Dp0=",
"FirstEight": "54545454"
}