Update Shopper

Definition

https://sandbox.bluesnap.com/services/2/shoppers/:shopper-id|:seller-shopper-id,:seller-id


The Update Shopper request enables you to update an existing shopper by changing their contact info, adding and deleting payment methods, adding wallet details, and more.

📘

Notes:

  • Each shopper can have multiple credit cards.

  • If you send a credit card number that does not yet exist for that shopper, it will be added to the shopper.

  • If you send a credit card number that already exists in that shopper, the shopper will be updated with any changes to that card's expiration date.

  • You can update your shopper's billing info using the public ACH or SEPA info without storing the full IBAN or account number.


Request Content

shopper    required, contains the following properties (see shopper):

Property

Type

Required

web-info

container

required (see web-info)

fraud-info

container

optional (see fraud-info)

shopper-info

container

required (see shopper-info)

wallet-id

integer

optional, applicable for Masterpass and Visa Checkout.

three-d-secure

container

optional (refer to three-d-secure)

Response Details

If successful, the response HTTP status code is 204 No Content. There is no content in the response body. For details about possible errors, see: General Errors, Shopper Errors, Hosted Payment Field Errors, and Wallet Errors.


Examples

Request Examples

curl -v -X PUT https://sandbox.bluesnap.com/services/2/shoppers/19575974 \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<shopper xmlns="http://ws.plimus.com">
  <web-info>
    <ip>62.219.121.253</ip>
    <remote-host>www.merchant.com</remote-host>
    <user-agent>Mozilla/5.0 (Linux; X11)</user-agent>
  </web-info>
  <shopper-info>
    <store-id>4677</store-id>
    <soft-descriptor>MYCOMPANY</soft-descriptor>
    <payment-info>
      <credit-cards-info>
        <credit-card-info>
          <billing-contact-info>
            <first-name>John</first-name>
            <last-name>Doe</last-name>
            <address1>138 Market St</address1>
            <city>San Francisco</city>
            <zip>75654</zip>
            <state>CA</state>
            <country>US</country>
          </billing-contact-info>
          <credit-card>
            <card-number>4012 8888 8888 1881</card-number>
            <security-code>411</security-code>
            <card-type>VISA</card-type>
            <expiration-month>07</expiration-month>
            <expiration-year>2023</expiration-year>
          </credit-card>
        </credit-card-info>
      </credit-cards-info>
    </payment-info>
  </shopper-info>
</shopper>
curl -v -X PUT https://sandbox.bluesnap.com/services/2/shoppers/19575974 \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<shopper xmlns="http://ws.plimus.com">
  <web-info>
    <ip>62.219.121.195</ip>
  </web-info>
  <shopper-info>
    <store-id>4677</store-id>
    <invoice-contacts-info>
      <invoice-contact-info>
        <default>true</default>
        <title>Mr.</title>
        <first-name>John</first-name>
        <last-name>Doe</last-name>
        <email>[email protected]dsons.com</email>
        <company-name>JohnDoeAndSons</company-name>
        <address1>100 Main st</address1>
        <city>San Jose</city>
        <state>CA</state>
        <zip>75654</zip>
        <country>US</country>
        <phone>14135556789</phone>
        <fax>14135556788</fax>
      </invoice-contact-info>
    </invoice-contacts-info>
  </shopper-info>
</shopper>
curl -v -X PUT https://sandbox.bluesnap.com/services/2/shoppers/19575974 \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<shopper xmlns="http://ws.plimus.com">
  <web-info>
    <ip>62.219.121.253</ip>
  </web-info>
  <shopper-info>
    <payment-info>
      <credit-cards-info>
        <credit-card-info>
          <billing-contact-info>
            <first-name>Bill</first-name>
            <last-name>Smith</last-name>
            <address1>500 Lincoln Av</address1>
            <city>San Francisco</city>
            <state>CA</state>
            <zip>75654</zip>
            <country>US</country>
          </billing-contact-info>
          <credit-card>
            <card-last-four-digits>1881</card-last-four-digits>
            <card-type>VISA</card-type>
          </credit-card>
        </credit-card-info>
      </credit-cards-info>
    </payment-info>
  </shopper-info>
