TransactionLookup

Product Advertising API: 2009-11-01

previous page next page

TransactionLookup

Description

The TransactionLookup operation returns information about up to ten purchases that have already taken place. Transaction IDs are created whenever a purchase request is made by a customer.

For a specified transaction ID, TransactionLookup returns:

  • Price details

  • Sale date

  • Shipping details

  • Seller details

  • Item’s condition

For privacy reasons, this operation does not return information about the customer who purchased the items.

Availability

US

Examples

Look up purchase details for TransactionId 002-7777777-7138425. 

http://ecs.amazonaws.com/onca/xml?
Service=AWSECommerceService
&AWSAccessKeyId=[AWS Access Key ID]
&Operation=TransactionLookup
&TransactionId=002-7777777-7138425

The response to this request is shown in, Response to Sample Request.

Request Parameters

Name Description Required
TransactionId

A number that uniquely identifies a transaction. The retail web site calls this number the Order number.

Type: Number, for example, 002-7777777-7138425

Type: String

Default: None

 Yes
ResponseGroup

Specifies the types of values to return. You can specify multiple response groups in one request by separating them with commas.

Type: String

Default: TransactionDetails

No

TransactionLookup also accepts the parameters that all operations can use. For more information, see, Common Request Parameters

Sample Response

The following XML is a snippet of the full response to the first sample request. 

<Transaction>
  <TransactionId>002-7777777-7138425</TransactionId> 
  <SellerId>AT9999999999R</SellerId> 
  <Condition>Complete</Condition> 
  <TransactionDate>2005-06-08T19:19:27</TransactionDate> 
  <TransactionDateEpoch>1118258367</TransactionDateEpoch> 
  <SellerName>Amazon.com</SellerName> 
  <Totals>
    <Total>
      <Amount>1879</Amount> 
     <CurrencyCode>USD</CurrencyCode> 
     <FormattedPrice>$18.79</FormattedPrice> 
    </Total>
    <Subtotal>
      <Amount>1485</Amount> 
      <CurrencyCode>USD</CurrencyCode> 
     <FormattedPrice>$14.85</FormattedPrice> 
    </Subtotal>
    <Tax>
      <Amount>144</Amount> 
      <CurrencyCode>USD</CurrencyCode> 
      <FormattedPrice>$1.44</FormattedPrice> 
    </Tax>
    <ShippingCharge>
      <Amount>399</Amount>
      <CurrencyCode>USD</CurrencyCode> 
      <FormattedPrice>$3.99</FormattedPrice> 
    </ShippingCharge>
    <Promotion>
      <Amount>149</Amount> 
      <CurrencyCode>USD</CurrencyCode> 
      <FormattedPrice>$1.49</FormattedPrice> 
    </Promotion>
  </Totals>
  <TransactionItems>
    <TransactionItem>
      <TransactionItemId>jooloslsnpl</TransactionItemId> 
      <Quantity>1</Quantity> 
      <UnitPrice>
        <Amount>1485</Amount> 
        <CurrencyCode>USD</CurrencyCode> 
        <FormattedPrice>$14.85</FormattedPrice> 
      </UnitPrice>
      <TotalPrice>
        <Amount>1485</Amount> 
        <CurrencyCode>USD</CurrencyCode> 
        <FormattedPrice>$14.85</FormattedPrice> 
      </TotalPrice>
  </TransactionItem>
</TransactionItems>
<Shipments>
  <Shipment>
    <Condition>Shipped</Condition> 
    <ShipmentItems>
      <TransactionItemId>jooloslsnpl</TransactionItemId> 
    </ShipmentItems>
  </Shipment>
</Shipments>
</Transaction>
</Transactions>

Response

Name Description
Amount Price of the item in terms of the lowest currency denomination, for example, pennies.
Condition Specifies an item's condition. If Condition is set to “All,” a separate set of responses is returned for each valid value of Condition. Valid values are New (default), Used, Collectible, Refurbished, and All. When the Availability parameter is set to "Available," the Condition parameter cannot be set to "New."
CurrencyCode ISO 4217 three-letter code that specifies the locale's currency.
FormattedPrice The price to display to the customer.
Promotion Container for promotion discount.
Quantity Number of items
SellerId An alphanumeric token that uniquely identifies a seller.
SellerName String that is the seller’s name.
Shipment Container for information relating for one shipment to a buyer. here can be multiple shipments to one buyer in one transaction, for example, when one item is ready to ship before another.
ShipmentItems Container for all items that were shipped to buyer in one shipment.
ShippingCharge Cost associated with shipping.
Subtotal Total cost of the items in the transaction. This cost does not include tax, shipping charges, or promotions.
Total Total cost the customer paid in the transaction. This cost includes tax, shipping charges, or promotions. This is a container for Amount, CurrencyCode, and FormattedPrice.
Totals This is a container for Total, Subtotal, Tax, ShippingCharges, and Promotions.
TransactionDate Date when order was created.
TransactionDateEpoch Date in epoch seconds when order was created.
TransactionId An alphanumeric token that uniquely identifies the transaction. This ID is called the Order Number on the retail web site in Your Account.
TransactionItem Transaction data for one item in the transaction. Container for TransactionItemId, quantity, and UnitPrice.
TransactionItemId An alphanumeric token that uniquely identifies an item in the transaction.
TransactionItems Container for one or more TransactionItem(s).
UnitPrice Price for a single item.

For more information about the parent elements of these tags, see the appropriate response group in Response Groups.

Related Operations

None

previous page start next page