Trading_TransactionType Class Reference

Inherits from	NSObject
Conforms to	PicoBindable
Declared in	Trading_TransactionType.h Trading_TransactionType.m

Overview

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.

@ingroup EBayAPIInterface

Tasks

amountPaid
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.
property
adjustmentAmount
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.
property
convertedAdjustmentAmount
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.
property
buyer
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).
property
shippingDetails
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).
property
convertedAmountPaid
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.
property
convertedTransactionPrice
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.
property
createdDate
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).
property
depositType
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.
property
item
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).
property
quantityPurchased
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, nonvariation 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).
property
status
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.
property
transactionID
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).
property
transactionPrice
The price of one order line item.

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).
property
bestOfferSale
Indicates whether or not the order line item was created
as the result of the seller accepting a Best Offer from a buyer.

Not applicable to Half.com.
property
vatPercent
VAT rate for the item. When the VATPercent is specified, the item’s VAT
information appears on the item’s listing page. In addition, the seller
can choose to print an invoice that includes the item’s net price, VAT
percent, VAT amount, and total price. Since VAT rates vary depending on the
item and on the user’s country of residence, a seller is responsible for
entering the correct VAT rate; it is not calculated by eBay. To specify a
VATPercent, a seller must have a VAT-ID registered with eBay and must be
listing the item on a VAT-enabled site. Max precision 3 decimal places. Max
length 5 characters. Note: The View Item page displays the precision to 2
decimal places with no trailing zeros. However, the full value you send in is
stored.

Not applicable to Half.com.
property
externalTransaction
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 DE and AT orders going through the new eBay payment process,
the PaymentHoldDetails container and PaymentHoldStatus
field will be returned instead of the ExternalTransaction container.

Not applicable to Half.com.
property
sellingManagerProductDetails
This container consists of Selling Manager product details and is only
returned if the item was listed through Selling Manager.

Not applicable to Half.com.
property
shippingServiceSelected
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.
property
buyerMessage
Display message from buyer. This field holds transient data that is only
being returned in Checkout related notifications.

Not applicable to Half.com.
property
dutchAuctionBid
Dutch auctions are deprecated.
property
buyerPaidStatus
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.
property
sellerPaidStatus
Specifies the paid status of the order.

Not applicable to Half.com.
property
paidTime
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](#//api/name/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.
property
shippedTime
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).
property
totalPrice
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.
property
feedbackLeft
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.
property
feedbackReceived
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.
property
containingOrder
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.
property
finalValueFee
A Final Value Fee is calculated and charged to a seller’s account
immediately upon creation of an order line item. Note that this fee is created
before the buyer makes a payment.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.
property
listingCheckoutRedirectPreference
ProStores listing level preferences regarding the store to which
checkout should be redirected for the listing if Item.ThirdPartyCheckout
is true.
property
refundArray
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
property
transactionSiteID
The site upon which the order line item (transaction) was created.
property
platform
Name of the eBay co-branded site upon which the order line item
(transaction) was created.
property
cartID
Unique identifier for an instance of Shopping.com shopping cart. This field is only
returned for Shopping.com order line items (transactions).
property
sellerContactBuyerByEmail
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.
property
payPalEmailAddress
The seller’s Paypal email address. This value is only revealed if it is the
seller making the call.
property
paisaPayID
Unique identifier for a PaisaPay transaction. Only applicable for the India
site (203) if PaisaPay was the payment method used.
property
buyerGuaranteePrice
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.
property
variation
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.
property
buyerCheckoutMessage
This field is returned if a buyer left a comment for the seller during the
left by buyer during the checkout flow.
property
totalTransactionPrice
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 nonvariation, fixed-price listing, consider this value the per-unit price. To get the total amount, multiply TotalTransactionPrice by the Transaction.QuantityPurchased value.

For eBay Motors Vehicle listings, TotalTransactionPrice is the deposit amount.

Applicable to Half.com (for GetOrders).
property
taxes
type : class Trading_TaxesType
property
bundlePurchase
Boolean value indicating whether or not an order line item is
part of a bundle purchase using Product Configurator.
property
actualShippingCost
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.

