The Alias Gateway allows you to pass credit card data directly to the PCI Proxy vault to create tokens. This can be interesting if you want to migrate existing credit card data that is currently stored somewhere else to store it within the PCI Proxy vault.
<alias>
elements, so it is possible to tokenize a card and a cvv at the same time. <?xml version='1.0' encoding='UTF-8'?><aliasCCService version="1"><body merchantId="1000011011" status="accepted"><alias aliasStatus="response"><request><cardno>375811111111115</cardno></request><response><aliasCC>375811OMTYEE115</aliasCC><cardno>375811111111115</cardno><maskedCC>375811xxxxx1115</maskedCC></response></alias><alias aliasStatus="response"><request><cvv>123</cvv></request><response><aliasCVV>EicQYIP6QA69Or_6DqBOLNQf</aliasCVV><uppCvvExpiryDate>2017-03-28</uppCvvExpiryDate></response></alias></body></aliasCCService>
<?xml version='1.0' encoding='UTF-8'?><aliasCCService version="1"><body merchantId="1000011011" status="accepted"><alias aliasStatus="error"><request><cardno>000</cardno></request><error><errorCode>1004</errorCode><errorMessage>CC number is not valid</errorMessage><errorDetail>check modulo-10 failed</errorDetail></error></alias><alias aliasStatus="error"><request><cvv>a</cvv></request><error><errorCode>2022</errorCode><errorMessage>invalid value</errorMessage><errorDetail>cvv</errorDetail></error></alias></body></aliasCCService>
XSD schema | ​https://api.sandbox.datatrans.com/upp/schema/aliasCC.xsd​ |
The service requires HTTP basic authentication. The required credentials can be found in our dashboard. Please refer to API authentication data for more information.
curl "https://api.sandbox.datatrans.com/upp/jsp/XML_AliasGateway.jsp" \-H "Content-Type: text/xml" \-d '<?xml version="1.0" encoding="UTF-8"?><aliasCCService version="1"><body merchantId="1000011011"><alias><request><cardno>375811111111115</cardno></request></alias><alias><request><cvv>123</cvv></request></alias></body></aliasCCService>'
<?xml version='1.0' encoding='UTF-8'?><aliasCCService version="1"><body merchantId="1000011011" status="accepted"><alias aliasStatus="response"><request><cardno>375811111111115</cardno></request><response><aliasCC>AAABcqOEyhvssdexyrAAAVYhoiJyALi2</aliasCC><cardno>375811111111115</cardno><maskedCC>375811xxxxx1115</maskedCC></response></alias><alias aliasStatus="response"><request><cvv>123</cvv></request><response><aliasCVV>EicQYIP6QA69Or_6DqBOLNQf</aliasCVV><uppCvvExpiryDate>2017-03-28</uppCvvExpiryDate></response></alias></body></aliasCCService>
curl "https://api.sandbox.datatrans.com/upp/jsp/XML_AliasGateway.jsp" \-H "Content-Type: text/xml" \-d '<?xml version="1.0" encoding="UTF-8"?><aliasCCService version="1"><body merchantId="1000011011"><alias><request><cardno>000</cardno></request></alias><alias><request><cvv>a</cvv></request></alias></body></aliasCCService>'
<?xml version='1.0' encoding='UTF-8'?><aliasCCService version="1"><body merchantId="1000011011" status="accepted"><alias aliasStatus="error"><request><cardno>000</cardno></request><error><errorCode>1004</errorCode><errorMessage>CC number is not valid</errorMessage><errorDetail>check modulo-10 failed</errorDetail></error></alias><alias aliasStatus="error"><request><cvv>a</cvv></request><error><errorCode>2022</errorCode><errorMessage>invalid value</errorMessage><errorDetail>cvv</errorDetail></error></alias></body></aliasCCService>
In test mode, only test credit cards are allowed.
errorCode | errorMessage | Explanation |
1004 | CC number not valid | Luhn check failed |
2000 | access denied | XML alias service not enabled by Datatrans |
2001 | no input document | Request body does not contain XML payload |
2002 | error building document | Wrong XML payload in request |
2011 | root element invalid | Root element is not |
2012 | body element missing |
|
2013 | merchantId missing |
|
2014 | element missing | Element is missing. For example |
2022 | invalid value | Invalid value passed for an attribute. (e.g. |
-889 | CC-alias error | Input paramter(s) missing. For example |
​