UpdateCVV

Generate a new CVV2 of the specified card.

Request Path Parameters

ParametertypeLimitsrequiredDescription
terminalIDString10 characters✓The Paymentology issued terminal id of the terminal requesting the transaction
referenceString1-255 characters✓The user defined reference to the card; for example a member id or wallet number
cardIdentifierString1-20 characters✓The card number, sequence number or tracking number of the specified card
transactionIDString1-255 characters✓A unique identifier generated by the client, which must not be duplicated over time.
transactionDateDate✓Client generated / local Transaction Date to assist in identifying transactions on the client side
checksumString✓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>UpdateCVV</methodName>
    <params>
        <param>
            <value>
                <string>0014770292</string>
            </value>
        </param>
        <param>
            <value>
                <string>TEST</string>
            </value>
        </param>
        <param>
            <value>
                <string>558558400041720</string>
            </value>
        </param>
        <param>
            <value>
                <string>123456</string>
            </value>
        </param>
        <param>
            <value>
                <dateTime.iso8601>20211019T10:00:00</dateTime.iso8601>
            </value>
        </param>
        <param>
            <value>
                <string>EA4CBE0812916006F30FFBD57DEFB4F1CC3F2A3319E89158816142741B3E57CE</string>
            </value>
        </param>
    </params>
</methodCall>

Response Parameters

FieldtypeDescription
resultCodeIntegerStatus code indicating transaction result
<?xml version="1.0" encoding="UTF-8"?>
<methodResponse>
    <params>
        <param>
            <value>
                <struct>
                    <member>
                        <name>clientTransactionID</name>
                        <value>
                            <string>123456</string>
                        </value>
                    </member>
                    <member>
                        <name>cvv2</name>
                        <value>
                            <int>312</int>
                        </value>
                    </member>
                    <member>
                        <name>resultCode</name>
                        <value>
                            <int>1</int>
                        </value>
                    </member>
                    <member>
                        <name>terminalID</name>
                        <value>
                            <string>0014770292</string>
                        </value>
                    </member>
                    <member>
                        <name>customerReference</name>
                        <value>
                            <string>TEST</string>
                        </value>
                    </member>
                    <member>
                        <name>resultText</name>
                        <value>
                            <string>Approved</string>
                        </value>
                    </member>
                    <member>
                        <name>serverTransactionID</name>
                        <value>
                            <string>21FC8A60-9D7D-21DF-52631CB471B8B87D</string>
                        </value>
                    </member>
                    <member>
                        <name>trackingNumber</name>
                        <value>
                            <string>558558400041720</string>
                        </value>
                    </member>
                </struct>
            </value>
        </param>
    </params>
</methodResponse>