property
actualHandlingCost
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.
property
orderLineItemID
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.
property
paymentHoldDetails
Shipping hold details
property
sellerDiscounts
Seller Discounts
property
refundAmount
Partial or Full refund amount from seller to the buyer
property
refundStatus
Refund Status Notification to Seller (Success, Failure, Pending)
property
codiceFiscale
This field is returned if the IncludeCodeFiscale 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.
property
isMultiLegShipping
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.
property
multiLegShippingDetails
Contains details about the domestic leg of a Global Shipping Program shipment.

This information is not returned if IsMultilegShipping is false.
property
invoiceSentTime
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.
property
unpaidItem
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.
property
intangibleItem
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.
property
any
(public property)
property

Properties

actualHandlingCost

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.

@property (nonatomic, retain) Trading_AmountType *actualHandlingCost

Discussion

type : class Trading_AmountType

Declared In

Trading_TransactionType.h

actualShippingCost

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.

@property (nonatomic, retain) Trading_AmountType *actualShippingCost

Discussion

type : class Trading_AmountType

Declared In

Trading_TransactionType.h

adjustmentAmount

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.

@property (nonatomic, retain) Trading_AmountType *adjustmentAmount

Discussion

type : class Trading_AmountType

Declared In

Trading_TransactionType.h

amountPaid

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.

@property (nonatomic, retain) Trading_AmountType *amountPaid

Discussion

type : class Trading_AmountType

Declared In

Trading_TransactionType.h

any

(public property)

@property (nonatomic, retain) NSMutableArray *any

Discussion

(public property)

entry type : PicoAnyElement, wrapper for primitive anyelement

Declared In

Trading_TransactionType.h

bestOfferSale

Indicates whether or not the order line item was created
as the result of the seller accepting a Best Offer from a buyer.

Not applicable to Half.com.

@property (nonatomic, retain) NSNumber *bestOfferSale

Discussion

Indicates whether or not the order line item was created
as the result of the seller accepting a Best Offer from a buyer.

Not applicable to Half.com.

type : NSNumber, wrapper for primitive bool

Declared In

Trading_TransactionType.h

bundlePurchase

Boolean value indicating whether or not an order line item is
part of a bundle purchase using Product Configurator.

@property (nonatomic, retain) NSNumber *bundlePurchase

Discussion

Boolean value indicating whether or not an order line item is
part of a bundle purchase using Product Configurator.

type : NSNumber, wrapper for primitive bool

Declared In

Trading_TransactionType.h

buyer

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).

@property (nonatomic, retain) Trading_UserType *buyer

Discussion

type : class Trading_UserType

Declared In

Trading_TransactionType.h

buyerCheckoutMessage

This field is returned if a buyer left a comment for the seller during the
left by buyer during the checkout flow.

@property (nonatomic, retain) NSString *buyerCheckoutMessage

Discussion

This field is returned if a buyer left a comment for the seller during the
left by buyer during the checkout flow.

type : NSString, wrapper for primitive string

Declared In

Trading_TransactionType.h

buyerGuaranteePrice

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.

@property (nonatomic, retain) Trading_AmountType *buyerGuaranteePrice

Discussion

type : class Trading_AmountType

Declared In

Trading_TransactionType.h

buyerMessage

Display message from buyer. This field holds transient data that is only
being returned in Checkout related notifications.

Not applicable to Half.com.

@property (nonatomic, retain) NSString *buyerMessage

Discussion

Display message from buyer. This field holds transient data that is only
being returned in Checkout related notifications.

Not applicable to Half.com.

type : NSString, wrapper for primitive string

Declared In

Trading_TransactionType.h

buyerPaidStatus

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.

@property (nonatomic, retain) NSString *buyerPaidStatus

Discussion

type: string constant in Trading_PaidStatusCodeType.h

Declared In

Trading_TransactionType.h

cartID

Unique identifier for an instance of Shopping.com shopping cart. This field is only
returned for Shopping.com order line items (transactions).

@property (nonatomic, retain) NSString *cartID

Discussion

