{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"optional","examples":{"codes":[]},"method":"get","results":{"codes":[{"language":"text","code":""}]},"settings":"","params":[{"name":"account-update-batch-id","type":"string","default":"","desc":"batch ID provided in the Create Account Updater Request","required":true,"in":"path","ref":"","_id":"576abd0f481fa82b00c06e44"}]},"next":{"description":"","pages":[]},"title":"Retrieve Account Updater","type":"endpoint","slug":"retrieve-account-updater","excerpt":"","body":"##Definition\nhttps<span>://sandbox.bluesnap.com/services/2/account-updater/{account-update-batch-id}</span>\n\n<hr>\n\n##Documentation\nThe Retrieve Account Updater request gets results about a previously submitted [Create Account Updater](doc:create-account-updater) request, including information about the credit card accounts that were updated. The results will be ready 5-6 days after the initial Create Account Updater request, and will be available for 45 days. If the process is not complete, you will receive a message saying the file is not yet available (details below).\n[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"The Retrieve Account Updater request should be submitted 5-6 days after the initial [Create Account Updater](doc:create-account-updater) request. Please note that card updates are not available in sandbox.\"\n}\n[/block]\n###Request Content\nEnter the `account-update-batch-id` into the web service URL, in the format:\n`services/2/account-updater/{account-update-batch-id}`\n\nFor example:\n`services/2/account-updater/my_unique_au_id_003`\n\n###Response Details\nIf successful, the response HTTP status code is 200 OK.\nThe response contains the retrieved `batch-account-update` resource (see [batch-account-update](doc:batch-account-update)) with the request properties, plus these additions for each `account update` resource:\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`update-response-code`\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`update-response-message`\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`updated-card`\n\n**Account Updater Response Codes and Messages**\n  * **500** The account number was changed. Submit the account number returned in the completion response. \n  * **501** The account was closed. Contact the cardholder for updated information. \n  * **502** The expiration date was changed. Submit the expiration date returned in the completion response.\n  * **503** The issuing bank does not participate in the update program. Submit the original card information.\n  * **504** Contact the cardholder for updated information. Contact the cardholder for updated information. \n  * **505** No match found. Submit the original card information.\n  * **506** No changes found. Submit the original card information. \n  * **507** The cardholder has opted out of the update program. \n\n**Response if Account Update processing is not yet complete**\nIf processing is not yet complete, you will receive the following response: \n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"<?xml version=\\\"1.0\\\" encoding=\\\"UTF-8\\\" standalone=\\\"yes\\\"?>\\n<batch-account-update xmlns=\\\"http://ws.plimus.com\\\">\\n  <response-code>20005</response-code>\\n  <response-message>The account update file for batch Id {batchId} is not ready yet. Please try again later.</response-message>\\n</batch-account-update>\",\n      \"language\": \"xml\",\n      \"name\": \"Reponse before processing is complete\"\n    }\n  ]\n}\n[/block]\n\n<hr>\n\n##Examples\n\n###Request Example\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"curl -v -X GET https://sandbox.bluesnap.com/services/2/account-updater/my_unique_au_id_003 \\\\\\n-H 'Content-Type: application/xml' \\\\\\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ='\",\n      \"language\": \"curl\",\n      \"name\": \"Retrieve Account Updater Request\"\n    }\n  ]\n}\n[/block]\n###Response Example\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"HTTP/ 1.1 200 OK\\n\\n<batch-account-update xmlns=\\\"http://ws.plimus.com\\\">\\n    <response-code>0</response-code>\\n    <response-message>Merchant Fiscal Day: 12132004</response-message>\\n    <account-update>\\n        <merchant-updater-id>00001</merchant-updater-id>\\n        <update-response-code>506</update-response-code>\\n        <update-response-message>No changes found</update-response-message>\\n        <original-card>\\n            <credit-card>\\n                <card-number>4012888888881881</card-number>\\n                <card-type>VISA</card-type>\\n                <card-sub-type>CREDIT</card-sub-type>\\n                <expiration-month>03</expiration-month>\\n                <expiration-year>15</expiration-year>\\n            </credit-card>\\n        </original-card>\\n    </account-update>\\n    <account-update>\\n        <merchant-updater-id>00002</merchant-updater-id>\\n        <update-response-code>502</update-response-code>\\n        <update-response-message>The expiration date was changed</update-response-message>\\n        <original-card>\\n            <credit-card>\\n                <card-number>4111111111111111</card-number>\\n                <card-type>VISA</card-type>\\n                <card-sub-type>DEBIT</card-sub-type>\\n                <expiration-month>04</expiration-month>\\n                <expiration-year>16</expiration-year>\\n            </credit-card>\\n        </original-card>\\n        <updated-card>\\n            <credit-card>\\n                <card-number>4111111111111111</card-number>\\n                <card-type>VISA</card-type>\\n                <card-sub-type>CREDIT</card-sub-type>\\n                <expiration-month>08</expiration-month>\\n                <expiration-year>19</expiration-year>\\n            </credit-card>\\n        </updated-card>\\n    </account-update>\\n    <account-update>\\n        <merchant-updater-id>00003</merchant-updater-id>\\n        <update-response-code>500</update-response-code>\\n        <update-response-message>The account number was changed</update-response-message>\\n        <original-card>\\n            <credit-card>\\n                <card-number>5555555555554444</card-number>\\n                <card-type>MASTERCARD</card-type>\\n                <card-sub-type>DEBIT</card-sub-type>\\n                <expiration-month>05</expiration-month>\\n                <expiration-year>17</expiration-year>\\n            </credit-card>\\n        </original-card>\\n        <updated-card>\\n            <credit-card>\\n                <card-number>5156430030000095</card-number>\\n                <card-type>MASTERCARD</card-type>\\n                <card-sub-type>CREDIT</card-sub-type>\\n                <expiration-month>01</expiration-month>\\n                <expiration-year>18</expiration-year>\\n            </credit-card>\\n        </updated-card>\\n    </account-update>\\n</batch-account-update>\",\n      \"language\": \"xml\",\n      \"name\": \"Retrieve Account Updater Response: 200 OK\"\n    }\n  ]\n}\n[/block]\n<hr>\n\n##Example Description\nAbove is an example request. Note that no XML content is required in the request body. You simply need to include the `account-update-batch-id` in the request URL. This the unique ID sent in the the `account-update-batch-id` property in the initial [Create Account Updater](doc:create-account-updater) request.\n<br>\n<a class=\"btn btn-primary\" href=\"#\" role=\"button\">Back to Top</a>","updates":[],"order":2,"isReference":true,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"6197defc41c8040154bcba98","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Account Updater","slug":"account-updater","order":4,"from_sync":false,"reference":true,"_id":"6197defc41c8040154bcba65","version":"6197defc41c8040154bcbaea","project":"57336fd5a6a9c40e00e13a0b","createdAt":"2016-05-17T12:18:23.126Z","__v":0},"parentDoc":null,"user":"560d5913af97231900938124","project":"57336fd5a6a9c40e00e13a0b","version":{"version":"8976-Tools","version_clean":"8976.0.0-Tools","codename":"3.40 Release","is_stable":false,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["6197defc41c8040154bcba61","6197defc41c8040154bcba62","6197defc41c8040154bcba63","6197defc41c8040154bcba64","6197defc41c8040154bcba65","6197defc41c8040154bcba66","6197defc41c8040154bcba67","6197defc41c8040154bcba68","6197defc41c8040154bcba69","6197defc41c8040154bcba6a","6197defc41c8040154bcba6b","6197defc41c8040154bcba6c","5b34c737e0dca2000311de6a","60957f4cce403c0045a031ef","6197defc41c8040154bcba6d","6197defc41c8040154bcba6e","6197defc41c8040154bcba6f","6197defc41c8040154bcba70","6197defc41c8040154bcba71","6197defc41c8040154bcba72"],"_id":"6197defc41c8040154bcbaea","project":"57336fd5a6a9c40e00e13a0b","__v":0,"forked_from":"60957f4cce403c0045a03255","createdAt":"2018-04-23T15:17:35.680Z","releaseDate":"2018-04-23T15:17:35.680Z"},"createdAt":"2016-05-17T13:12:08.693Z","githubsync":"","__v":3}

