{"_id":"5b8ec6a1f8dd7c0003386066","category":{"_id":"5b8ec6a1f8dd7c0003385fa5","version":"5b8ec6a1f8dd7c0003386069","project":"57336fd5a6a9c40e00e13a0b","__v":0,"sync":{"url":"","isSync":false},"reference":true,"createdAt":"2015-10-19T18:31:30.299Z","from_sync":false,"order":3,"slug":"vaulted-shopper-service","title":"Shoppers"},"project":"57336fd5a6a9c40e00e13a0b","user":"560d5913af97231900938124","parentDoc":null,"version":{"_id":"5b8ec6a1f8dd7c0003386069","project":"57336fd5a6a9c40e00e13a0b","__v":0,"forked_from":"5b19742cb3baf90003cab5ae","createdAt":"2018-04-24T15:33:45.744Z","releaseDate":"2018-04-24T15:33:45.744Z","categories":["5b8ec6a1f8dd7c0003385fa2","5b8ec6a1f8dd7c0003385fa3","5b8ec6a1f8dd7c0003385fa4","5b8ec6a1f8dd7c0003385fa5","5b8ec6a1f8dd7c0003385fa6","5b8ec6a1f8dd7c0003385fa7","5b8ec6a1f8dd7c0003385fa8","5b8ec6a1f8dd7c0003385fa9","5b8ec6a1f8dd7c0003385faa","5b8ec6a1f8dd7c0003385fab","5b8ec6a1f8dd7c0003385fac"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":false,"codename":"3.27 Release","version_clean":"8976.0.0-Extended","version":"8976-Extended"},"githubsync":"","__v":0,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-01-29T14:37:53.446Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"method":"put","results":{"codes":[{"language":"text","code":""}]},"settings":"","examples":{"codes":[]},"auth":"optional","params":[],"url":""},"isReference":true,"order":1,"body":"##Definition\nhttps<span>://sandbox.bluesnap.com/services/2/shoppers/:shopper-id|:seller-shopper-id,:seller-id</span>\n\n<hr>\n\n##Documentation\nThe Update Shopper request enables you to update an existing shopper by changing their contact info, adding credit card details, adding wallet details, and more.\n[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"* Each shopper can have multiple credit cards.\\n\\n* If you send a credit card number that does not yet exist for that shopper, it will be added to the shopper.\\n\\n* 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.\\n\\n* You can update your shopper's billing info using the public ACH or SEPA info without storing the full IBAN or account number.\",\n  \"title\": \"Notes:\"\n}\n[/block]\n###Request Content\n`shopper` &nbsp;&nbsp;&nbsp;<span style=\"color:#F37500\">**required**</span>, contains the following properties (see [shopper](doc:shopper)):\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`web-info` *container* &nbsp;&nbsp;&nbsp;<span style=\"color:#F37500\">**required**</span> (see [web-info](doc:web-info))\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`fraud-info` *container* &nbsp;&nbsp;&nbsp;optional (see [fraud-info](doc:fraud-info))\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`shopper-info` *container* &nbsp;&nbsp;&nbsp;<span style=\"color:#F37500\">**required**</span> (see [shopper-info](doc:shopper-info))\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`wallet-id` *integer* &nbsp;&nbsp;&nbsp;optional&nbsp;&nbsp;&nbsp;applicable for MasterPass and Visa Checkout. \n\n###Response Details\nIf successful, the response HTTP status code is 204 No Content.\nThere is no content in the response body.\nFor details about possible errors, see: [General Errors](doc:general-errors), [Shopper Errors](doc:shopper-errors), [Hosted Payment Field Errors](/v8976-Tools/docs/hosted-payment-field-errors), and [Wallet Errors](/v8976-Tools/docs/wallet-errors).\n\n<hr>\n\n##Examples\n\n###Request Examples\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"curl -v -X PUT https://sandbox.bluesnap.com/services/2/shoppers/19575974 \\\\\\n-H 'Content-Type: application/xml' \\\\\\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \\\\\\n-d '\\n<shopper xmlns=\\\"http://ws.plimus.com\\\">\\n  <web-info>\\n    <ip>62.219.121.253</ip>\\n    <remote-host>www.merchant.com</remote-host>\\n    <user-agent>Mozilla/5.0 (Linux; X11)</user-agent>\\n  </web-info>\\n  <shopper-info>\\n    <store-id>4677</store-id>\\n    <soft-descriptor>MYCOMPANY</soft-descriptor>\\n    <payment-info>\\n      <credit-cards-info>\\n        <credit-card-info>\\n          <billing-contact-info>\\n            <first-name>John</first-name>\\n            <last-name>Doe</last-name>\\n            <address1>138 Market St</address1>\\n            <city>San Francisco</city>\\n            <zip>75654</zip>\\n            <state>CA</state>\\n            <country>US</country>\\n          </billing-contact-info>\\n          <credit-card>\\n            <card-number>4012 8888 8888 1881</card-number>\\n            <security-code>411</security-code>\\n            <card-type>VISA</card-type>\\n            <expiration-month>07</expiration-month>\\n            <expiration-year>2019</expiration-year>\\n          </credit-card>\\n        </credit-card-info>\\n      </credit-cards-info>\\n    </payment-info>\\n  </shopper-info>\\n</shopper>'\",\n      \"language\": \"curl\",\n      \"name\": \"Update Shopper Request: add credit card\"\n    },\n    {\n      \"code\": \"curl -v -X PUT https://sandbox.bluesnap.com/services/2/shoppers/19575974 \\\\\\n-H 'Content-Type: application/xml' \\\\\\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \\\\\\n-d '\\n<shopper xmlns=\\\"http://ws.plimus.com\\\">\\n  <web-info>\\n    <ip>62.219.121.195</ip>\\n  </web-info>\\n  <shopper-info>\\n    <store-id>4677</store-id>\\n    <invoice-contacts-info>\\n      <invoice-contact-info>\\n        <default>true</default>\\n        <title>Mr.</title>\\n        <first-name>John</first-name>\\n        <last-name>Doe</last-name>\\n        <email>jdoe:::at:::johndoeandsons.com</email>\\n        <company-name>JohnDoeAndSons</company-name>\\n        <address1>100 Main st</address1>\\n        <city>San Jose</city>\\n        <state>CA</state>\\n        <zip>75654</zip>\\n        <country>US</country>\\n        <phone>14135556789</phone>\\n        <fax>14135556788</fax>\\n      </invoice-contact-info>\\n    </invoice-contacts-info>\\n  </shopper-info>\\n</shopper>'\",\n      \"language\": \"curl\",\n      \"name\": \"add invoice contact information\"\n    },\n    {\n      \"code\": \"curl -v -X PUT https://sandbox.bluesnap.com/services/2/shoppers/19575974 \\\\\\n-H 'Content-Type: application/xml' \\\\\\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \\\\\\n-d '\\n<shopper xmlns=\\\"http://ws.plimus.com\\\">\\n  <web-info>\\n    <ip>62.219.121.253</ip>\\n  </web-info>\\n  <shopper-info>\\n    <payment-info>\\n      <credit-cards-info>\\n        <credit-card-info>\\n          <billing-contact-info>\\n            <first-name>Bill</first-name>\\n            <last-name>Smith</last-name>\\n            <address1>500 Lincoln Av</address1>\\n            <city>San Francisco</city>\\n            <state>CA</state>\\n            <zip>75654</zip>\\n            <country>US</country>\\n          </billing-contact-info>\\n          <credit-card>\\n            <card-last-four-digits>1881</card-last-four-digits>\\n            <card-type>VISA</card-type>\\n          </credit-card>\\n        </credit-card-info>\\n      </credit-cards-info>\\n    </payment-info>\\n  </shopper-info>\\n</shopper>'\",\n      \"language\": \"curl\",\n      \"name\": \"update billing information\"\n    },\n    {\n      \"code\": \"curl -v -X PUT https://sandbox.bluesnap.com/services/2/shoppers/19575992 \\\\\\n-H 'Content-Type: application/xml' \\\\\\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \\\\\\n-d '\\n<shopper xmlns=\\\"http://ws.plimus.com\\\">\\n  <web-info>\\n    <ip>62.219.121.253</ip>\\n  </web-info>\\n  <shopper-info>\\n    <store-id>4677</store-id>\\n    <payment-info>\\n      <credit-cards-info>\\n        <credit-card-info>\\n          <billing-contact-info>\\n            <first-name>John</first-name>\\n            <last-name>Doe</last-name>\\n            <address1>138 Market St</address1>\\n            <city>San Francisco</city>\\n            <zip>75654</zip>\\n            <state>CA</state>\\n            <country>US</country>\\n          </billing-contact-info>\\n          <credit-card>\\n            <card-number>4111111111111111</card-number>\\n            <security-code>411</security-code>\\n            <card-type>VISA</card-type>\\n            <expiration-month>04</expiration-month>\\n            <expiration-year>2020</expiration-year>\\n          </credit-card>\\n        </credit-card-info>\\n      </credit-cards-info>\\n    </payment-info>\\n  </shopper-info>\\n</shopper>'\",\n      \"language\": \"curl\",\n      \"name\": \"update credit card information\"\n    },\n    {\n      \"code\": \"curl -v -X PUT https://sandbox.bluesnap.com/services/2/shoppers \\\\\\n-H 'Content-Type: application/xml' \\\\\\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \\\\\\n-d '\\n<shopper xmlns=\\\"http://ws.plimus.com\\\">\\n  <web-info>\\n    <ip>62.219.121.253</ip>\\n  </web-info>\\n  <shopper-info>\\n    <store-id>11580</store-id>\\n  </shopper-info>\\n  <wallet-id>121</wallet-id>\\n</shopper>'\",\n      \"language\": \"curl\",\n      \"name\": \"update with wallet ID\"\n    },\n    {\n      \"code\": \"curl -v -X PUT https://sandbox.bluesnap.com/services/2/shoppers/19575974 \\\\\\n-H 'Content-Type: application/xml' \\\\\\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \\\\\\n-d '\\n<shopper xmlns=\\\"http://ws.plimus.com\\\">\\n  <web-info>\\n    <ip>62.219.121.253</ip>\\n  </web-info>\\n  <shopper-info>\\n    <store-id>4677</store-id>\\n    <payment-info>\\n      <credit-cards-info>\\n        <credit-card-info>\\n          <billing-contact-info>\\n            <first-name>John</first-name>\\n            <last-name>Doe</last-name>\\n            <address1>138 Market St</address1>\\n            <city>San Francisco</city>\\n            <zip>75654</zip>\\n            <state>CA</state>\\n            <country>US</country>\\n          </billing-contact-info>\\n          <pf-token>c7c69ff853ab784ef35a0c78ffec08e78cf1d1b5b4bb9e2644c2bcc73f3f818f_1</pf-token>\\n        </credit-card-info>\\n      </credit-cards-info>\\n    </payment-info>\\n  </shopper-info>\\n</shopper>'\",\n      \"language\": \"curl\",\n      \"name\": \"update with Hosted Payment Fields token\"\n    },\n    {\n      \"code\": \"curl -v -X PUT https://sandbox.bluesnap.com/services/2/shoppers/19575992 \\\\\\n-H 'Content-Type: application/xml' \\\\\\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \\\\\\n-d '\\n<shopper xmlns=\\\"http://ws.plimus.com\\\">\\n               <web-info>\\n    <ip>127.0.0.1</ip>\\n  </web-info>\\n    <shopper-info>\\n        <shopper-id>19566484</shopper-id>\\n        <shopper-contact-info>\\n            <title>Mr.</title>\\n            <first-name>John</first-name>\\n            <last-name>Doe</last-name>\\n            <email>jdoe&#x40;johndoeandsons.com</email>\\n            <company-name>JohnDoeAndSons</company-name>\\n            <address1>138 Market st</address1>\\n            <city>San Francisco</city>\\n            <zip>756543</zip>\\n            <country>fr</country>\\n            <phone>1413555666</phone>\\n            <fax>1413555666789</fax>\\n        </shopper-contact-info>\\n        <shipping-contact-info/>\\n        <invoice-contacts-info>\\n            <invoice-contact-info>\\n                <default>true</default>\\n                <title>Mr.</title>\\n                <first-name>John</first-name>\\n                <last-name>Doe</last-name>\\n                <email>jdoe&#x40;johndoeandsons.com</email>\\n                <company-name>JohnDoeAndSons</company-name>\\n                <address1>138 Market st</address1>\\n                <city>Paris</city>\\n                <zip>756543</zip>\\n                <country>fr</country>\\n                <phone>1413555666</phone>\\n                <fax>1413555666789</fax>\\n            </invoice-contact-info>\\n        </invoice-contacts-info>\\n        <payment-info>\\n            <credit-cards-info/>\\n            <ecps-info/>\\n            <sepa-direct-debits-info>\\n                <sepa-direct-debit-info>\\n                    <billing-contact-info>\\n                        <first-name>SEPA new</first-name>\\n                        <last-name>abc new</last-name>\\n                        <address1>123 Oxford</address1>\\n                        <city>Paris</city>\\n                        <zip>54321</zip>\\n                        <country>fr</country>\\n                    </billing-contact-info>\\n                    <sepa-direct-debit>\\n                        <iban-first-four>DE09</iban-first-four>\\n                        <iban-last-four>7893</iban-last-four>\\n                    </sepa-direct-debit>\\n                </sepa-direct-debit-info>\\n            </sepa-direct-debits-info>\\n            <balance/>\\n        </payment-info>\\n        <store-id>1900</store-id>\\n        <shopper-currency>USD</shopper-currency>\\n        <locale>en</locale>\\n    </shopper-info>\\n</shopper>\",\n      \"language\": \"curl\",\n      \"name\": \"update SEPA information\"\n    },\n    {\n      \"code\": \"curl -v -X PUT https://sandbox.bluesnap.com/services/2/shoppers/19575992 \\\\\\n-H 'Content-Type: application/xml' \\\\\\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \\\\\\n-d '\\n<shopper xmlns=\\\"http://ws.plimus.com\\\">\\n               <web-info>\\n    <ip>127.0.0.1</ip>\\n  </web-info>\\n    <shopper-info>\\n        <shopper-id>19566478</shopper-id>\\n        <shopper-contact-info>\\n            <title>Mr.</title>\\n            <first-name>John</first-name>\\n            <last-name>Doe</last-name>\\n            <email>jdoe@johndoeandsons.com</email>\\n            <company-name>JohnDoeAndSons</company-name>\\n            <address1>138 Market St</address1>\\n            <city>San Francisco</city>\\n            <state>CA</state>\\n            <zip>75654</zip>\\n            <country>us</country>\\n            <phone>14135556789</phone>\\n            <fax>14135556788</fax>\\n        </shopper-contact-info>\\n        <shipping-contact-info/>\\n        <invoice-contacts-info>\\n            <invoice-contact-info>\\n                <default>true</default>\\n                <title>Mr.</title>\\n                <first-name>John</first-name>\\n                <last-name>Doe</last-name>\\n                <email>jdoe@johndoeandsons.com</email>\\n                <company-name>JohnDoeAndSons</company-name>\\n                <address1>138 Market St</address1>\\n                <city>San Francisco</city>\\n                <state>CA</state>\\n                <zip>75654</zip>\\n                <country>us</country>\\n                <phone>14135556789</phone>\\n                <fax>14135556788</fax>\\n            </invoice-contact-info>\\n        </invoice-contacts-info>\\n        <payment-info>\\n            <credit-cards-info/>\\n            <ecps-info>\\n                <ecp-info>\\n                    <billing-contact-info>\\n                        <first-name>first</first-name>\\n                        <last-name>last name</last-name>\\n                        <address1>123 Oxford</address1>\\n                        <city>ny</city>\\n                        <state>NY</state>\\n                        <zip>90210</zip>\\n                        <country>us</country>\\n                    </billing-contact-info>\\n                    <ecp>\\n                        <account-type>CONSUMER_CHECKING</account-type>\\n                        <public-account-number>98871</public-account-number>\\n                        <public-routing-number>74268</public-routing-number>\\n                    </ecp>\\n                </ecp-info>\\n            </ecps-info>\\n            <sepa-direct-debits-info/>\\n            <balance/>\\n        </payment-info>\\n        <store-id>1900</store-id>\\n        <shopper-currency>USD</shopper-currency>\\n        <locale>en</locale>\\n    </shopper-info>\\n</shopper>\",\n      \"language\": \"curl\",\n      \"name\": \"update ACH information\"\n    }\n  ]\n}\n[/block]\n###Response Example\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"HTTP/ 1.1 204 No Content\",\n      \"language\": \"text\",\n      \"name\": \"Update Shopper Response\"\n    }\n  ]\n}\n[/block]\n<hr>\n\n##Example Descriptions\n\n###Update Shopper: add credit card\nThe example above shows how to add another credit card to an existing shopper.\n\n###Update Shopper: add invoice contact information\nThe example above shows how to add invoice contact info to a shopper. Note that this will not change any of the existing invoice contact info, but will instead be added to the shopper's list of invoice contact info.\n\n###Update Shopper: update billing information\nThe example above shows how to update the billing information for a shopper's existing credit card. To do this, you only need to send the last four digits of the relevant credit card, not the entire card number.\n\n###Update Shopper: update credit card information\nThe example above shows how to update information for a shopper's existing credit card (card number 4111-1111-1111-1111). To update an existing credit card, you must send the complete card data.\n\n###Update Shopper: update with wallet ID\nThe example above shows how to add credit card info from a MasterPass or Visa Checkout wallet to a shopper by including the `wallet-id` in the request.\n\nFor details, see:\n  * [MasterPass Guide](/docs/masterpass)\n  * [Visa Checkout Guide](/docs/visa-checkout)\n\n###Update Shopper: update with Hosted Payment Fields token\nThe example above shows how to add credit card information from BlueSnap's [Hosted Payment Fields](/v8976-Tools/docs/hosted-payment-fields) to the shopper, by including the Hosted Payment Fields token within the `pf-token` property in your request.\n\n###Update Shopper: update SEPA information\nThe example above shows how to update information for a shopper's existing SEPA info. To update existing SEPA info, you must update the :seller-shopper-id,:seller-id in the URL (pass both seller-shopper-id and seller-id in the URL separated by a comma). (Note that this does not depend on the payment method, but works for credit cards, SEPA info, and so on.)\n\n###Update Shopper: update ACH information\nThe example above shows how to update information for a shopper's existing ACH info. To update existing ACH info, you must update the :seller-shopper-id,:seller-id in the URL (pass both seller-shopper-id and seller-id in the URL separated by a comma). (Note that this does not depend on the payment method, but works for credit cards, ACH info, and so on.)\n\n<br>\n<a class=\"btn btn-primary\" href=\"#\" role=\"button\">Back to Top</a>","excerpt":"","slug":"update-shopper","type":"endpoint","title":"Update Shopper"}

Definition

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


Documentation

The Update Shopper request enables you to update an existing shopper by changing their contact info, adding credit card details, 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):
      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.

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>2019</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>jdoe@johndoeandsons.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>2020</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>jdoe@johndoeandsons.com</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>jdoe@johndoeandsons.com</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>

Response Example

HTTP/ 1.1 204 No Content


Example Descriptions

Update Shopper: add credit card

The example above shows how to add another credit card to an existing shopper.

Update Shopper: add invoice contact information

The example above shows how to add invoice contact info to a shopper. Note that this will not change any of the existing invoice contact info, but will instead be added to the shopper's list of invoice contact info.

Update Shopper: update billing information

The example above shows how to update the billing information for a shopper's existing credit card. To do this, you only need to send the last four digits of the relevant credit card, not the entire card number.

Update Shopper: update credit card information

The example above shows how to update information for a shopper's existing credit card (card number 4111-1111-1111-1111). To update an existing credit card, you must send the complete card data.

Update Shopper: update with wallet ID

The example above shows how to add credit card info from a MasterPass or Visa Checkout wallet to a shopper by including the wallet-id in the request.

For details, see:

Update Shopper: update with Hosted Payment Fields token

The example above shows how to add credit card information from BlueSnap's Hosted Payment Fields to the shopper, by including the Hosted Payment Fields token within the pf-token property in your request.

Update Shopper: update SEPA information

The example above shows how to update information for a shopper's existing SEPA info. To update existing SEPA info, you must update the :seller-shopper-id,:seller-id in the URL (pass both seller-shopper-id and seller-id in the URL separated by a comma). (Note that this does not depend on the payment method, but works for credit cards, SEPA info, and so on.)

Update Shopper: update ACH information

The example above shows how to update information for a shopper's existing ACH info. To update existing ACH info, you must update the :seller-shopper-id,:seller-id in the URL (pass both seller-shopper-id and seller-id in the URL separated by a comma). (Note that this does not depend on the payment method, but works for credit cards, ACH info, and so on.)



Back to Top