Unique identifier for an instance of Shopping.com shopping cart. This field is only
returned for Shopping.com order line items (transactions).

type : NSString, wrapper for primitive string

Declared In

Trading_TransactionType.h

codiceFiscale

This field is returned if the IncludeCodeFiscale 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.

@property (nonatomic, retain) NSString *codiceFiscale

Discussion

type : NSString, wrapper for primitive string

Declared In

Trading_TransactionType.h

containingOrder

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.

@property (nonatomic, retain) Trading_OrderType *containingOrder

Discussion

type : class Trading_OrderType

Declared In

Trading_TransactionType.h

convertedAdjustmentAmount

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.

@property (nonatomic, retain) Trading_AmountType *convertedAdjustmentAmount

Discussion

type : class Trading_AmountType

Declared In

Trading_TransactionType.h

convertedAmountPaid

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.

@property (nonatomic, retain) Trading_AmountType *convertedAmountPaid

Discussion

type : class Trading_AmountType

Declared In

Trading_TransactionType.h

convertedTransactionPrice

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.

@property (nonatomic, retain) Trading_AmountType *convertedTransactionPrice

Discussion

type : class Trading_AmountType

Declared In

Trading_TransactionType.h

createdDate

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).

@property (nonatomic, retain) NSDate *createdDate

Discussion

type : NSDate, wrapper for primitive date

Declared In

Trading_TransactionType.h

depositType

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.

@property (nonatomic, retain) NSString *depositType

Discussion

type: string constant in Trading_DepositTypeCodeType.h

Declared In

Trading_TransactionType.h

dutchAuctionBid

Dutch auctions are deprecated.

@property (nonatomic, retain) Trading_AmountType *dutchAuctionBid

Discussion

Dutch auctions are deprecated.

type : class Trading_AmountType

Declared In

Trading_TransactionType.h

externalTransaction

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 DE and AT orders going through the new eBay payment process,
the PaymentHoldDetails container and PaymentHoldStatus
field will be returned instead of the ExternalTransaction container.

Not applicable to Half.com.

@property (nonatomic, retain) NSMutableArray *externalTransaction

Discussion

entry type : class Trading_ExternalTransactionType

Declared In

Trading_TransactionType.h

feedbackLeft

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.

@property (nonatomic, retain) Trading_FeedbackInfoType *feedbackLeft

Discussion

type : class Trading_FeedbackInfoType

Declared In

Trading_TransactionType.h

feedbackReceived

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.

@property (nonatomic, retain) Trading_FeedbackInfoType *feedbackReceived

Discussion

type : class Trading_FeedbackInfoType

Declared In

Trading_TransactionType.h

finalValueFee

A Final Value Fee is calculated and charged to a seller’s account
immediately upon creation of an order line item. Note that this fee is created
before the buyer makes a payment.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.

@property (nonatomic, retain) Trading_AmountType *finalValueFee

Discussion

Not applicable to Half.com.

type : class Trading_AmountType

Declared In

Trading_TransactionType.h

intangibleItem

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.

@property (nonatomic, retain) NSNumber *intangibleItem

Discussion

type : NSNumber, wrapper for primitive bool

Declared In

Trading_TransactionType.h

invoiceSentTime

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.

@property (nonatomic, retain) NSDate *invoiceSentTime

Discussion

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.

type : NSDate, wrapper for primitive date

Declared In

Trading_TransactionType.h

isMultiLegShipping

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.

@property (nonatomic, retain) NSNumber *isMultiLegShipping

Discussion

type : NSNumber, wrapper for primitive bool

Declared In

Trading_TransactionType.h

item

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).

@property (nonatomic, retain) Trading_ItemType *item

Discussion

type : class Trading_ItemType

Declared In

Trading_TransactionType.h

listingCheckoutRedirectPreference

ProStores listing level preferences regarding the store to which
checkout should be redirected for the listing if Item.ThirdPartyCheckout
is true.

@property (nonatomic, retain) Trading_ListingCheckoutRedirectPreferenceType *listingCheckoutRedirectPreference

Discussion

