CalculateTAV
Return the TAV (Token Authentication Value) of the specified card. The Token Authentication Value will be returned in Base64 format.
Request
Path parameters
string, 10 characters, required
The Paymentology issued terminal ID of the terminal requesting the transaction
string, 1-255 characters, required
The user defined reference to the card; for example a member id or wallet number
string, 1-20 characters, required
The card identifier may be one of the following:
• Tracking number
• Card Number
Optional, but recommended when a reference can
have multiple cards associated
string, 1-255 characters, required
a unique identifier generated by the client, which must not be duplicated over time.
date, required
Transaction date generated by the calling
client
string, required
HMAC-SHA256 hashed signature of the concatenated method name with all argument values using the terminal password as private key
<methodCall>
<methodName>CalculateTAV</methodName>
<params>
<param>
<value>
<string>0084575617</string>
</value>
</param>
<param>
<value>
<string>701a7c3eda8b477388dfbfed277f1d80</string>
</value>
</param>
<param>
<value>
<string>124472200021642</string>
</value>
</param>
<param>
<value>
<string>1a0943a862bf4d7f8c69f75ccedd716f</string>
</value>
</param>
<param>
<value><dateTime.iso8601>20220915T16:18:53</dateTime.iso8601></value>
</param>
<param>
<value>
<string>74CCECB2260F05A28B3981B6675104EC2FFC5BE5AA6334FE91F9B352643353CE</string>
</value>
</param>
</params>
</methodCall>
Response
STATUS200 OK
Schema
string
JSON fields encoded in Base-64 format.
The returned JSON fields include:
• version
• signatureAlgorithm
• dataValidUntilTimestamp
• includedFieldsInOrder
• signature (RSA-SHA256 signature/
TAV)
integer
Status code indicating transaction result. In the event of a successful result the code will be 1.
<?xml version="1.0" encoding="UTF-8"?>
<methodResponse>
<params>
<param>
<value>
<struct>
<member>
<name>resultCode</name>
<value>
<int>1</int>
</value>
</member>
<member>
<name>resultText</name>
<value>
<string>Approved</string>
</value>
</member>
<member>
<name>tav</name>
<value> <string>eyJpbmNsdWRlZEZpZWxkc0luT3JkZXIiOiJkYXRhVmFsaWRVbnRpbFRpbWVzdGFtcHxhY2NvdW50TnVtYmVyfGFjY291bnRFeHBpcnkiLCJkYXRhVmFsaWRVbnRpbFRpbWVzdGFtcCI6IjIwMjItMDktMTZUMDg6MTg6NTRaIiwidmVyc2lvbiI6IjMiLCJzaWduYXR1cmVBbGdvcml0aG0iOiJSU0EtU0hBMjU2Iiwic2lnbmF0dXJlIjoiT0xrc0lTZVdPNWljMWVWa0RlZW9FZDdxRkp3eXVucUl5bjRoRTlzMnd6NXMrcVJ2TVRhNDJicjllbUZDZ3ZuN1Q5Ly9xL1FFOFUvQkI1SmdOdE1FL1JiVmJHaVJlV0ZLOTRoaHJIUkd4ZlgwbWVSU1BPS1U0UnNKdks2MXhwUVV1ZS85V2ZZYWVkNW04cGFENDZXUzBuenNoenU4c09uRnU2dVZMRm9vQWpZM21sNjdZcnRRc2dYZDl3cFArVWpNN21PeDNNT3dyWFQ2YzBmcmZVSHZlNzlNQkEvV2ZiR1d3TjRqbFl6SkhicjF0ZzJaMmM2NXUvTGZCemsxOGpBcnBRWG9Nd1M3OFFkSUJTaXp6MXA0WFlMY0FVQkhmWWthOWlvU3RTUzBRUlA1TFNEN2RsdnZWSXo0TjVMc1M4RklBS1NXM1Z3cG5DUTVidTdlVzViOVZ3PT0ifQ==</string>
</value>
</member>
</struct>
</value>
</param>
</params>
</methodResponse>
Was this page helpful?