</shopper>
curl -v -X PUT https://sandbox.bluesnap.com/services/2/shoppers/19575992 \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<shopper xmlns="http://ws.plimus.com">
  <web-info>
    <ip>62.219.121.253</ip>
  </web-info>
  <shopper-info>
    <store-id>4677</store-id>
    <payment-info>
      <credit-cards-info>
        <credit-card-info>
          <billing-contact-info>
            <first-name>John</first-name>
            <last-name>Doe</last-name>
            <address1>138 Market St</address1>
            <city>San Francisco</city>
            <zip>75654</zip>
            <state>CA</state>
            <country>US</country>
          </billing-contact-info>
          <credit-card>
            <card-number>4111111111111111</card-number>
            <security-code>411</security-code>
            <card-type>VISA</card-type>
            <expiration-month>04</expiration-month>
            <expiration-year>2023</expiration-year>
          </credit-card>
        </credit-card-info>
      </credit-cards-info>
    </payment-info>
  </shopper-info>
</shopper>
curl -v -X PUT https://sandbox.bluesnap.com/services/2/shoppers \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<shopper xmlns="http://ws.plimus.com">
  <web-info>
    <ip>62.219.121.253</ip>
  </web-info>
  <shopper-info>
    <store-id>11580</store-id>
  </shopper-info>
  <wallet-id>121</wallet-id>
</shopper>
curl -v -X PUT https://sandbox.bluesnap.com/services/2/shoppers/19575974 \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<shopper xmlns="http://ws.plimus.com">
  <web-info>
    <ip>62.219.121.253</ip>
  </web-info>
  <shopper-info>
    <store-id>4677</store-id>
    <payment-info>
      <credit-cards-info>
        <credit-card-info>
          <billing-contact-info>
            <first-name>John</first-name>
            <last-name>Doe</last-name>
            <address1>138 Market St</address1>
            <city>San Francisco</city>
            <zip>75654</zip>
            <state>CA</state>
            <country>US</country>
          </billing-contact-info>
          <pf-token>c7c69ff853ab784ef35a0c78ffec08e78cf1d1b5b4bb9e2644c2bcc73f3f818f_1</pf-token>
        </credit-card-info>
      </credit-cards-info>
    </payment-info>
  </shopper-info>
</shopper>
curl -v -X PUT https://sandbox.bluesnap.com/services/2/shoppers/19575992 \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<shopper xmlns="http://ws.plimus.com">
               <web-info>
    <ip>127.0.0.1</ip>
  </web-info>
    <shopper-info>
        <shopper-id>19566484</shopper-id>
        <shopper-contact-info>
            <title>Mr.</title>
            <first-name>John</first-name>
            <last-name>Doe</last-name>
            <email>jdoe&#x40;johndoeandsons.com</email>
            <company-name>JohnDoeAndSons</company-name>
            <address1>138 Market st</address1>
            <city>San Francisco</city>
            <zip>756543</zip>
            <country>fr</country>
            <phone>1413555666</phone>
            <fax>1413555666789</fax>
        </shopper-contact-info>
        <shipping-contact-info/>
        <invoice-contacts-info>
            <invoice-contact-info>
                <default>true</default>
                <title>Mr.</title>
                <first-name>John</first-name>
                <last-name>Doe</last-name>
                <email>jdoe&#x40;johndoeandsons.com</email>
                <company-name>JohnDoeAndSons</company-name>
                <address1>138 Market st</address1>
                <city>Paris</city>
                <zip>756543</zip>
                <country>fr</country>
                <phone>1413555666</phone>
                <fax>1413555666789</fax>
            </invoice-contact-info>
        </invoice-contacts-info>
        <payment-info>
            <credit-cards-info/>
            <ecps-info/>
            <sepa-direct-debits-info>
                <sepa-direct-debit-info>
                    <billing-contact-info>
                        <first-name>SEPA new</first-name>
                        <last-name>abc new</last-name>
                        <address1>123 Oxford</address1>
                        <city>Paris</city>
                        <zip>54321</zip>
                        <country>fr</country>
                    </billing-contact-info>
                    <sepa-direct-debit>
                        <iban-first-four>DE09</iban-first-four>
                        <iban-last-four>7893</iban-last-four>
                    </sepa-direct-debit>
                </sepa-direct-debit-info>
            </sepa-direct-debits-info>
            <balance/>
        </payment-info>
        <store-id>1900</store-id>
        <shopper-currency>USD</shopper-currency>
        <locale>en</locale>
    </shopper-info>
