Description
Attribute
This is the HMAC value with all of the characters converted in to a URL-compliant
form. Some HMAC characters, such as plus (+), are incompatible with URLs. This is
a problem because the HMAC must be included in every cart operation and thus is
part of the URL request. The URLEncodedHMAC value, then, is a convenience function
that relieves developers of the need to create their own URL-encoded HMAC value.
This value must accompany every cart operation.
<HMAC>Cw1g4IbVzOtzFkJR/zBj1GNnZMA</HMAC>
<URLEncodedHMAC>Cw1g4IbVzOtzFkJR/zBj1GNnZMA
</URLEncodedHMAC>
URLEncodedHMAC
This is the URL that is submitted, like a request, to enter the Order Pipeline and
purchase the items in a cart.
PurchaseURL
includes the Associate's Tag. It is important
that this URL is used to make the purchase otherwise the Associate will not get credit
for the sale.
<PurchaseURL>https://www.amazon.com/gp/cart/aws-merge.html?cart-
id=102-9464231-2184159%26associate-id=ws%26hmac=Cw1g4Ib
VzOtzFkJR/zBj1GNnZMA=%26AWSAccessKeyId=1VEXAMPLE9C02</PurchaseURL>
PurchaseURL
An alphanumeric token that uniquely identifies an item in the cart. Although the items
added to a remote shopping cart using
CartCreate
were identified by an ASIN or
OfferListingId, those items lose those associations. Instead, to refer to an item in a cart
in future cart operation requests, you must use the item's CartItemId value.
CartItemId
Modifying the Items in a Remote Shopping Cart
Product Advertising API operations give you a lot of flexibility to modify the number of items in a cart. For
example, use:
• CartAdd—To add new items to a cart.
• CartClear—To remove all items from a cart.
• CartModify—To increase or decrease the number of items that are already in a cart, and to move
items between the Active and the SaveForLater cart areas.
You can use this operation to delete a single item from a cart by setting its quantity to zero.
All of these operations can be used only on an existing remote shopping cart.
Adding Items to a Cart
Often a customer, after creating a shopping cart, wants to keep shopping and add additional items to an
existing shopping cart.You can facilitate this activity using the Product Advertising API operations
CartAdd
and
CartModify
.
If the item being added is already in the cart, you have to use the
CartModify
operation to change the
quantity of the items already in the cart. You cannot use
CartAdd
to add items that are already in a cart.
In the following example, the quantity of the specified item is changed to 10.
API Version 2011-08-01
142
Product Advertising API Developer Guide
Remote Shopping Cart Tasks
