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 PurchaseURL is submitted, the customer is sent to the page that shows the contents of their shopping cart, which includes all items in their remote and local shopping cart. If MergeCart is False, when the PurchaseURL is submitted, the customer is sent directly to the order pipeline so that they can purchase the items in their remote shopping cart only. The default value in the US locale is False. In non-US locales, the value can only be True. In the US, the default is False. |
No |
True False (US locale only) |
| 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: |