</shopper>
curl -v -X PUT https://sandbox.bluesnap.com/services/2/shoppers/19575992 \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<shopper xmlns="http://ws.plimus.com">
               <web-info>
    <ip>127.0.0.1</ip>
  </web-info>
    <shopper-info>
        <shopper-id>19566478</shopper-id>
        <shopper-contact-info>
            <title>Mr.</title>
            <first-name>John</first-name>
            <last-name>Doe</last-name>
            <email>[email protected]</email>
            <company-name>JohnDoeAndSons</company-name>
            <address1>138 Market St</address1>
            <city>San Francisco</city>
            <state>CA</state>
            <zip>75654</zip>
            <country>us</country>
            <phone>14135556789</phone>
            <fax>14135556788</fax>
        </shopper-contact-info>
        <shipping-contact-info/>
        <invoice-contacts-info>
            <invoice-contact-info>
                <default>true</default>
                <title>Mr.</title>
                <first-name>John</first-name>
                <last-name>Doe</last-name>
                <email>[email protected]</email>
                <company-name>JohnDoeAndSons</company-name>
                <address1>138 Market St</address1>
                <city>San Francisco</city>
                <state>CA</state>
                <zip>75654</zip>
                <country>us</country>
                <phone>14135556789</phone>
                <fax>14135556788</fax>
            </invoice-contact-info>
        </invoice-contacts-info>
        <payment-info>
            <credit-cards-info/>
            <ecps-info>
                <ecp-info>
                    <billing-contact-info>
                        <first-name>first</first-name>
                        <last-name>last name</last-name>
                        <address1>123 Oxford</address1>
                        <city>ny</city>
                        <state>NY</state>
                        <zip>90210</zip>
                        <country>us</country>
                    </billing-contact-info>
                    <ecp>
                        <account-type>CONSUMER_CHECKING</account-type>
                        <public-account-number>98871</public-account-number>
                        <public-routing-number>74268</public-routing-number>
                    </ecp>
                </ecp-info>
            </ecps-info>
            <sepa-direct-debits-info/>
            <balance/>
        </payment-info>
        <store-id>1900</store-id>
        <shopper-currency>USD</shopper-currency>
        <locale>en</locale>
    </shopper-info>
</shopper>
curl -v -X PUT https://sandbox.bluesnap.com/services/2/shoppers/19575992 \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<shopper xmlns="http://ws.plimus.com">
                <web-info>
                    <ip>127.0.0.1</ip>
                    <remote-host>www.merchant.com</remote-host>
                    <user-agent>Mozilla/5.0 (Linux; X11)</user-agent>
                </web-info>
    <shopper-info>
        <shopper-id>19570110</shopper-id>
        <store-id>8540</store-id>
        <payment-info>
            <ecps-info>
                <ecp-info>
                    <billing-contact-info>
                        <first-name>first</first-name>
                        <last-name>last name</last-name>
                        <address1>123 Oxford</address1>
                        <city>ny</city>
                        <state>NY</state>
                        <zip>90210</zip>
                        <country>us</country>
                    </billing-contact-info>
                    <ecp>
                        <account-type>CONSUMER_CHECKING</account-type>
                        <account-number>4099999993</account-number>
                        <routing-number>011075151</routing-number>
                    </ecp>
                </ecp-info>
            </ecps-info>
        </payment-info>
    </shopper-info>
</shopper>
curl -v -X PUT https://sandbox.bluesnap.com/services/2/shoppers/19575974 \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<shopper xmlns="http://ws.plimus.com">
  <web-info>
    <ip>62.219.121.253</ip>
    <remote-host>www.merchant.com</remote-host>
    <user-agent>Mozilla/5.0 (Linux; X11)</user-agent>
  </web-info>
  <shopper-info>
    <store-id>4677</store-id>
    <soft-descriptor>MYCOMPANY</soft-descriptor>
    <payment-info>
     <credit-cards-info>
          <credit-card-info>
             <credit-card>
                <card-last-four-digits>9299</card-last-four-digits>
                <card-type>VISA</card-type>
             </credit-card>
             <status>D</status>                  
          </credit-card-info>
     </credit-cards-info>
    </payment-info>
  </shopper-info>
