Menu

Account Updater Batch Request

To begin the Account Updater process, you need to submit an Account Updater batch request. As shown in the examples below, the parent element is <cnpRequest>. This element has several attributes and contains the <authenticaton> and <batchRequest>child elements. The <batchRequest> element contains the submitted card or token information as children of the <accountUpdate> element.cnpAPI Account Updater Elementsprovides definitions of each element and/or attribute.

Account Updater Request XML Structure

You must use the following structure when submitting an Account Updater request. As shown, you can submit the request using either card information or token information.

Copied!
<cnpRequest  version="12.0" xmlns="http://www.vantiv.cnp.com/schema&quot; id="requestId" numBatchRequests="1">
 <authentication>
     <user>userName</user>
     <password>password</password>
 </authentication>
 <batchRequest  id="batchId" numAccountUpdates="2" merchantId="testMerchant01">
     <accountUpdate  id=”1234” reportGroup"merchant01ReportGrpoup">
     <orderId >Order Id</orderId>
     <card>
         <type>Card Type</type>
         <number>Card Number</number>
         <expDate>Card Expiration Date</expDate>
     </card>
     </accountUpdate>
     <accountUpdate id=”1235” reportGroup="merchant01ReportGrpoup">
         <orderId>Order Id</orderId>
         <token>
             <cnpToken >Token Number</cnpToken>
             <expDate>Card Expiration Date</expDate>
         </token>
     </accountUpdate>
 </batchRequest>
</cnpRequest>

Account Updater Batch Request

Copied!
<cnpRequest version="12.0" 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>
        </token>
    </accountUpdate>
    </batchRequest>
</cnpRequest>