CartClear
Description
The
CartClear
operation enables you to remove all of the items in a remote shopping cart, including
SavedForLater items. To remove only some of the items in a cart or to reduce the quantity of one or more
items, use
CartModify
(p. 185)
.
To delete all of the items from a remote shopping cart, you must specify the cart using the
CartId
and
HMAC
values, which are returned by the
CartCreate
operation. A value similar to the HMAC,
URLEncodedHMAC
, is also returned. This value is the URL encoded version of the
HMAC
. This encoding
is necessary because some characters, such as + and /, cannot be included in a URL. Rather than
encoding the
HMAC
yourself, use the
URLEncodedHMAC
value for the
HMAC
parameter.
CartClear
does not work after the customer has used the
PurchaseURL
to either purchase the items
or merge them with the items in their Amazon cart.
Carts exist even though they have been emptied. The lifespan of a cart is 7 days since the last time it
was acted upon. For example, if a cart created 6 days ago is modified, the cart lifespan is reset to 7 days.
Availability
All locales.
Request Parameters
Required
Description
Name
Yes
Specifies the Associate who is making the request. An
Associate tag, also known as an Associate ID, is an
automatically generated unique identifier. When you log
in to the Amazon Associates website for your locale, the
page that you are directed to includes a message that says
"Signed in as" followed by your Associate tag.
The Associate tag that you used to create a cart must also
be used on all other operations associated with the same
cart.
Type: String
Default: None
Valid Value: The same Associate tag that was used in the
related CartCreate request.
Constraint:
AssociateTag
Yes
Alphanumeric token returned by
CartCreate
that
identifies a cart.
Type: String
Default: None
Valid Values: Value returned by
CartCreate
.
CartId
API Version 2011-08-01
173
Product Advertising API Developer Guide
CartClear