ProStores listing level preferences regarding the store to which
checkout should be redirected for the listing if Item.ThirdPartyCheckout
is true.

type : class Trading_ListingCheckoutRedirectPreferenceType

Declared In

Trading_TransactionType.h

multiLegShippingDetails

Contains details about the domestic leg of a Global Shipping Program shipment.

This information is not returned if IsMultilegShipping is false.

@property (nonatomic, retain) Trading_MultiLegShippingDetailsType *multiLegShippingDetails

Discussion

Contains details about the domestic leg of a Global Shipping Program shipment.

This information is not returned if IsMultilegShipping is false.

type : class Trading_MultiLegShippingDetailsType

Declared In

Trading_TransactionType.h

orderLineItemID

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.

@property (nonatomic, retain) NSString *orderLineItemID

Discussion

type : NSString, wrapper for primitive string

Declared In

Trading_TransactionType.h

paidTime

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](#//api/name/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.

@property (nonatomic, retain) NSDate *paidTime

Discussion

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](#//api/name/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.

type : NSDate, wrapper for primitive date

Declared In

Trading_TransactionType.h

paisaPayID

Unique identifier for a PaisaPay transaction. Only applicable for the India
site (203) if PaisaPay was the payment method used.

@property (nonatomic, retain) NSString *paisaPayID

Discussion

Unique identifier for a PaisaPay transaction. Only applicable for the India
site (203) if PaisaPay was the payment method used.

type : NSString, wrapper for primitive string

Declared In

Trading_TransactionType.h

payPalEmailAddress

The seller’s Paypal email address. This value is only revealed if it is the
seller making the call.

@property (nonatomic, retain) NSString *payPalEmailAddress

Discussion

The seller’s Paypal email address. This value is only revealed if it is the
seller making the call.

type : NSString, wrapper for primitive string

Declared In

Trading_TransactionType.h

paymentHoldDetails

Shipping hold details

@property (nonatomic, retain) Trading_PaymentHoldDetailType *paymentHoldDetails

Discussion

Shipping hold details

type : class Trading_PaymentHoldDetailType

Declared In

Trading_TransactionType.h

platform

Name of the eBay co-branded site upon which the order line item
(transaction) was created.

@property (nonatomic, retain) NSString *platform

Discussion

Name of the eBay co-branded site upon which the order line item
(transaction) was created.

type: string constant in Trading_TransactionPlatformCodeType.h

Declared In

Trading_TransactionType.h

quantityPurchased

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, nonvariation 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).

@property (nonatomic, retain) NSNumber *quantityPurchased

Discussion

type : NSNumber, wrapper for primitive int

Declared In

Trading_TransactionType.h

refundAmount

Partial or Full refund amount from seller to the buyer

@property (nonatomic, retain) Trading_AmountType *refundAmount

Discussion

Partial or Full refund amount from seller to the buyer

type : class Trading_AmountType

Declared In

Trading_TransactionType.h

refundArray

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

@property (nonatomic, retain) Trading_RefundArrayType *refundArray

Discussion

type : class Trading_RefundArrayType

Declared In

Trading_TransactionType.h

refundStatus

Refund Status Notification to Seller (Success, Failure, Pending)

@property (nonatomic, retain) NSString *refundStatus

Discussion

Refund Status Notification to Seller (Success, Failure, Pending)

type : NSString, wrapper for primitive string

Declared In

Trading_TransactionType.h

sellerContactBuyerByEmail

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.

@property (nonatomic, retain) NSNumber *sellerContactBuyerByEmail

Discussion

type : NSNumber, wrapper for primitive bool

Declared In

Trading_TransactionType.h

sellerDiscounts

Seller Discounts

@property (nonatomic, retain) Trading_SellerDiscountsType *sellerDiscounts

Discussion

Seller Discounts

type : class Trading_SellerDiscountsType

Declared In

Trading_TransactionType.h

sellerPaidStatus

Specifies the paid status of the order.

Not applicable to Half.com.

@property (nonatomic, retain) NSString *sellerPaidStatus

Discussion

Specifies the paid status of the order.

Not applicable to Half.com.