BlueSnap Reporting & Tools

Reporting API

Custom Reporting API

3D Secure

Account Updater

Bank Directory

Convert Currency

Encrypt/Decrypt Parameters

Hosted Payment Fields

Logos & Images

Payment Request Button

Retrieve Card Info

Retrieve Payment Methods

Secured Payment Collector

SEPA Direct Debit

Tax Quotes

User Management

Wallets

getRetrieve Account Updater

Definition

https://sandbox.bluesnap.com/services/2/account-updater/{account-update-batch-id}

Documentation

The Retrieve Account Updater request gets results about a previously submitted Create Account Updater request, including information about the credit card accounts that were updated. The results will be ready 5-6 days after the initial Create Account Updater request, and will be available for 45 days. If the process is not complete, you will receive a message saying the file is not yet available (details below).

The Retrieve Account Updater request should be submitted 5-6 days after the initial Create Account Updater request. Please note that card updates are not available in sandbox.

Request Content

Enter the account-update-batch-id into the web service URL, in the format:
services/2/account-updater/{account-update-batch-id}

For example:
services/2/account-updater/my_unique_au_id_003

Response Details

If successful, the response HTTP status code is 200 OK.
The response contains the retrieved batch-account-update resource (see batch-account-update) with the request properties, plus these additions for each account update resource:
      update-response-code
      update-response-message
      updated-card

