Update Card Validation Number Transactions

When you submit the CVV2/CVC2/CID in a registerTokenRequest, the platform encrypts and stores the value on a temporary basis for later use in a tokenized Auth/Sale transaction submitted without the value. This is done to accommodate merchant systems/workflows where the security code is available at the time of token registration, but not at the time of the Auth/Sale. If for some reason you need to change the value of the security code supplied at the time of the token registration, use an updateCardValidationNumOntoken transaction.

You should only use this transaction type if you had previously submitted the account number and security code in a registerTokenRequest transaction and now need to change the CVV2/CVC2/CID value.

Update Card Validation Number Request

The updateCardValidationNumOnToken transaction has the following structure:

<updateCardValidationNumOnToken id = "Update Id" customerId="Customer Id" reportGroup="iQ Report Group">

  <orderId>Order Id</orderId>

  <cnpToken>Token</cnpToken>

  <cardValidationNum>CVV2/CVC2/CID Value</cardValidationNum>

</updateCardValidationNumOnToken>

Example: Online Update Card Validation Number Request

<cnpOnlineRequest version="12.0" xmlns="http://www.vantivcnp.com/schema" merchantId="100">

  <updateCardValidationNumOnToken id="99999" customerId="444" reportGroup="RG1">

    <orderId>F12345</orderId>

    <cnpToken>1111000101039449</cnpToken>

    <cardValidationNum>987</cardValidationNum>

  </updateCardValidationNumOnToken>

</cnpOnlineRequest>

Update Card Validation Number Response

The updateCardValidationNumOnTokenResponse transaction has the following structure:

<updateCardValidationNumOnTokenRespone id="Update Id" reportGroup="iQ Report Group">

  <cnpTxnId>Transaction Id</cnpTxnId>

  <response>Response Code</response>

  <message>Response Message</message>

  <responseTime>Date and Time in GMT</responseTime>

</updateCardValidationNumOnTokenResponse>

Example:  Online Update Card Validation Number Response

<cnpOnlineResponse version="12.0" xmlns="http://www.vantivcnp.com/schema" response="0" message="Valid Format">

  <updateCardValidationNumOnTokenResponse id="99999" customerId="444" reportGroup="RG1">

    <cnpTxnId>21122700</cnpTxnId>

    <response>803</response>

    <message>Card Validation Number Updated</message>

    <responseTime>2017-06-09T17:21:51</responseTime>

  </updateCardValidationNumOnTokenResponse>

</cnpOnlineResponse>