Create Account Updater

The Create Account Updater request lets you request updated information about a batch of credit or debit cards. This service is available for the following card types:

  • American Express
  • Discover
  • Mastercard
  • Visa

Endpoint

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

This service takes about seven days to gather the new card information. When the updated card information is available, you can retrieve the details with the Retrieve Account Updater request.

📘

Note

This request does not update credit card information for BlueSnap vaulted shoppers.

The request includes one or more account-update resources and a unique batch ID that you define. In addition, this request has the following restrictions:

  • 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.

For more information about this service, see Account Updater.

Request Content

The request body requires a batch-account-update and account-update resource.

batch-account-update

batch-account-update requires the following property:

PropertyTypeRequired
account-update-batch-idstringrequired

account-update

The account-update container requires the following properties:

PropertyTypeRequired
merchant-updater-idstringrequired
original-cardcontainerrequired (see original-card)

Response Details

Successful requests return the HTTP response status code 200 OK and a response body that contains a batch-account-update resource.

After you perform a Create Account Updater request, you receive one of the following update responses for each account updater record submitted:

Response CodeMessage
000Approved for submission to account updater process.
301Invalid account number: check the card number and resubmit.
320Invalid Expiration date: check the card expiration date and resubmit.
330Invalid payment type.
390Card not supported.

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>