Menu

Account Updater Completion Response

When you send an Account Updater request and the response file is complete, Worldpay returns the Account Updater Completion Response, providing you with updated customer account information including reason codes supplied by the network. You can use this information to update your stored customer account information as needed.

Typically, Worldpay generates this file five days after the merchant first submits their Account Updater batch request, which is described inAccount Updater Batch Request.

This section contains the following topics:

  • Account Updater Completion Response Format
  • See Account Updater Completion Response Codes

Account Updater Completion Response Format

The examples that follow show a tree structure view of an Account Updater acknowledgment response and an example response.cnpAPI Account Updater Elementsprovides definitions of each element and/or attribute.

If there was no change in the submitted card/token information, the system returns the original card or token information, but the response will not contain the updatedCard or updatedToken child elements.

Account Updater Completion Response XML Structure

Copied!
<cnpResponse  version= "11.2" response="0" message="Merchant Fiscal Day: 06102010" cnpSessionId="1700000128">
    <batchResponse  cnpBatchId="1700000136" merchantId="TestMerchant01">
        <accountUpdateResponse  id=”1234” reportGroup= "MerchantReportGroup01">
            <cnpTxnId > Transaction Id</cnpTxnId>
            <orderId >Order Id</orderId>
            <response > Response Code</response>
            <responseTime > Date and Time in GMT </responseTime>
            <message > Response Message</message>
            <originalCard >
                <type >Original Card Type</type>
                <number >Original Card Number</number>
                <expDate >Original Expiration Date</expDate>
            </originalCard>
            <updatedCard >
                <type >New Card Type</type>
                <number >New Card Number</number>
                <expDate >New Expiration Date</expDate>
            </updatedCard>
        </accountUpdateResponse>
            <accountUpdateResponse  id=”1235” reportGroup= "MerchantReportGroup01">
            <cnpTxnId> Transaction Id</cnpTxnId>
            <response> Response Code</response>
            <responseTime> Date and Time in GMT </responseTime>
            <message>Response Message</message>
            <originalToken>
                <cnpToken>Original Token Number</cnpToken>
                <expDate>Original Expiration Date</expDate>
                <type>Original Card Type</type>
                <bin>Original BIN</bin>
            </originalToken>
            <updatedToken>
                <cnpToken>New Token Number</cnpToken>
                <expDate>New Expiration Date</expDate>
                <type>New Card Type</type>
                <bin>Original BIN</bin>
            </updatedToken>
            </accountUpdateResponse>
    </batchResponse>
</cnpResponse>

Account Updater Completion Response

Copied!
<cnpRequest version="12.17 xmlns="http://www.vantivcnp.com/schema" id="requestId" numBatchRequests="2">
    <authentication>
         <user>TestOrg</user>
        <password>TestOrgPassword</password>
    </authentication>
    <batchRequest id="batchId" numAccountUpdates="02" merchantId="TestMerchant01">
        <accountUpdate id="1234" reportGroup="Merch01ReportGrp">
            <orderId>MERCH01-0001</orderId>
            <card>
                <type>MC</type>
                <number>5151102088487202</number>
                <expDate>1110</expDate>
            </card>
        </accountUpdate>
        <accountUpdate id="1235" reportGroup="Merch01ReportGrp">
            <orderId>MERCH01-0003</orderId>
            <card>
                <type>VI</type>
                <number>4271125020000039</number>
                <expDate>1211</expDate>
            </card>
        </accountUpdate>
    </batchRequest>
    <batchRequest id="batchId" numAccountUpdates="01" merchantId="TestMerchant02">
    <accountUpdate id="1256" reportGroup="Merch02ReportGrp">
        <orderId>MERCH02-0001</orderId>
        <token>
            <cnpToken>1712990000047202</cnpToken>
            <expDate>1110</expDate>
            <authenticatedShopperId>Shopper_Id_value</authenticatedShopperId>
        </token>
    </accountUpdate>
    </batchRequest>
</cnpRequest>

The example above shows both card and token response information to illustrate the xml structures. In practice, you would not receive both token and card information in a response. If you are not using the Vault, you receive only card information; if you are using the Vault, you receive only token information.

Account Updater Completion Response Codes

The Account Updater completion response code and its associated message (as shown inAccount Updater Completion Response Codesspecify whether or not an account number has been changed and what type of change occurred, if any.

  • The Response Code value appears in the<response> element.
  • The Response Message value appears in the <message> element.
  • The Resolution column provides a recommended action.

Response Codes

Response CodeResponse MessageResolution
191The merchant is not registered in the update programEscalate this to your Customer Experience Manager. This indicates a set-up problem that must be resolved prior to submitting another request file.
500The account number was changedSubmit the account number returned in the completion response.

Note: The response may also indicate that both the account number and expiration date changed.

501The account was closedContact the cardholder for updated information.
502The expiration date was changedSubmit the expiration date returned in the completion response.
503The issuing bank does not participate in the update program.The Issuer does not participate in the Account Updater program. Submit original card information.
504Contact the cardholder for updated informationContact the cardholder for updated information
505No match foundThere was no match found in the updated information. Submit the original card information
506No changes foundSubmit the original card information

cnpAPI Account Updater Elements

This chapter provides definitions for the elements and attributes used in cnpAPI associated with the Account Updater service. You should use this information in combination with the various cnpAPI schema files to assist you as you build the code necessary to submit Account Updater transactions to our systems. Each section defines a particular element, its relationship to other elements (parents and children), as well as any attributes associated with the element.

For additional information on the structure of cnpAPI requests and responses using these elements, as well as cnpAPI examples, please refer toAccount Updater cnpAPI Examples.

The XML elements defined in this chapter are listed alphabetically.