This type defines the Transaction container, which consists of detailed information about a single line item in an order. The eBay system creates an order line item when a buyer has committed to make a purchase in an auction or fixed-price listing. A multiple-quantity, fixed-priced listing can spawn one or more order line items. Auction listings and single-quantity, fixed-price listings can only spawn one order line item.
The handling cost for the order line item. The value of this field is returned as zero dollars if the seller did not specify a handling cost for the listing. It also will show as 0.00 dollars until payment has been made on the order.
See the Field Index to learn which calls use ActualHandlingCost.
The shipping cost charged to the buyer for the order line item.
For GetOrders, this field is returned only after checkout is completed on the order. A value of 0.00 indicates free shipping.
For other calls, this field is always returned but defaults to 0.00 until payment has been made on the order.
Note: This is different from the field of the same name returned by GetSellingManagerSaleRecord and ReviseSellingManagerSaleRecord, which contains the actual shipping cost paid by the seller.
See the Field Index to learn which calls use ActualShippingCost.
This value indicates the dollar amount by which the buyer has adjusted the order total. Adjustments to order costs may include shipping and handling, shipping insurance, buyer discounts, or added services. A positive amount indicates the amount is an extra charge being paid to the seller by the buyer. A negative value indicates this amount is a credit given to the buyer by the seller.
Not applicable to Half.com.
See the Field Index to learn which calls use AdjustmentAmount.
This value indicates the total amount of the line item. This amount includes the sale price, shipping and handling charges, shipping insurance (if offered and selected by the buyer), additional services, and any applied sales tax. This value is returned after the buyer has completed checkout (the CheckoutStatus.Status output field reads "Complete"). If the seller allowed the buyer to change the total for an order, the buyer is able to change the total up until the time when checkout status is Complete. Determine whether the buyer changed the amount by retrieving the order line item data and comparing the AmountPaid value to what the seller expected. If multiple order line items between the same buyer and seller have been combined into a Combined Payment order, the AmountPaid value returned in GetSellerTransactions and GetItemTransactions reflects the amount paid for the Combined Payment order and not the individual order line item. You can determine the order line items that belong to the same Combined Payment order by checking to see if the ContainingOrder.OrderID value is the same. For Motors items, AmountPaid is the amount paid by the buyer for the deposit.
Not applicable to Half.com.
See the Field Index to learn which calls use AmountPaid.
UserType container consisting of eBay user data for the buyer. See UserType for its child elements. Returned by GetItemsAwaitingFeedback if the seller is making the request.
Applicable to Half.com (for GetOrders only).
See the Field Index to learn which calls use Buyer.
For the Australia site, BuyerGuaranteePrice is the PayPal Buyer Protection coverage, offered for the item at the time of purchase. Details of coverage are in the following sections of the View Item page: the Buy Safely section and the Payment Details section.
See the Field Index to learn which calls use BuyerGuaranteePrice.
This value indicates the payment status of an order. This field is only returned for items that have actually been purchased (fixed-price or Buy It Now) or won (auction listings) and not auction listings that have just been bid on.
Not applicable to Half.com.
See the Field Index to learn which calls use BuyerPaidStatus.
This field is returned if the IncludeCodiceFiscale flag is included in the request and set to 'true', and if the buyer has provided this value at checkout time.
This field is only applicable to Italian sellers. The Codice Fiscale number is unique for each Italian citizen and is used for tax purposes.
See the Field Index to learn which calls use CodiceFiscale.
The Combined Payment order to which the order line item belongs. This container is only returned if IncludeContainingOrder is included and set to true in a GetItemTransactions or GetSellerTransactions request.
Not applicable to Half.com.
See the Field Index to learn which calls use ContainingOrder.
This value indicates the converted value of AdjustmentAmount in the currency of the site that returned the response. Refresh this value every 24 hours to pick up the current conversion rates.
Not applicable to Half.com.
See the Field Index to learn which calls use ConvertedAdjustmentAmount.
This value indicates the converted value of AmountPaid in the currency of the site that returned the response. Refresh this value every 24 hours to pick up the current conversion rates.
Not applicable to Half.com.
See the Field Index to learn which calls use ConvertedAmountPaid.
This value indicates the converted value of TransactionPrice in the currency of the site that returned the response. Refresh this value every 24 hours to pick up the current conversion rates.
Not applicable to Half.com.
See the Field Index to learn which calls use ConvertedTransactionPrice.
Indicates the creation time of the order line item. For auction listings, an order line item is created when that listing ends with a high bidder whose bid meets or exceeds the Reserve Price (if set). For a fixed-price listing or a Buy It Now auction listing, an order line item is created once the buyer clicks the Buy button.
Applicable to Half.com (for GetOrders only).
See the Field Index to learn which calls use CreatedDate.
This value indicates whether or not the seller requires a deposit for the vehicle. This field is only applicable to US eBay Motors Vehicle listings. Otherwise, this field is returned as an empty value.
Not applicable to Half.com.
See the Field Index to learn which calls use DepositType.
Container consisting of details for the electronic payment of an eBay order line item. PayPal transactions may include a buyer payment or refund, or a fee or credit applied to the seller's account. This field is only returned after payment for the order line item has occurred. For orders in which the seller's funds are being held by PayPal, the PaymentHoldDetails container and PaymentHoldStatus field will be returned instead of the ExternalTransaction container.
Not applicable to Half.com.
See the Field Index to learn which calls use ExternalTransaction.
This container consists of Feedback left by the caller for their order partner. This container is only returned if the order is complete and feedback on the order line item has been left by the caller.
Not applicable to Half.com.
See the Field Index to learn which calls use FeedbackLeft.
This container consists of Feedback received by the caller from their order partner. This container is only returned if the order is complete and feedback on the order line item has been received by the caller.
Not applicable to Half.com.
See the Field Index to learn which calls use FeedbackReceived.
A seller is changed a Final Value Fee (FVF) when the item is sold, ends with a winning bid, or is purchased. This fee applies whether or not the sale is completed with the buyer and is generated before the buyer makes a payment.
The FVF is calculated using a percentage. This percentage is based on whether the seller has a Store subscription or not. If a seller does have a Store subscription, the FVF is calculated based on the level of that plan. For complete information about the subscription plans and fees, see .
The Final Value Fee for each order line item is returned by GetSellerTransactions, GetItemTransactions, GetOrders, and GetOrderTransactions, regardless of the checkout status.
If a seller requests a Final Value Fee credit, the value of Transaction.FinalValueFee will not change if a credit is issued. The credit only appears in the seller's account data.
Not applicable to Half.com.
See the Field Index to learn which calls use FinalValueFee.
This flag indicates whether or not the order line item is an intangible good such as an MP3 track or a mobile phone ringtone. Intangible items are not eligible for PayPal's Seller Protection program, so the seller will not be able to open an Unpaid Item case against the buyer.
See the Field Index to learn which calls use IntangibleItem.
This field indicates the date/time that an order invoice was sent from the seller to the buyer. This field is only returned if an invoice (containing the order line item) was sent to the buyer.
See the Field Index to learn which calls use InvoiceSentTime.
If IsMultilegShipping is true, the order or transaction uses the Global Shipping Program, in which the shipment has a domestic leg and an international leg. The buyer's shipping address is in a country other than the country where the items were listed, and the Get family of calls will return InternationalPriorityShipping as the default international shipping service in the listings of all the items in the order.
If IsMultilegShipping is false, the order or transaction does not use the Global Shipping Program. The shipment might use a different international shipping service, or it might be domestic.
See the Field Index to learn which calls use IsMultiLegShipping.
Container consisting of details about an item in a listing. The child fields returned are dependent on the call, the type of item or listing, and the listing site.
Applicable to Half.com (for GetOrders).
See the Field Index to learn which calls use Item.
A unique identifier for an eBay order line item. This field is created as soon as there is a commitment to buy from the seller, and its value is based upon the concatenation of ItemID and TransactionID, with a hyphen in between these two IDs.
See the Field Index to learn which calls use OrderLineItemID.
Indicates the time when the order was marked paid. This value will only be visible to the user on either side of the order. An order can be marked as paid in the following ways:
Automatically when a payment is made via PayPal
Seller marks the item as paid in My eBay or through Selling Manager Pro
Programmatically by the seller through the ReviseCheckoutStatus or CompleteSale calls.
Not applicable to Half.com.
See the Field Index to learn which calls use PaidTime.
This container consists of information related to the payment hold on the order line item, including the reason why the buyer's payment for the order line item is being held, the expected release date of the funds into the seller's account, and possible action(s) the seller can take to expedite the payout of funds into their account. This container is only returned if PayPal has placed a payment hold on the order line item.
An American seller (selling on US or US Motors sites) and a Canadian seller (selling on CA and CA- FR sites) may be subject to PayPal payment holds (that last from three to 21 days) if that seller is new to selling on eBay or is classified as a "Below Standard" seller. For other reasons why a seller's funds may be held by PayPal, see the PaymentHoldReason field.
See the Field Index to learn which calls use PaymentHoldDetails.
This value indicates the number of identical items purchased at the same time by the same buyer from one listing. For auction listings, this value is always 1. For fixed-price, non-variation listings, this value can be greater than 1. In either case, this field is tied to the same order line item.
Applicable to Half.com (for GetOrders).
See the Field Index to learn which calls use QuantityPurchased.
Container consisting of one or more refund transactions to Half.com buyers. Container consisting of one or more refund transactions for eBay's new payment process. This container is only returned if a refund to a Half.com buyer has occurred or an refund was issued through eBay's new payment process
See the Field Index to learn which calls use RefundArray.
Indicates whether the buyer has opted to accept emails from all the selling partners on Shopping.com. This field is only returned for order line items purchased through the Shopping.com shopping cart.
See the Field Index to learn which calls use SellerContactBuyerByEmail.
Indicates the time when the item(s) associated with the order were marked as shipped. This value will only be visible to the user on either side of the order. An order can be marked as shipped in My eBay or through Selling Manager Pro, or programmatically by the seller through the CompleteSale call.
Applicable to Half.com (for GetOrders only).
See the Field Index to learn which calls use ShippedTime.
Container consisting of shipping-related details for an order. Shipping details include shipping rates, package dimensions, handling costs, excluded shipping locations (if specified), shipping service options, shipping insurance information, sales tax information (if applicable), and shipment tracking details (if shipped).
For GetSellerTransactions and GetItemTransactions, the ShippingDetails container is returned in the Transaction container. For GetOrders and GetOrderTransactions, the ShippingDetails container is returned at the Order level.
Applicable to Half.com (for GetOrders only).
See the Field Index to learn which calls use ShippingDetails.
Container consisting of details about the domestic or international shipping service selected by the buyer.
Note: For GetItemTransactions and GetSellerTransactions, this container does not return accurate shipping service and cost information for multiple line item orders. Use GetOrders instead, and provide the order's combined OrderID to retrieve this information.
Not applicable to Half.com.
See the Field Index to learn which calls use ShippingServiceSelected.
Container consisting of status details of an order line item, including payment information. Several of these fields change values during the checkout flow. See TransactionStatusType for its child elements.
For GetOrders, only the IntegratedMerchantCreditCardEnabled and PaymentMethodUsed child elements are returned. The PaymentHoldStatus container will be returned for those sellers subject to the new eBay payment process. The fields indicating the status of the order are actually found in the OrderArray.Order.CheckoutStatus container.
Not applicable to Half.com.
See the Field Index to learn which calls use Status.
This field indicates the total price for an order line item.
For GetMyeBaySelling, with Global Shipping Program orders, the value of this field depends on order status and the number of transactions in the order. For orders awaiting payment, the field contains the purchase price of the order line item; for paid orders, it contains the purchase price of the order line item plus the cost of domestic shipping to the international shipping provider's warehouse. With single-transaction orders, this field is returned under the OrderTransaction.Transaction container; with multiple-transaction orders, it's returned under the OrderTransaction.Order.TransactionArray.Transaction container.
Not applicable to Half.com.
See the Field Index to learn which calls use TotalPrice.
The price of one order line item. This amount does not take into account shipping, sales tax, and other costs related to the order line item.
If multiple units were purchased through a non-variation, fixed-price listing, this value is the total combined price for all units of the order line item. With GetMyeBaySelling, you can also get this value by multiplying SellingStatus.QuantitySold by SellingStatus.CurrentPrice.
For eBay Motors Vehicle listings, TotalTransactionPrice is the deposit amount.
Applicable to Half.com (for GetOrders).
See the Field Index to learn which calls use TotalTransactionPrice.
Unique identifier for an eBay order line item. An order line item is created once there is a commitment from a buyer to purchase an item. Since an auction listing can only have one order line item during the duration of the listing, the TransactionID for auction listings is always 0. Along with its corresponding ItemID, a TransactionID is used and referenced during an order checkout flow and after checkout has been completed.
Applicable to Half.com (for GetOrders only).
See the Field Index to learn which calls use TransactionID.
This price is returned only for Best Offer items. This amount does not take into account shipping, sales tax, and other costs related to the order line item. If multiple units were purchased through Best Offer, this value is the per-unit price.
For eBay Motors Vehicle listings, TransactionPrice is the deposit amount.
Applicable to Half.com (for GetOrders).
See the Field Index to learn which calls use TransactionPrice.
Container consisting of details related to the type and status of an Unpaid Item case. This container is only returned if there is an open or closed Unpaid Item case associated with the order line item.
See the Field Index to learn which calls use UnpaidItem.
In a fixed-priced listing, a seller can offer variations of the same item. For example, the seller could create a fixed-priced listing for a t-shirt design and offer the shirt in different colors and sizes. In this case, each color and size combination is a separate variation. Each variation can have a different quantity and price. Due to the possible price differentiation, buyers can buy multiple items from this listing at the same time, but all of the items must be of the same variation. One order line item is created whether one or multiple items of the same variation are purchased.
The Variation node contains information about which variation was purchased. Therefore, applications that process orders should always check to see if this node is present.
See the Field Index to learn which calls use Variation.
