CalculateTAV

This API is used to create Token Authentication value (TAV)

Request Path Parameters

Parameter	type	Limits	required	Description
terminalID	String	10 characters	✓	The Paymentology issued terminal id of the terminal requesting the transaction
customerReference	String	1-255 characters	✓	Customer reference linked with this card
trackingNumber	String	1-20 characters	✓	Tracking number that identifies the card to be returned
transactionID	String	1-255 characters	✓	A unique identifier generated by the client, which must not be duplicated over time.
transactionDate	Date		✓	Transaction date generated by the calling client
checksum	String	1-255 characters	✓	HMAC-SHA256 hashed signature of the concatenated method name with all argument values using the terminal password as private key

<?xml version="1.0" encoding="UTF-8"?>
<methodCall>
    <methodName>CalculateTAV</methodName>
    <params>
        <param>
            <value>
                <string>{{terminalID}}</string>
            </value>
        </param>
        <param>
            <value>
                <string>{{customerReference}}</string>
            </value>
        </param>
        <param>
            <value>
                <string>{{trackingNumber}}</string>
            </value>
        </param>
        <param>
            <value>
                <string>{{transactionID}}</string>
            </value>
        </param>
        <param>
            <value>
                <dateTime.iso8601>{{transactionDate}}</dateTime.iso8601>
            </value>
        </param>
        <param>
            <value>
                <string>{{checksum}}</string>
            </value>
        </param>
    </params>
</methodCall>

``````xml
<?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>tav</string>
                        </value>
                    </member>
                </struct>
            </value>
        </param>
    </params>
</methodResponse>

Response Parameters

Field	type	Description
resultCode	Integer	Status code indicating transaction result. In the event of a successful result the code will be 1.
resultText	String	Text indicating transaction result
tav	String	JSON fields encoded in Base-64 format.; The returned JSON fields include:; • version; • signatureAlgorithm; • dataValidUntilTimestamp; • includedFieldsInOrder; • signature (RSA-SHA256 signature/; TAV)