{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-products/account-updater/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"custom_product":"Account Updater","type":"markdown"},"seo":{"title":"Requests and Responses","description":"Worldpay for Developers - docs, code examples, resources and tools. Everything you need to build your omnichannel payment solution.","siteUrl":"https://docs.worldpay.com/access","image":"/access/assets/worldpay-logo-light.21b7daf79984773a9fcd7d4fbcb07ae5289dfffd6023c4c3dca720c7058e53dc.33f780a6.svg","keywords":"documentation, api, openapi, sdks, developer, payments, json, payouts, 3ds","jsonLd":{"@context":"https://schema.org","@type":"Organization","url":"https://docs.worldpay.com/access","name":"Worldpay"},"meta":[{"name":"google-site-verification","content":"zjziIKaP3ImsqsfhYnEBnq1R85UabiSwl7HTXuwtZuo"},{"name":"doc_product","content":"Access"},{"name":"doc_category","content":"Documentation"}],"llmstxt":{"hide":false,"sections":[{"title":"Payments API","description":"Payment orchestration API combining fraud assessment, 3ds authentication, SCA exemptions, Worldpay Token creation and a card or wallet based payment.","includeFiles":["products/payments/@20240601/**/*"],"excludeFiles":[]},{"title":"Payment Queries API","description":"Querying your payments data, based on a variety of parameters.","includeFiles":["products/payment-queries/@v1/**/*"],"excludeFiles":[]},{"title":"Card BIN Data API","description":"Provides detailed information about a card.","includeFiles":["products/card-bin/@v1/**/*"],"excludeFiles":[]},{"title":"3DS Authentication API","description":"Request 3DS authentication to protect against fraud, be SCA compliant and to shift liability using this standalone API.","includeFiles":["products/3ds/@v3/**/*"],"excludeFiles":[]},{"title":"FraudSight API","description":"Request a risk assessment and receive a response with an outcome (e.g. lowRisk) using this standalone API.","includeFiles":["products/fraudsight/@v1/**/*"],"excludeFiles":[]},{"title":"Checkout SDK","description":"Integrate using our clientside SDKs for both web and native devices. Benefit from SAQ-A/PCI-SSF compliance.","includeFiles":["products/checkout/web/@v2/**/*","products/checkout/ios/@v4/**/*","products/checkout/android/@v4/**/*","products/checkout/react-native/@v3/**/*","products/checkout/flutter/@v1/**/*"],"excludeFiles":[]},{"title":"Tokens API","description":"Minimizes the exposure of sensitive card details and increases the security of your customer's card details.","includeFiles":["products/tokens/@v3/**/*"],"excludeFiles":[]},{"title":"Card Payments API","description":"Request a card payment using this standalone API, requires separate requests for 3DS, Fraud assessment etc.","includeFiles":["products/card-payments/@v7/**/*"],"excludeFiles":[]},{"title":"Card Verifications API","description":"Verify your customer's card to maximize your authentication rates.","includeFiles":["products/card-verifications/@v6/**/*"],"excludeFiles":[]},{"title":"Account Payouts API","description":"Send funds to your customer's bank accounts and search for payouts using parameters.","includeFiles":["products/account-payouts/@20250101/**/*"],"excludeFiles":[]},{"title":"APMs","description":"Pay using eWallets, bank transfers, direct debits, local card schemes, Postpay and eInvoice/ Buy Now Pay Later.","includeFiles":["products/apms/@20240701/**/*"],"excludeFiles":[]},{"title":"Balance API","description":"Request your account details for a single account or all accounts under an entity.","includeFiles":["products/balance/@20250101/**/*"],"excludeFiles":[]},{"title":"Card Payouts API","description":"Send funds to your customer's cards.","includeFiles":["products/card-payouts/@v4/**/*"],"excludeFiles":[]},{"title":"Events (Webhooks)","description":"Receive status updates from Access Worldpay by setting up a webhook.","includeFiles":["products/events/@v1/**/*"],"excludeFiles":[]},{"title":"FX API","description":"Manage Foreign Exchange (FX) on your payments.","includeFiles":["products/fx/@v1/**/*"],"excludeFiles":[]},{"title":"Hosted Payment Pages (HPP) API","description":"Our low-code option to take payments securely at the lowest PCI compliance level - SAQ A.","includeFiles":["products/hosted-payment-pages/@v1/**/*"],"excludeFiles":[]},{"title":"Money Transfers API","description":"Money Transfer OCTs (Original Credit Transaction) allow funds to be pushed to an eligible card in 30 minutes or less.","includeFiles":["products/money-transfers/@v1/**/*"],"excludeFiles":[]},{"title":"Parties API","description":"Create parties, manage your payout instruments and beneficial owners and carry out identity verification checks.","includeFiles":["products/parties/@20250101/**/*"],"excludeFiles":[]},{"title":"SCA Exemptions API","description":"Maximize a frictionless checkout experience by using issuer data insights to apply exemptions.","includeFiles":["products/sca-exemptions/@v1/**/*"],"excludeFiles":[]},{"title":"Split Payments API","description":"Divide funds from a single payment amongst yourself and your parties/sellers.","includeFiles":["products/split-payments/@20250625/**/*"],"excludeFiles":[]},{"title":"Statements API","description":"Retrieve your account statement and see individual entries for all credits and debits.","includeFiles":["products/statements/@20250101/**/*"],"excludeFiles":[]},{"title":"Transfers API","description":"Transfer funds from source account to target account.","includeFiles":["products/transfers/@20250101/**/*"],"excludeFiles":[]},{"title":"Verified Tokens API","description":"Verified Tokens ensures that your customer's payment details are valid and CIT compliant when creating a token.","includeFiles":["products/verified-tokens/@v3/**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"requests-and-responses","__idx":0},"children":["Requests and Responses"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After you have completed the necessary ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/account-updater/testing"},"children":["tests"]}," you can begin using the API."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"using-ftp","__idx":1},"children":["Using FTP"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Submit an Account Updater request"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Receive an acknowledgement response from us"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If the response indicates any errors, you must resolve them and re-submit a new request"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Visa and MasterCard send a file to us containing the requested information"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["We send a completion response"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Retrieve your files using ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/account-updater/testing/ftp"},"children":["FTP"]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"batch-requests","__idx":2},"children":["Batch requests"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The first step of the process is submitting an Account Updater batch request."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"request-xml-structure","__idx":3},"children":["Request XML structure"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When submitting a request, you can use either card or token information. You must use the following structure:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"<cnpRequest  version=\"12.0\" xmlns=\"http://www.vantiv.cnp.com/schema&quot; id=\"requestId\" numBatchRequests=\"1\">\n <authentication>\n \t<user>JohnSmith</user>\n \t<password>Password1234</password>\n </authentication>\n <batchRequest  id=\"batchId\" numAccountUpdates=\"2\" merchantId=\"testMerchant01\">\n \t<accountUpdate  id=”1234” reportGroup\"merchant01ReportGrpoup\">\n \t<orderId >123456</orderId>\n \t<card>\n \t\t<type>Visa</type>\n \t\t<number>123412312345123</number>\n \t\t<expDate>0721</expDate>\n \t</card>\n \t</accountUpdate>\n \t<accountUpdate id=”1235” reportGroup=\"merchant01ReportGrpoup\">\n \t\t<orderId>123456</orderId>\n \t\t<token>\n \t\t\t<cnpToken >12345678912345</cnpToken>\n \t\t\t<expDate>0721</expDate>\n \t\t</token>\n \t</accountUpdate>\n </batchRequest>\n</cnpRequest>\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For more details about our Account Updater elements click ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/account-updater/requests-responses/response-elements"},"children":["here"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"acknowledgement-response","__idx":4},"children":["Acknowledgement response"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When you submit a request, Worldpay returns an acknowledgement response. This response confirms the request was received and contains validation information."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"acknowledgement-response-xml-structure","__idx":5},"children":["Acknowledgement response XML structure"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"<cnpResponse  version= \"11.2\" response=\"0\" message=\"Valid Format\" cnpSessionId=\"1700000128\">\n <batchResponse  cnpBatchId=\"1700000136\" merchantId=\"TestMerchant01\">\n <accountUpdateResponse  id=”1234” reportGroup=\"MerchantReportGroup01\">\n <cnpTxnId>123456789</cnpTxnId>\n <orderId>123456</orderId>\n <response>000</response>\n <responseTime>2009-12-21T11:37:04</responseTime>\n <message>Approved</message>\n </accountUpdateResponse>\n </batchResponse>\n</cnpResponse>\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For more details about our Account Updater elements click ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/account-updater/requests-responses/response-elements"},"children":["here"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"acknowledgement-response-codes","__idx":6},"children":["Acknowledgement response codes"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["We notify you when we receive the request. If the response file indicates any errors, you must resolve the issues and submit corrected account information in a new Account Updater request."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Response Code"},"children":["Response Code"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Response Message"},"children":["Response Message"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Resolution"},"children":["Resolution"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["000"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Approved"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["We forward these accounts to Visa and MasterCard."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["301"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Invalid account number"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The card number is not valid. Correct the account number and resubmit the data."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["320"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Invalid Expiration Date"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The expiration date is not valid. Correct the expiration date and resubmit the card data."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["821"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Merchant is not authorized for tokens"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["You are not authorized to use tokens."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["822"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Token was not found"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The submitted token was not found in the system. Correct the token number and resubmit."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["823"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Token was invalid"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The submitted token failed validation. Correct the token number and resubmit."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["899"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Generic token use error"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["There is an unspecified token use error; contact Customer Service."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"completion-response","__idx":7},"children":["Completion response"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["We return the completion response, which includes updated customer account information and reason codes supplied by the network. You can use this information to update customer account information."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Typically, we generate this file five days after you first submit your ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#batch-request"},"children":["batch request"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"completion-response-format","__idx":8},"children":["Completion response format"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following examples show a tree structure view of the acknowledgement response and a completion response."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["information. The response, however, does not contain the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["updatedCard"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["updatedToken"]}," child elements."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"completion-response-xml-structure","__idx":9},"children":["Completion response XML structure"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"<cnpResponse  version= \"11.2\" response=\"0\" message=\"Merchant Fiscal Day: 06102010\" cnpSessionId=\"1700000128\">\n    <batchResponse  cnpBatchId=\"1700000136\" merchantId=\"TestMerchant01\">\n        <accountUpdateResponse  id=”1234” reportGroup= \"MerchantReportGroup01\">\n            <cnpTxnId >123456789</cnpTxnId>\n            <orderId >123456</orderId>\n            <response >000</response>\n            <responseTime >2009-12-21T11:37:04</responseTime>\n            <message >Approved</message>\n            <originalCard >\n                <type >Visa</type>\n                <number >123412312345123</number>\n                <expDate >0721</expDate>\n            </originalCard>\n            <updatedCard >\n                <type >Visa</type>\n                <number >1234123123451224</number>\n                <expDate >0725</expDate>\n            </updatedCard>\n        </accountUpdateResponse>\n            <accountUpdateResponse  id=”1235” reportGroup= \"MerchantReportGroup01\">\n            <cnpTxnId>123456789</cnpTxnId>\n            <response>000</response>\n            <responseTime>2009-12-21T11:37:04</responseTime>\n            <message>Approved</message>\n            <originalToken>\n                <cnpToken>12345678912345</cnpToken>\n                <expDate>0721</expDate>\n                <type>Visa</type>\n                <bin>123456</bin>\n            </originalToken>\n            <updatedToken>\n                <cnpToken>12345622912345</cnpToken>\n                <expDate>0725</expDate>\n                <type>Visa</type>\n                <bin>123456</bin>\n            </updatedToken>\n            </accountUpdateResponse>\n    </batchResponse>\n</cnpResponse>\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For more details about our Account Updater elements click ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/account-updater/requests-responses/response-elements"},"children":["here"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"completion-response-codes","__idx":10},"children":["Completion response codes"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Account Updater completion response code and its associated message (as shown in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#response-codes"},"children":["Account Updater Completion Response Codes"]},") specify whether or not an account number has been changed and what type of change occurred, if any."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The Response Code value appears in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<response>"]}," element."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The Response Message value appears in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<message>"]}," element."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The Resolution column provides a recommended action."]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Response Code"},"children":["Response Code"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Response Message"},"children":["Response Message"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Resolution"},"children":["Resolution"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["191"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The merchant is not registered in the update program"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Escalate this to your Customer Experience Manager. This indicates a set-up problem that must be resolved prior to submitting another request file."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["500"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The account number was changed"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Submit the account number returned in the completion response. The response may also indicate that both the account number and expiration date changed."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["501"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The account was closed"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contact the cardholder for updated information."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["502"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The expiration date was changed"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Submit the expiration date returned in the completion response."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["503"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The issuing bank does not participate in the update program."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The Issuer does not participate in the Account Updater program. Submit original card information."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["504"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contact the cardholder for updated information"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contact the cardholder for updated information."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["505"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No match found"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["There was no match found in the updated information. Submit the original card information."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["506"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No changes found"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Submit the original card information."]}]}]}]}]}]},"headings":[{"value":"Requests and Responses","id":"requests-and-responses","depth":1},{"value":"Using FTP","id":"using-ftp","depth":2},{"value":"Batch requests","id":"batch-requests","depth":2},{"value":"Request XML structure","id":"request-xml-structure","depth":3},{"value":"Acknowledgement response","id":"acknowledgement-response","depth":2},{"value":"Acknowledgement response XML structure","id":"acknowledgement-response-xml-structure","depth":3},{"value":"Acknowledgement response codes","id":"acknowledgement-response-codes","depth":2},{"value":"Completion response","id":"completion-response","depth":2},{"value":"Completion response format","id":"completion-response-format","depth":3},{"value":"Completion response XML structure","id":"completion-response-xml-structure","depth":3},{"value":"Completion response codes","id":"completion-response-codes","depth":2}],"frontmatter":{"seo":{"title":"Requests and Responses"}},"lastModified":"2025-09-22T09:15:26.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/account-updater/requests-responses","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}