The CartGet operation allows you to retrieve the contents of a remote shopping cart.
Note:
The cart lifespan is currently 90 days from its last access date.
CartGet is available in all of the locales.
Using CartGet (REST)
This example demonstrates how to use CartGet to access a shopping cart.
http://webservices.amazon.com/onca/xml?Service=AWSECommerceService&AWSAccessKeyId=[Your Access Key ID Here]&Operation=CartGet&CartId=[A Cart ID]&HMAC=[An HMAC Shopping Cart Token]
Request parameters specify the terms of your request and control the output data that is returned to you.
You must include the required parameters in every request.
CartGet accepts the optional parameters that are common to all operations:
The following parameters are specific to the CartGet operation:
| Parameter | Description | Required? | Value |
|---|---|---|---|
| Operation | The operation. | Always Required | CartGet |
| CartId |
The CartId is a unique identifier for an Amazon remote shopping cart. CartIds are initially obtained by using the CartCreate operation. |
Always Required |
Required Value:
|
| HMAC |
The HMAC is a unique security token that, when used with the CartId, allows you to access and modify (add to, remove from, empty) a specific remote shopping cart that you have created from your application or Web site. HMACs are initially obtained by using the CartCreate operation. Any plus signs ("+") embedded in the HMAC must be encoded as %2B for REST. |
Always Required |
Required Value:
|
| MergeCart |
MergeCart is a boolean value that determines, in the US locale only, whether items in the remote shopping cart are added to the customer's local, Amazon shopping cart (MergeCart=True) or not (MergeCart=False). If MergeCart is True, when the customer clicks the Purchase button, they are sent to the page that shows the contents of their shopping cart, which includes all items in their local shopping cart. When MergeCart is False, when the customer clicks the Purchase button, they are sent to the order pipeline and the purchase pages. The default value is False and for non-US locales it is always False. |
Optional in the US locale. The default is True. This parameter is not available in non-US locales. | |
| ResponseGroup |
Controls the data returned by the operation. Use this parameter to specify which response group(s), or group(s) of data elements, you would like Amazon E-Commerce Service (ECS) to return to you. You can specify as many response groups as you wish using a comma-separated list (REST) or multiple elements (SOAP). |
Optional |
Default Values: Valid Values: |