API BasicsPayment APIEmbedded PaymentsReporting & ToolsSupport GuidesBlueSnap.com
Top of Section

Create Account Updater

Definition

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

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 American Express, Visa, Mastercard and Discover. Please include only these card types in your request. For more information about this service, see [Account Updater](ref:account-updater).

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

📘

Notes:

  • There is a 2,000 record size limit.
  • 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.
  • Card updates are not available in sandbox.

Request Content

batch-account-update container    required, contains the following properties (see batch-account-update):

PropertyTypeRequired
account-update-batch-idstringrequired

account-update container    required, contains the following properties (see account-update):

PropertyTypeRequired
merchant-updater-idstringrequired
original-cardcontainerrequired (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

After you perform a Create Account Updater request, one of three possible update responses displays for each account updater record submitted:

  • 000 – Approved for submission to account updater process
  • 301 – Invalid account number: check the card number and resubmit
  • 320 – Invalid Expiration date: check the card expiration date and resubmit

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>

Back to Top