</shopper>
curl -v -X PUT https://sandbox.bluesnap.com/services/2/shoppers/19575974 \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<shopper xmlns="http://ws.plimus.com">
    <web-info>
         <ip>62.219.121.253</ip>
         <remote-host>www.merchant.com</remote-host>
         <user-agent>Mozilla/4.0</user-agent>
         <accept-language>en-us</accept-language>
      </web-info>
    <shopper-info>
        <shopper-id>19564316</shopper-id>
        <shopper-contact-info>
            <title>Mr.</title>
            <first-name>John</first-name>
            <last-name>Doe</last-name>
            <email>[email protected]</email>
            <company-name>JohnDoeAndSons</company-name>
            <address1>138 Market St</address1>
            <city>San Francisco</city>
            <state>CA</state>
            <zip>75654</zip>
            <country>us</country>
            <phone>14135556789</phone>
            <fax>14135556788</fax>
        </shopper-contact-info>
        <shipping-contact-info/>
        <invoice-contacts-info>
            <invoice-contact-info>
                <default>true</default>
                <title>Mr.</title>
                <first-name>John</first-name>
                <last-name>Doe</last-name>
                <email>[email protected]</email>
                <company-name>JohnDoeAndSons</company-name>
                <address1>138 Market St</address1>
                <city>San Francisco</city>
                <state>CA</state>
                <zip>75654</zip>
                <country>us</country>
                <phone>14135556789</phone>
                <fax>14135556788</fax>
            </invoice-contact-info>
        </invoice-contacts-info>
        <payment-info>
            <credit-cards-info/>
            <ecps-info>
                <ecp-info>
                    <billing-contact-info>
                        <first-name>second ecp first</first-name>
                        <last-name>second ECP last name</last-name>
                        <address1>123 Oxford</address1>
                        <city>ny</city>
                        <state>NY</state>
                        <zip>90210</zip>
                        <country>us</country>
                        <company-name>JohnDoeAndSons</company-name>
                    </billing-contact-info>
                    <ecp>
                        <account-type>CONSUMER_CHECKING</account-type>
                        <public-account-number>98871</public-account-number>
                        <public-routing-number>74268</public-routing-number>
                    </ecp>
                    <status>D</status>
                </ecp-info>
            </ecps-info>
            <balance/>
        </payment-info>
        <store-id>1900</store-id>
        <shopper-currency>USD</shopper-currency>
        <locale>en</locale>
    </shopper-info>
</shopper>
curl -v -X PUT https://sandbox.bluesnap.com/services/2/shoppers/19575974 \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<shopper xmlns="http://ws.plimus.com">
    <web-info>
         <ip>62.219.121.253</ip>
         <remote-host>www.merchant.com</remote-host>
         <user-agent>Mozilla/4.0</user-agent>
         <accept-language>en-us</accept-language>
      </web-info>
    <shopper-info>
        <shopper-id>19564316</shopper-id>
        <shopper-contact-info>
            <title>Mr.</title>
            <first-name>John</first-name>
            <last-name>Doe</last-name>
            <email>[email protected]</email>
            <company-name>JohnDoeAndSons</company-name>
            <address1>138 Market St</address1>
            <city>San Francisco</city>
            <zip>75654</zip>
            <country>fr</country>
            <phone>14135556789</phone>
            <fax>14135556788</fax>
        </shopper-contact-info>
        <shipping-contact-info/>
        <invoice-contacts-info>
            <invoice-contact-info>
                <default>true</default>
                <title>Mr.</title>
                <first-name>John</first-name>
                <last-name>Doe</last-name>
                <email>[email protected]</email>
                <company-name>JohnDoeAndSons</company-name>
                <address1>138 Market St</address1>
                <city>Paris</city>
                <zip>75654</zip>
                <country>fr</country>
                <phone>14135556789</phone>
                <fax>14135556788</fax>
            </invoice-contact-info>
        </invoice-contacts-info>
        <payment-info>
        <sepa-direct-debits-info>
                <sepa-direct-debit-info>
                    <billing-contact-info>
                        <first-name>SEPA Billing first name</first-name>
                        <last-name>SEPA Billing last name</last-name>
                        <address1>123 Oxford</address1>
                        <city>Paris</city>
                        <zip>15016</zip>
                        <country>fr</country>
                    </billing-contact-info>
                    <sepa-direct-debit>
                        <iban-first-four>DE09</iban-first-four>
                        <iban-last-four>7893</iban-last-four>
                    </sepa-direct-debit>
                    <status>D</status>
                </sepa-direct-debit-info>
            </sepa-direct-debits-info>
            <balance/>
        </payment-info>
        <store-id>1900</store-id>
        <shopper-currency>USD</shopper-currency>
        <locale>en</locale>
    </shopper-info>
</shopper>

Response Example

HTTP/ 1.1 204 No Content

Back to Top