Manage

Get full control and interact with your tokens stored in our vault

Please note that the token management API is only working with the latest Alias 2.0 format. Reach out to your PCI Proxy contact if you are not sure which alias format you are using.

The service requires HTTP basic authentication. The required credentials can be found in our dashboard. Please refer to API authentication data for more information.

post
CONVERT

https://api.sandbox.datatrans.com/v1/aliases
Convert a legacy (numeric or masked format) token to the most recent token format.
Request
Response
Request
Headers
Authorization
required
string
Basic MTAwMDAxMTAxMTpYMWVXNmkjJA==
Content-Type
required
string
application/json; charset=UTF-8
Body Parameters
legacyAlias
required
string
Legacy token format (numeric or masked)
Response
200: OK
Returns converted alias v2
{
"alias": "AAABdJdXVGPssdexyrAAAbuFU885AFAk"
}
400: Bad Request
Invalid request
{
"error": {
"code": "INVALID_ALIAS"
}
}

Examples

Request
Response
Request
curl -i -X POST https://api.sandbox.datatrans.com/v1/aliases \
--user {merchantId}:{password} \
-H 'Content-Type: application/json; charset=UTF-8' \
-d '{
"legacyAlias": "424242SKMPRI4242"
}'
Response
{
"alias": "AAABdJdXVGPssdexyrAAAbuFU885AFAk"
}

delete
DELETE

https://api.sandbox.datatrans.com/v1/aliases/{alias}
Delete a token with immediate effect. The token will no longer be recognized if used later with any API call.
Request
Response
Request
Path Parameters
alias
required
string
Alias which should be deleted
Headers
Authorization
required
string
Basic MTAwMDAxMTAxMTpYMWVXNmkjJA==
Content-Type
required
string
application/json; charset=UTF-8
Response
204: No Content
Alias successful deleted
400: Bad Request
Invalid request
{
"error": {
"code": "ALIAS_NOT_FOUND"
}
}

Examples

Request
Response
Request
curl -i -X DELETE https://api.sandbox.datatrans.com/v1/aliases/AAABdJdXjl7ssdexyrAAAZleH7dSANH- \
--user {merchantId}:{password} \
Response
204: No Content