type: string constant in Trading_PaidStatusCodeType.h

Declared In

Trading_TransactionType.h

sellingManagerProductDetails

This container consists of Selling Manager product details and is only
returned if the item was listed through Selling Manager.

Not applicable to Half.com.

@property (nonatomic, retain) Trading_SellingManagerProductDetailsType *sellingManagerProductDetails

Discussion

This container consists of Selling Manager product details and is only
returned if the item was listed through Selling Manager.

Not applicable to Half.com.

type : class Trading_SellingManagerProductDetailsType

Declared In

Trading_TransactionType.h

shippedTime

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).

@property (nonatomic, retain) NSDate *shippedTime

Discussion

type : NSDate, wrapper for primitive date

Declared In

Trading_TransactionType.h

shippingDetails

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).

@property (nonatomic, retain) Trading_ShippingDetailsType *shippingDetails

Discussion

type : class Trading_ShippingDetailsType

Declared In

Trading_TransactionType.h

shippingServiceSelected

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.

@property (nonatomic, retain) Trading_ShippingServiceOptionsType *shippingServiceSelected

Discussion

type : class Trading_ShippingServiceOptionsType

Declared In

Trading_TransactionType.h

status

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.

@property (nonatomic, retain) Trading_TransactionStatusType *status

Discussion

type : class Trading_TransactionStatusType

Declared In

Trading_TransactionType.h

taxes

type : class Trading_TaxesType

@property (nonatomic, retain) Trading_TaxesType *taxes

Discussion

type : class Trading_TaxesType

Declared In

Trading_TransactionType.h

totalPrice

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.

@property (nonatomic, retain) Trading_AmountType *totalPrice

Discussion

type : class Trading_AmountType

Declared In

Trading_TransactionType.h

totalTransactionPrice

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 nonvariation, fixed-price listing, consider this value the per-unit price. To get the total amount, multiply TotalTransactionPrice by the Transaction.QuantityPurchased value.

For eBay Motors Vehicle listings, TotalTransactionPrice is the deposit amount.

Applicable to Half.com (for GetOrders).

@property (nonatomic, retain) Trading_AmountType *totalTransactionPrice

Discussion

type : class Trading_AmountType

Declared In

Trading_TransactionType.h

transactionID

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).

@property (nonatomic, retain) NSString *transactionID

Discussion

type : NSString, wrapper for primitive string

Declared In

Trading_TransactionType.h

transactionPrice

The price of one order line item.

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).

@property (nonatomic, retain) Trading_AmountType *transactionPrice

Discussion

type : class Trading_AmountType

Declared In

Trading_TransactionType.h

transactionSiteID

The site upon which the order line item (transaction) was created.

@property (nonatomic, retain) NSString *transactionSiteID

Discussion

The site upon which the order line item (transaction) was created.

type: string constant in Trading_SiteCodeType.h

Declared In

Trading_TransactionType.h

unpaidItem

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.

@property (nonatomic, retain) Trading_UnpaidItemType *unpaidItem

Discussion

type : class Trading_UnpaidItemType

Declared In

Trading_TransactionType.h

variation

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.

@property (nonatomic, retain) Trading_VariationType *variation

Discussion

type : class Trading_VariationType

Declared In

Trading_TransactionType.h

vatPercent

VAT rate for the item. When the VATPercent is specified, the item’s VAT
information appears on the item’s listing page. In addition, the seller
can choose to print an invoice that includes the item’s net price, VAT
percent, VAT amount, and total price. Since VAT rates vary depending on the
item and on the user’s country of residence, a seller is responsible for
entering the correct VAT rate; it is not calculated by eBay. To specify a
VATPercent, a seller must have a VAT-ID registered with eBay and must be
listing the item on a VAT-enabled site. Max precision 3 decimal places. Max
length 5 characters. Note: The View Item page displays the precision to 2
decimal places with no trailing zeros. However, the full value you send in is
stored.

Not applicable to Half.com.

@property (nonatomic, retain) NSNumber *vatPercent

Discussion

type : NSNumber, wrapper for primitive double

Declared In

Trading_TransactionType.h