Account Updater Response Codes and Messages

  • 500 The account number was changed. Submit the account number returned in the completion response.
  • 501 The account was closed. Contact the cardholder for updated information.
  • 502 The expiration date was changed. Submit the expiration date returned in the completion response.
  • 503 The issuing bank does not participate in the update program. Submit the original card information.
  • 504 Contact the cardholder for updated information. Contact the cardholder for updated information.
  • 505 No match found. Submit the original card information.
  • 506 No changes found. Submit the original card information.
  • 507 The cardholder has opted out of the update program.

Response if Account Update processing is not yet complete
If processing is not yet complete, you will receive the following response:

Reponse before processing is complete
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<batch-account-update xmlns="http://ws.plimus.com">
  <response-code>20005</response-code>
  <response-message>The account update file for batch Id {batchId} is not ready yet. Please try again later.</response-message>
</batch-account-update>

Examples

Request Example

Retrieve Account Updater Request
curl -v -X GET https://sandbox.bluesnap.com/services/2/account-updater/my_unique_au_id_003 \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ='

Response Example

Retrieve Account Updater Response: 200 OK
HTTP/ 1.1 200 OK

<batch-account-update xmlns="http://ws.plimus.com">
    <response-code>0</response-code>
    <response-message>Merchant Fiscal Day: 12132004</response-message>
    <account-update>
        <merchant-updater-id>00001</merchant-updater-id>
        <update-response-code>506</update-response-code>
        <update-response-message>No changes found</update-response-message>
        <original-card>
            <credit-card>
                <card-number>4012888888881881</card-number>
                <card-type>VISA</card-type>
                <card-sub-type>CREDIT</card-sub-type>
                <expiration-month>03</expiration-month>
                <expiration-year>15</expiration-year>
            </credit-card>
        </original-card>
    </account-update>
    <account-update>
        <merchant-updater-id>00002</merchant-updater-id>
        <update-response-code>502</update-response-code>
        <update-response-message>The expiration date was changed</update-response-message>
        <original-card>
            <credit-card>
                <card-number>4111111111111111</card-number>
                <card-type>VISA</card-type>
                <card-sub-type>DEBIT</card-sub-type>
                <expiration-month>04</expiration-month>
                <expiration-year>16</expiration-year>
            </credit-card>
        </original-card>
        <updated-card>
            <credit-card>
                <card-number>4111111111111111</card-number>
                <card-type>VISA</card-type>
                <card-sub-type>CREDIT</card-sub-type>
                <expiration-month>08</expiration-month>
                <expiration-year>19</expiration-year>
            </credit-card>
        </updated-card>
    </account-update>
    <account-update>
        <merchant-updater-id>00003</merchant-updater-id>
        <update-response-code>500</update-response-code>
        <update-response-message>The account number was changed</update-response-message>
        <original-card>
            <credit-card>
                <card-number>5555555555554444</card-number>
                <card-type>MASTERCARD</card-type>
                <card-sub-type>DEBIT</card-sub-type>
                <expiration-month>05</expiration-month>
                <expiration-year>17</expiration-year>
            </credit-card>
        </original-card>
        <updated-card>
            <credit-card>
                <card-number>5156430030000095</card-number>
                <card-type>MASTERCARD</card-type>
                <card-sub-type>CREDIT</card-sub-type>
                <expiration-month>01</expiration-month>
                <expiration-year>18</expiration-year>
            </credit-card>
        </updated-card>
    </account-update>
</batch-account-update>

Example Description

Above is an example request. Note that no XML content is required in the request body. You simply need to include the account-update-batch-id in the request URL. This the unique ID sent in the the account-update-batch-id property in the initial Create Account Updater request.


Back to Top