{"_id":"59b6b1edbc195b003ca7a99a","category":{"_id":"59b6b1ecbc195b003ca7a985","version":"59b6b1ecbc195b003ca7a981","project":"57336fd5a6a9c40e00e13a0b","__v":0,"sync":{"url":"","isSync":false},"reference":true,"createdAt":"2016-05-17T12:18:23.126Z","from_sync":false,"order":3,"slug":"account-updater","title":"Account Updater"},"user":"560d5913af97231900938124","parentDoc":null,"project":"57336fd5a6a9c40e00e13a0b","version":{"_id":"59b6b1ecbc195b003ca7a981","project":"57336fd5a6a9c40e00e13a0b","__v":1,"createdAt":"2017-09-11T15:55:24.925Z","releaseDate":"2017-09-11T15:55:24.925Z","categories":["59b6b1ecbc195b003ca7a982","59b6b1ecbc195b003ca7a983","59b6b1ecbc195b003ca7a984","59b6b1ecbc195b003ca7a985","59b6b1ecbc195b003ca7a986","59b6b1ecbc195b003ca7a987","59b6b1ecbc195b003ca7a988","59b6b1ecbc195b003ca7a989","59b6b1ecbc195b003ca7a98a","59b6b1ecbc195b003ca7a98b"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":false,"codename":"3.22.2 Release","version_clean":"8976.0.0-Tools","version":"8976-Tools"},"__v":0,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-05-17T12:32:40.470Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"examples":{"codes":[{"name":"Create Account Updater","language":"curl","code":""}]},"method":"post","results":{"codes":[{"language":"text","code":""}]},"settings":"","auth":"optional","params":[],"url":""},"isReference":true,"order":8,"body":"##Definition\nhttps<span>://sandbox.bluesnap.com/services/2/account-updater</span>\n\n<hr>\n\n##Documentation\nThe Create Account Updater request enables you to send in multiple credit cards to get them updated with the latest information. This is relevant if you are storing credit card details on your side. If the credit cards are stored in BlueSnap, they will be automatically kept up-to-date. Account Updater is available for Visa, MasterCard and Discover. Please include only these card types in your request. For more information about this service, see [Account Updater](doc:account-updater).\n\nThe request includes one or more `account-update` resources, along with a unique batch ID that you define. \n[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"The Account Updater process takes about 5 - 6 days to complete. About 5 days after you send the request, you can send a [Retrieve Account Updater](doc:retrieve-account-updater) request in order to get details about any changes to the cards you sent. Please note that card updates are not available in sandbox.\"\n}\n[/block]\n###Request Content\n`batch-account-update` *container* &nbsp;&nbsp;&nbsp;<span style=\"color:#F38A00\">**required**</span>, contains the following properties (see [batch-account-update](doc:batch-account-update)):\n&nbsp;&nbsp;&nbsp;`account-update-batch-id` *string* &nbsp;&nbsp;&nbsp;<span style=\"color:#F37500\">**required**</span>\n&nbsp;&nbsp;&nbsp;`account-update` *container* &nbsp;&nbsp;&nbsp;<span style=\"color:#F37500\">**required**</span>, contains the following properties (see [account-update](doc:account-update)):\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`merchant-updater-id` *string* &nbsp;&nbsp;&nbsp;<span style=\"color:#F37500\">**required**</span>\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`original-card` *container* &nbsp;&nbsp;&nbsp;<span style=\"color:#F37500\">**required**</span> (see [original-card](doc:original-card))\n\n###Response Details\nIf successful, the response HTTP status code is 200 OK.\nThe response contains a `batch-account-update` resource (see [batch-account-update](doc:batch-account-update)) with the request properties plus these additions:\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`response-code`\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`response-message`\n\n<hr>\n\n##Examples\n\n###Request Example\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"curl -v -X POST https://sandbox.bluesnap.com/services/2/account-updater \\\\\\n-H 'Content-Type: application/xml' \\\\\\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \\\\\\n-d '\\n<batch-account-update xmlns=\\\"http://ws.plimus.com\\\">\\n <account-update-batch-id>my_unique_au_id_003</account-update-batch-id>\\n <account-update>\\n  <merchant-updater-id>00001</merchant-updater-id>\\n  <original-card>\\n   <credit-card>\\n     <card-number>4012888888881881</card-number>\\n     <card-type>VISA</card-type>\\n     <expiration-month>03</expiration-month>\\n     <expiration-year>2015</expiration-year>\\n   </credit-card>\\n  </original-card>\\n </account-update>\\n <account-update>\\n  <merchant-updater-id>00002</merchant-updater-id>\\n  <original-card>\\n   <credit-card>\\n     <card-number>4111111111111111</card-number>\\n     <card-type>VISA</card-type>\\n     <expiration-month>04</expiration-month>\\n     <expiration-year>2016</expiration-year>\\n   </credit-card>\\n  </original-card>\\n </account-update>\\n <account-update>\\n  <merchant-updater-id>00003</merchant-updater-id>\\n  <original-card>\\n   <credit-card>\\n     <card-number>5555555555554444</card-number>\\n     <card-type>MASTERCARD</card-type>\\n     <expiration-month>05</expiration-month>\\n     <expiration-year>2017</expiration-year>\\n   </credit-card>\\n  </original-card>\\n </account-update>\\n</batch-account-update>'\",\n      \"language\": \"curl\",\n      \"name\": \"Create 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    <account-update-batch-id>my_unique_au_id_003</account-update-batch-id>\\n    <response-code>0</response-code>\\n    <response-message>Valid Format</response-message>\\n    <account-update>\\n        <merchant-updater-id>00001</merchant-updater-id>\\n        <update-response-code>000</update-response-code>\\n        <update-response-message>Approved</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>000</update-response-code>\\n        <update-response-message>Approved</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    </account-update>\\n    <account-update>\\n        <merchant-updater-id>00003</merchant-updater-id>\\n        <update-response-code>000</update-response-code>\\n        <update-response-message>Approved</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>CREDIT</card-sub-type>\\n                <expiration-month>05</expiration-month>\\n                <expiration-year>17</expiration-year>\\n            </credit-card>\\n        </original-card>\\n    </account-update>\\n</batch-account-update>\",\n      \"language\": \"xml\",\n      \"name\": \"Create Account Updater Response: 200 OK\"\n    }\n  ]\n}\n[/block]\n<hr>\n\n##Example Description\nThe example above shows a Create Account Updater request containing three credit cards to be updated.\n\n<a class=\"btn btn-primary\" href=\"#\" role=\"button\">Back to Top</a>","excerpt":"","slug":"create-account-updater","type":"post","title":"Create Account Updater"}

postCreate Account Updater


Definition

https://sandbox.bluesnap.com/services/2/account-updater


Documentation

The Create Account Updater request enables you to send in multiple credit cards to get them updated with the latest information. This is relevant if you are storing credit card details on your side. If the credit cards are stored in BlueSnap, they will be automatically kept up-to-date. Account Updater is available for Visa, MasterCard and Discover. Please include only these card types in your request. For more information about this service, see Account Updater.

The request includes one or more account-update resources, along with a unique batch ID that you define.

The Account Updater process takes about 5 - 6 days to complete. About 5 days after you send the request, you can send a Retrieve Account Updater request in order to get details about any changes to the cards you sent. Please note that card updates are not available in sandbox.

Request Content

batch-account-update container    required, contains the following properties (see batch-account-update):
   account-update-batch-id string    required
   account-update container    required, contains the following properties (see account-update):
      merchant-updater-id string    required
      original-card container    required (see original-card)

Response Details

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


Examples

Request Example

curl -v -X POST https://sandbox.bluesnap.com/services/2/account-updater \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<batch-account-update xmlns="http://ws.plimus.com">
 <account-update-batch-id>my_unique_au_id_003</account-update-batch-id>
 <account-update>
  <merchant-updater-id>00001</merchant-updater-id>
  <original-card>
   <credit-card>
     <card-number>4012888888881881</card-number>
     <card-type>VISA</card-type>
     <expiration-month>03</expiration-month>
     <expiration-year>2015</expiration-year>
   </credit-card>
  </original-card>
 </account-update>
 <account-update>
  <merchant-updater-id>00002</merchant-updater-id>
  <original-card>
   <credit-card>
     <card-number>4111111111111111</card-number>
     <card-type>VISA</card-type>
     <expiration-month>04</expiration-month>
     <expiration-year>2016</expiration-year>
   </credit-card>
  </original-card>
 </account-update>
 <account-update>
  <merchant-updater-id>00003</merchant-updater-id>
  <original-card>
   <credit-card>
     <card-number>5555555555554444</card-number>
     <card-type>MASTERCARD</card-type>
     <expiration-month>05</expiration-month>
     <expiration-year>2017</expiration-year>
   </credit-card>
  </original-card>
 </account-update>
</batch-account-update>'

Response Example

HTTP/ 1.1 200 OK

<batch-account-update xmlns="http://ws.plimus.com">
    <account-update-batch-id>my_unique_au_id_003</account-update-batch-id>
    <response-code>0</response-code>
    <response-message>Valid Format</response-message>
    <account-update>
        <merchant-updater-id>00001</merchant-updater-id>
        <update-response-code>000</update-response-code>
        <update-response-message>Approved</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>000</update-response-code>
        <update-response-message>Approved</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>
    </account-update>
    <account-update>
        <merchant-updater-id>00003</merchant-updater-id>
        <update-response-code>000</update-response-code>
        <update-response-message>Approved</update-response-message>
        <original-card>
            <credit-card>
                <card-number>5555555555554444</card-number>
                <card-type>MASTERCARD</card-type>
                <card-sub-type>CREDIT</card-sub-type>
                <expiration-month>05</expiration-month>
                <expiration-year>17</expiration-year>
            </credit-card>
        </original-card>
    </account-update>
</batch-account-update>


Example Description

The example above shows a Create Account Updater request containing three credit cards to be updated.

Back to Top