Transaction

amount

This container shows the dollar value and currency type of the monetary transaction. This field is always returned even when eBay has yet to initiate a payout for the order.

bookingEntry

The enumeration value returned in this field indicates if the monetary transaction amount is a (CREDIT) or a (DEBIT) to the seller's account. Typically, the SALE and CREDIT transaction types are credits to the seller's account, and the REFUND, DISPUTE, SHIPPING_LABEL, and TRANSFER transaction types are debits to the seller's account.

buyer

This is the unique eBay user ID for the buyer who purchased the order. This field is not returned for TRANSFER monetary transaction types.

eBayCollectedTaxAmount

This is the amount of sales tax that has been collected by eBay for an order.

Note: Sales tax applies only to SALE and REFUND transactions (transactionType).

feeJurisdiction

This container stores information about region-specific fees that are charged to sellers.

This is returned for fees (i.e., FeeTypeEnum values,) that are mandated by a seller's governing jurisdiction.

For example:

• INCOME_TAX_WITHHOLDING
• TAX_DEDUCTION_AT_SOURCE
• VAT_WITHHOLDING

feeType

The enumeration value returned in this field indicates the type of fee that was deducted from the seller payout.

orderId

The unique identifier of the eBay order associated with the monetary transaction.

orderLineItems

array of OrderLineItem

This array either shows the order line item transactional fees related to a SALE transaction and deducted from the payout associated with that order, or it shows the transactional fee credits going back to the seller in the case of a REFUND transaction.

Note: In certain circumstances, transactional fees like FINAL_VALUE_FEE and FINAL_VALUE_FEE_FIXED_PER_ORDER are not deducted from a seller payout, but instead they are billed to the seller's account as "non-sale charges". When this happens, the SALE transaction entity will not have these fees under the orderLineItems array, but they will appear as separate NON_SALE_CHARGE transactions. When this happens, and you want to see those transactional fees for the order, one thing you can do is make another call to getTransactions and filter against the orderId. In the response, you will see the SALE transaction and the NON_SALE_CHARGE transactions applied against the order. See Sample 6: Get transactional fees for an order and Sample 10: Get non-sale charges for an order for examples.

paymentsEntity

This string value indicates the entity that is processing the payment.

payoutDetails

This container provides the payout details for a split-payout case. This container is only returned for split-payout use cases.

payoutId

The unique identifier of the seller payout associated with the monetary transaction. This identifier is generated once eBay begins processing the payout for the corresponding order. This field will not be returned if eBay has not yet begun processing the payout for an order.

This value can be used by the filter query parameter to get monetary transactions associated with the true(actual) payout associated with the PayoutId.

Note: In case of a split payout, always pick the first true(actual) payout id.

references

array of Reference

This field contains reference information for the transaction fee. This includes an ID and the type of ID provided (such as item ID).

salesRecordReference

The Sales Record Number associated with a sales order. Sales Record Numbers are Selling Manager/Selling Manager Pro identifiers that are created at order checkout.

Note: For all orders originating after February 1, 2020, a value of 0 will be returned in this field. The Sales Record Number field has also been removed from Seller Hub. Instead of salesRecordReference, depend on orderId instead as the identifier of the order. The salesRecordReference field has been scheduled for deprecation, and a date for when this field will no longer be returned at all will be announced soon.

taxes

array of Tax

This array shows the tax type and amount applicable to the transaction.

Note: Currently, this array is only returned for tax charged against a purchased eBay shipping label.

totalFeeAmount

This amount is the total amount of selling fees paid for order. A breakdown of fees for each order line item can be found in the orderLineItems array.

This field is even returned if it is 0.0 (no fees deducted from seller payout).

totalFeeBasisAmount

This amount is the total amount for the order before selling fees are deducted from the seller payout associated with the order.

transactionDate

This timestamp indicates when the monetary transaction (order purchase, buyer refund, seller credit) occurred. The following (UTC) format is used: YYYY-MM-DDTHH:MM:SS.SSSZ. For example, 2015-08-04T19:09:02.768Z.

transactionId

This field, when combined with the transactionType field, provide a unique identifier of the monetary transaction. A monetary transaction can be a sales order, an order refund to the buyer, a credit to the seller's account, a debit to the seller for the purchase of a shipping label, or a transaction where eBay recouped money from the seller if the seller lost a buyer-initiated payment dispute.

transactionMemo

This field applies to shipping label transactions, sales transactions where payout is on hold, and non-sale charge fees. The following are examples of how the field is used for each transaction type:

• Shipping label purchase: the transactionMemo field gives details about a purchase, a refund, or a price adjustment to the cost of the shipping label.
• Sales transactions with funds on hold: the transactionMemo field provides information on the reason for the hold or when the hold will be released (e.g., "Funds on hold. Estimated release on Jun 1").
• Non-sale charge fees: the transactionMemo field will provide the type of fee that was charged, such as Promoted Offsite Fee.

This field is only returned if applicable/available.

transactionStatus

This enumeration value indicates the current status of the seller payout associated with the monetary transaction. See the TransactionStatusEnum type for more information on the different states.

transactionType

This enumeration value indicates the type of monetary transaction. Examples of monetary transactions include a buyer's payment for an order, a refund to the buyer for a returned item or cancelled order, or a credit issued by eBay to the seller's account. For a complete list of monetary transaction types within the Finances API, see the TransactionTypeEnum type.