finances API1.9.0

getTransactions

GET

/transaction

This method allows a seller to retrieve one or monetary transactions. In this case, 'monetary transactions' include sales orders, buyer refunds, seller credits, buyer-initiated payment disputes, eBay shipping label purchases, and transfers. There are numerous input filters available for use, including filters to retrieve specific types of monetary transactions, to retrieve monetary transactions processed within a specific date range, or to retrieve monetary transactions in a specific state. See the filter field for more information on each filter, and how each one is used.

There are also pagination and sort query parameters that allow users to further control the monetary transactions that are returned in the response.

If no monetary transactions match the input criteria, an http status code of 204 No Content is returned with no response payload.

Input

Resource URI (production)

GET https://apiz.ebay.com/sell/finances/v1/transaction?

URI parameters

Parameter	Type	Description
limit	integer	The number of monetary transactions to return per page of the result set. Use this parameter in conjunction with the offset parameter to control the pagination of the output. For example, if offset is set to `10` and limit is set to `10`, the method retrieves monetary transactions 11 thru 20 from the result set. Note: This feature employs a zero-based list, where the first item in the list has an offset of `0`. If an orderId, transactionId, or payoutId filter is included in the request, any limit value will be ignored. Maximum: `1000` Default: `20` Occurrence: Optional
offset	integer	This integer value indicates the actual position that the first monetary transaction returned on the current page has in the results set. So, if you wanted to view the 11th monetary transaction of the result set, you would set the offset value in the request to `10`. In the request, you can use the offset parameter in conjunction with the limit parameter to control the pagination of the output. For example, if offset is set to `30` and limit is set to `10`, the method retrieves transactions 31 thru 40 from the resulting collection of transactions. Note: This feature employs a zero-based list, where the first item in the list has an offset of `0`. Default: `0` (zero) Occurrence: Optional
filter	array of FilterField	Numerous filters are available for the getTransactions method, and these filters are discussed below. One or more of these filter types can be used. If none of these filters are used, all monetary transactions from the last 90 days are returned: transactionDate: search for monetary transactions that occurred within a specific range of dates. Note: All dates must be input using UTC format (`YYYY-MM-DDTHH:MM:SS.SSSZ`) and should be adjusted accordingly for the local timezone of the user. Below is the proper syntax to use if filtering by a date range: `https://apiz.ebay.com/sell/finances/v1/transaction?filter=transactionDate:[2018-10-23T00:00:01.000Z..2018-11-09T00:00:01.000Z]` Alternatively, the user could omit the ending date, and the date range would include the starting date and up to 90 days past that date, or the current date if the starting date is less than 90 days in the past. transactionType: search for a specific type of monetary transaction. The supported transactionType values are as follows: `SALE`: a sales order. `REFUND`: a refund to the buyer after an order cancellation or return. `CREDIT`: a credit issued by eBay to the seller's account. `DISPUTE`: a monetary transaction associated with a payment dispute between buyer and seller. `NON_SALE_CHARGE`: a monetary transaction involving a seller transferring money to eBay for the balance of a charge for NON_SALE_CHARGE transactions (transactions that contain non-transactional seller fees). These can include a one-time payment, monthly/yearly subscription fees charged monthly, NRC charges, and fee credits. `SHIPPING_LABEL`: a monetary transaction where eBay is billing the seller for an eBay shipping label. Note that the shipping label functionality will initially only be available to a select number of sellers. `TRANSFER`: A transfer is a monetary transaction where eBay is billing the seller for reimbursement of a charge. An example of a transfer is a seller reimbursing eBay for a buyer refund. `ADJUSTMENT`: An adjustment is a monetary transaction where eBay is crediting or debiting the seller's account. Below is the proper syntax to use if filtering by a monetary transaction type: `https://apiz.ebay.com/sell/finances/v1/transaction?filter=transactionType:{SALE}` transactionStatus: this filter type is only applicable for sales orders, and allows the user to filter seller payouts in a particular state. The supported transactionStatus values are as follows: `PAYOUT`: this indicates that the proceeds from the corresponding sales order has been paid out to the seller's account. `FUNDS_PROCESSING`: this indicates that the funds for the corresponding monetary transaction are currently being processed. `FUNDS_AVAILABLE_FOR_PAYOUT`: this indicates that the proceeds from the corresponding sales order are available for a seller payout, but processing has not yet begun. `FUNDS_ON_HOLD`: this indicates that the proceeds from the corresponding sales order are currently being held by eBay, and are not yet available for a seller payout. `COMPLETED`: this indicates that the funds for the corresponding `TRANSFER` monetary transaction have transferred and the transaction has completed. `FAILED`: this indicates the process has failed for the corresponding `TRANSFER` monetary transaction. Below is the proper syntax to use if filtering by transaction status: `https://apiz.ebay.com/sell/finances/v1/transaction?filter=transactionStatus:{PAYOUT}` buyerUsername: the eBay user ID of the buyer involved in the monetary transaction. Only monetary transactions involving this buyer are returned. Below is the proper syntax to use if filtering by a specific eBay buyer: `https://apiz.ebay.com/sell/finances/v1/transaction?filter=buyerUsername:{buyer1234}` salesRecordReference: the unique Selling Manager identifier of the order involved in the monetary transaction. Only monetary transactions involving this Selling Manager Sales Record ID are returned. Below is the proper syntax to use if filtering by a specific Selling Manager Sales Record ID: `https://apiz.ebay.com/sell/finances/v1/transaction?filter=salesRecordReference:{123}` Note: For all orders originating after February 1, 2020, a value of `0` will be returned in the salesRecordReference field. So, this filter will only be useful to retrieve orders than occurred before this date. payoutId: the unique identifier of a seller payout. This value is auto-generated by eBay once the seller payout is set to be processed. Only monetary transactions involving this Payout ID are returned. Below is the proper syntax to use if filtering by a specific Payout ID: `https://apiz.ebay.com/sell/finances/v1/transaction?filter=payoutId:{5******8}` transactionId: the unique identifier of a monetary transaction. For a sales order, the orderId filter should be used instead. Only the monetary transaction defined by the identifier is returned. Note: This filter cannot be used alone; the transactionType** must also be specified when filtering by transaction ID. Below is the proper syntax to use if filtering by a specific transaction ID: `https://apiz.ebay.com/sell/finances/v1/transaction?filter=transactionId:{0-00-33}&filter=transactionType:{SALE}` orderId: the unique identifier of a sales order. For any other monetary transaction, the transactionId* filter should be used instead. Only the sales order defined by the identifier is returned. Below is the proper syntax to use if filtering by a specific order ID: `https://apiz.ebay.com/sell/finances/v1/transaction?filter=orderId:{0-00-3*3}` Occurrence: Optional
sort	array of SortField	Sorting is not yet available for the getTransactions method. By default, monetary transactions that match the input criteria are sorted in descending order according to the transaction date. Occurrence: Optional

HTTP request headers

All requests made to eBay REST operations require you to provide the Authorization HTTP header for authentication authorization.

This call conditionally requires the Accept:application/json and the X-EBAY-C-MARKETPLACE-ID headers.

The Accept header indicates the formats the client accepts for the response. This header pairs with the Content-Type header, which specifies the format required by eBay for the request. Currently, all eBay REST interfaces require request bodies to be formatted in JSON, and JSON is the default and only format returned in response bodies.

The X-EBAY-C-MARKETPLACE-ID header identifies the user's business context. See https://developer.ebay.com/managed-payments for supported marketplaces. If not included with your request, the marketplace value defaults to EBAY-US. Note that it does not indicate a language preference or end-user location.

Example:
X-EBAY-C-MARKETPLACE-ID: EBAY-US
Accept:application/json

This method has no additional required headers. See HTTP request headers- opens rest request components page for details.

OAuth scope

This request requires an access token created with the authorization code grant flow, using one or more scopes from the following list (please check your Application Keys page for a list of OAuth scopes available to your application):

https://api.ebay.com/oauth/api_scope/sell.finances

See OAuth access tokens for more information.

Request payload

This call has no payload.

Request fields

This call has no field definitions.

Output

HTTP response headers

This call has no response headers.

Response payload

Copy complete valid JSON to Clipboard

{ /* Transactions */

"href" : "string",

"limit" : "integer",

"next" : "string",

"offset" : "integer",

"prev" : "string",

"total" : "integer",

"transactions" : [

{ /* Transaction */

"amount" :

{ /* Amount */

"currency" : "CurrencyCodeEnum : [AED,AFN,ALL...]",

"convertedFromCurrency" : "CurrencyCodeEnum : [AED,AFN,ALL...]",

"convertedFromValue" : "string",

"exchangeRate" : "string",

"value" : "string"

"bookingEntry" : "BookingEntryEnum : [CREDIT,DEBIT]",

"buyer" :

{ /* Buyer */

"username" : "string"

"feeType" : "FeeTypeEnum : [AD_FEE,AUCTION_END_EARLY_FEE,BELOW_STANDARD_FEE...]",

"orderId" : "string",

"orderLineItems" : [

{ /* OrderLineItem */

"feeBasisAmount" :

{ /* Amount */

"currency" : "CurrencyCodeEnum : [AED,AFN,ALL...]",

"convertedFromCurrency" : "CurrencyCodeEnum : [AED,AFN,ALL...]",

"convertedFromValue" : "string",

"exchangeRate" : "string",

"value" : "string"

"lineItemId" : "string",

"marketplaceFees" : [

{ /* Fee */

"amount" :

{ /* Amount */

"currency" : "CurrencyCodeEnum : [AED,AFN,ALL...]",

"convertedFromCurrency" : "CurrencyCodeEnum : [AED,AFN,ALL...]",

"convertedFromValue" : "string",

"exchangeRate" : "string",

"value" : "string"

"feeMemo" : "string",

"feeType" : "FeeTypeEnum : [AD_FEE,AUCTION_END_EARLY_FEE,BELOW_STANDARD_FEE...]"

}

]

}

"paymentsEntity" : "string",

"payoutId" : "string",

"references" : [

{ /* Reference */

"referenceId" : "string",

"referenceType" : "ReferenceTypeEnum : [CANCELLATION_ID,CASE_ID,INVOICE...]"

}

"salesRecordReference" : "string",

"totalFeeBasisAmount" : "Amount",

"totalFeeAmount" : "Amount",

"transactionDate" : "string",

"transactionId" : "string",

"transactionMemo" : "string",

"transactionStatus" : "TransactionStatusEnum : [FUNDS_ON_HOLD,FUNDS_PROCESSING,FUNDS_AVAILABLE_FOR_PAYOUT...]",

"transactionType" : "TransactionTypeEnum : [SALE,REFUND,CREDIT...]"

}

]

}

Response fields

Output container/field	Type	Description
href	string	The URI of the getTransactions method request that produced the current page of the result set. Occurrence: Always
limit	integer	The maximum number of monetary transactions that may be returned per page of the result set. The limit value can be passed in as a query parameter, or if omitted, its value defaults to `20`. Note: If this is the last or only page of the result set, the page may contain fewer monetary transactions than the limit value. To determine the number of pages in a result set, divide the total value (total number of monetary transactions matching input criteria) by this limit value, and then round up to the next integer. For example, if the total value was `120` (120 total monetary transactions) and the limit value was `50` (show 50 monetary transactions per page), the total number of pages in the result set is three, so the seller would have to make three separate getTransactions calls to view all monetary transactions matching the input criteria. Maximum: `200` Default: `20` Occurrence: Always
next	string	The getTransactions method URI to use if you wish to view the next page of the result set. This field is only returned if there is a next page of results to view based on the current input criteria. Occurrence: Conditional
offset	integer	This integer value indicates the actual position that the first monetary transaction returned on the current page has in the results set. So, if you wanted to view the 11th monetary transaction of the result set, you would set the offset value in the request to `10`. In the request, you can use the offset parameter in conjunction with the limit parameter to control the pagination of the output. For example, if offset is set to `30` and limit is set to `10`, the method retrieves monetary transactions 31 thru 40 from the resulting collection of monetary transactions. Note: This feature employs a zero-based list, where the first item in the list has an offset of `0`. Default: `0` (zero) Occurrence: Always
prev	string	The getTransactions method URI to use if you wish to view the previous page of the result set. This field is only returned if there is a previous page of results to view based on the current input criteria. Occurrence: Conditional
total	integer	This integer value is the total amount of monetary transactions in the result set based on the current input criteria. Based on the total number of monetary transactions that match the criteria, and on the limit and offset values, there may be additional pages in the results set. Occurrence: Always
transactions	array of Transaction	An array of one or more monetary transactions that match the input criteria. Details for each monetary transaction may include the unique identifier of the order associated with the monetary transaction, the status of the transaction, the amount of the order, the order's buyer, and the unique identifier of the payout (if a payout has been initiated/issued for the order). Occurrence: Always
transactions.amount	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. Occurrence: Always
transactions.amount.currency	CurrencyCodeEnum	A three-letter ISO 4217 code that indicates the currency of the amount in the value field. This field is always returned with any container using Amount type. Default: The currency of the authenticated user's country. Occurrence: Conditional
transactions.amount.convertedFromCurrency	CurrencyCodeEnum	The three-letter ISO 4217 code representing the currency of the amount in the convertedFromValue field. This value is the pre-conversion currency. This field is only returned if/when currency conversion was applied by eBay. Occurrence: Conditional
transactions.amount.convertedFromValue	string	The monetary amount before any conversion is performed, in the currency specified by the convertedFromCurrency field. This value is the pre-conversion amount. The value field contains the converted amount of this value, in the currency specified by the currency field. This field is only returned if/when currency conversion was applied by eBay. Occurrence: Conditional
transactions.amount.exchangeRate	string	The exchange rate used for the monetary conversion. This field shows the exchange rate used to convert the dollar value in the value field from the dollar value in the convertedFromValue field. This field is only returned when eBay does a currency version, and a currency conversion is generally needed if the buyer is viewing, or has purchased an item on an international site. This field is only returned if/when currency conversion was applied by eBay. Occurrence: Conditional
transactions.amount.value	string	The monetary amount, in the currency specified by the currency field. This field is always returned with any container using Amount type. Occurrence: Conditional
transactions.bookingEntry	BookingEntryEnum	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. Occurrence: Always
transactions.buyer	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. Occurrence: Conditional
transactions.buyer.username	string	The eBay user ID of the order's buyer. Occurrence: Always
transactions.feeType	FeeTypeEnum	The type of fee. Occurrence: Conditional
transactions.orderId	string	The unique identifier of the eBay order associated with the monetary transaction. Occurrence: Conditional
transactions.orderLineItems	array of OrderLineItem	This array shows the fees that are deducted from a seller payout for each line item in an order. Occurrence: Conditional
transactions.orderLineItems.feeBasisAmount	Amount	This is the total amount of fees accrued for the order line item and deducted from a seller payout. All of the fees under the marketplaceFees container should equal this amount. Occurrence: Conditional
transactions.orderLineItems.feeBasisAmount.currency	CurrencyCodeEnum	A three-letter ISO 4217 code that indicates the currency of the amount in the value field. This field is always returned with any container using Amount type. Default: The currency of the authenticated user's country. Occurrence: Conditional
transactions.orderLineItems.feeBasisAmount.convertedFromCurrency	CurrencyCodeEnum	The three-letter ISO 4217 code representing the currency of the amount in the convertedFromValue field. This value is the pre-conversion currency. This field is only returned if/when currency conversion was applied by eBay. Occurrence: Conditional
transactions.orderLineItems.feeBasisAmount.convertedFromValue	string	The monetary amount before any conversion is performed, in the currency specified by the convertedFromCurrency field. This value is the pre-conversion amount. The value field contains the converted amount of this value, in the currency specified by the currency field. This field is only returned if/when currency conversion was applied by eBay. Occurrence: Conditional
transactions.orderLineItems.feeBasisAmount.exchangeRate	string	The exchange rate used for the monetary conversion. This field shows the exchange rate used to convert the dollar value in the value field from the dollar value in the convertedFromValue field. This field is only returned when eBay does a currency version, and a currency conversion is generally needed if the buyer is viewing, or has purchased an item on an international site. This field is only returned if/when currency conversion was applied by eBay. Occurrence: Conditional
transactions.orderLineItems.feeBasisAmount.value	string	The monetary amount, in the currency specified by the currency field. This field is always returned with any container using Amount type. Occurrence: Conditional
transactions.orderLineItems.lineItemId	string	The unique identifier of an order line item. Occurrence: Conditional
transactions.orderLineItems.marketplaceFees	array of Fee	An array of all fees accrued for the order line item and deducted from a seller payout. Occurrence: Conditional
transactions.orderLineItems.marketplaceFees.amount	Amount	The amount of the fee. Occurrence: Conditional
transactions.orderLineItems.marketplaceFees.amount.currency	CurrencyCodeEnum	A three-letter ISO 4217 code that indicates the currency of the amount in the value field. This field is always returned with any container using Amount type. Default: The currency of the authenticated user's country. Occurrence: Conditional
transactions.orderLineItems.marketplaceFees.amount.convertedFromCurrency	CurrencyCodeEnum	The three-letter ISO 4217 code representing the currency of the amount in the convertedFromValue field. This value is the pre-conversion currency. This field is only returned if/when currency conversion was applied by eBay. Occurrence: Conditional
transactions.orderLineItems.marketplaceFees.amount.convertedFromValue	string	The monetary amount before any conversion is performed, in the currency specified by the convertedFromCurrency field. This value is the pre-conversion amount. The value field contains the converted amount of this value, in the currency specified by the currency field. This field is only returned if/when currency conversion was applied by eBay. Occurrence: Conditional
transactions.orderLineItems.marketplaceFees.amount.exchangeRate	string	The exchange rate used for the monetary conversion. This field shows the exchange rate used to convert the dollar value in the value field from the dollar value in the convertedFromValue field. This field is only returned when eBay does a currency version, and a currency conversion is generally needed if the buyer is viewing, or has purchased an item on an international site. This field is only returned if/when currency conversion was applied by eBay. Occurrence: Conditional
transactions.orderLineItems.marketplaceFees.amount.value	string	The monetary amount, in the currency specified by the currency field. This field is always returned with any container using Amount type. Occurrence: Conditional
transactions.orderLineItems.marketplaceFees.feeMemo	string	A description of the fee that was deducted from the seller payout. Occurrence: Conditional
transactions.orderLineItems.marketplaceFees.feeType	FeeTypeEnum	The enumeration value returned here indicates the type of fee that was deducted from the seller payout. Occurrence: Conditional
transactions.paymentsEntity	string	This string value indicates the entity that is processing the payment. Occurrence: Conditional
transactions.payoutId	string	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. Occurrence: Conditional
transactions.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). Occurrence: Conditional
transactions.references.referenceId	string	The identifier of the transaction as specified by the referenceType. For example, with a referenceType of item_id, the referenceId refers to a unique item. This item may have several `NON_SALE_CHARGE` transactions. Occurrence: Conditional
transactions.references.referenceType	ReferenceTypeEnum	An enumeration value that identifies the reference type associated with the referenceId. Occurrence: Conditional
transactions.salesRecordReference	string	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. Occurrence: Always
transactions.totalFeeBasisAmount	Amount	This amount is the total amount of the order before selling fees are deducted from the seller payout associated with the order. To determine the actual amount of the order that will be paid out through a seller payout, deduct the totalFeeAmount from the basePayoutAmount. Occurrence: Conditional
transactions.totalFeeAmount	Amount	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). Occurrence: Conditional
transactions.transactionDate	string	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`. Occurrence: Always
transactions.transactionId	string	The 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. Occurrence: Always
transactions.transactionMemo	string	This field provides more details on shipping label transactions and transactions where the funds are being held by eBay. For shipping label transactions, the transactionMemo gives details about a purchase, a refund, or a price adjustment to the cost of the shipping label. For on-hold transactions, the transactionMemo 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"). This field is only returned if applicable/available. Occurrence: Conditional
transactions.transactionStatus	TransactionStatusEnum	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. Occurrence: Always
transactions.transactionType	TransactionTypeEnum	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. Occurrence: Always

HTTP status codes

This call can return one of the following HTTP status codes. For an overview of the status codes, see HTTP status codes in Using eBay RESTful APIs.

Status	Meaning
200	Success
204	No Content
400	Bad Request
500	Internal Server Error

Error codes

For more on errors, plus the codes of other common errors, see Handling errors.

Code	Domain	Category	Meaning
135000	API_FINANCES	APPLICATION	There was a problem with an eBay internal system or process. Contact eBay developer support for assistance.
135003	API_FINANCES	REQUEST	The value of pagination is invalid.
135005	API_FINANCES	REQUEST	The value of sorting is invalid.
135006	API_FINANCES	REQUEST	The value of transaction type filter is invalid.
135007	API_FINANCES	REQUEST	The value of transaction status filter is invalid.
135008	API_FINANCES	REQUEST	The value of transaction date filter is invalid.
135009	API_FINANCES	REQUEST	Transaction type filter is missing.

Warnings

This call has no warnings.

Samples

New to making API calls? Please see Making a Call.

Note: Identifiers, such as order IDs or user IDs, and personal data in these samples might be anonymized or may no longer be active on eBay. If necessary, substitute current, relevant eBay data in your requests.

Sample 1: Get All Transactions

Sample 2: Get Sales Within a Date Range

Sample 3: Get Sales With Payment Holds

Sample 4: Get Refunds for Specific Buyer

Sample 5: Shipping Label Transactions

Sample 6: Get final value fees for an order

Sample 1: Get All Transactions

This call sample retrieves all recent monetary transactions. No filters, no sorting, and no pagination parameters are used.

Input

Only the GET HTTP method and the endpoint are used. No filter parameters, no sorting, and no pagination query parameters are used.

GET

https://apiz.ebay.com/sell/finances/v1/transaction

Output

The output returns details on 20 recent monetary transactions. Unless a sort query parameter is used, monetary transactions in a getTransactions response are sorted according to sale date in descending order (most recent sale first). Since no pagination query parameters were used, the limit value defaults to 20 (up to 20 payouts per page of the result set) and the offset value defaults to 0 (the first payout in the result set is shown first). Since the next field appears in the response, there are actually more than 20 monetary transactions to view, but the current page is only showing 20 since the limit value is 20. The next field contains the full call URI to use to retrieve the next page of the result set.

Each monetary transaction is identified with its transactionId value. This transactionId value is auto-generated by eBay as soon as a buyer purchases an item, or if there is a commitment to buy (e.g., a winning bidder of an auction). The transactionType value will either be SALE, REFUND, CREDIT, or TRANSFER. This particular response does not include any seller credits. If a payout has already been issued for a sale, the transactionStatus value will show PAYOUT, and the payoutId value will identify the payout. If the transactionStatus value shows FUNDS_ON_HOLD or FUNDS_PROCESSING for a sale, you will not see a payoutId field for that sale. If the transactionStatus value shows FUNDS_ON_HOLD, the transactionMemo provides information on the reason for the hold or when the hold will be released.

{
    "href": "https://apiz.ebay.com/sell/finances/v1/transaction?limit=20&offset=0",
    "next": "https://apiz.ebay.com/sell/finances/v1/transaction?limit=20&offset=20",
    "limit": 20,
    "offset": 0,
    "transactions": [
        {
            "transactionId": "R********2",
            "orderId": "0********1",
            "salesRecordReference": "4********1",
            "buyer": {
                "username": "r********2"
            },
            "transactionType": "TRANSFER",
            "amount": {
                "value": "25.9",
                "currency": "USD"
            },
            "bookingEntry": "DEBIT",
            "transactionDate": "2018-11-09T02:42:14.000Z",
            "transactionStatus": "COMPLETED",
            "paymentsEntity": "eBay Commerce Inc."
        },
        {
            "transactionId": "2********0",
            "orderId": "0********2",
            "salesRecordReference": "4********0",
            "buyer": {
                "username": "r********2"
            },
            "transactionType": "SALE",
            "amount": {
                "value": "207",
                "currency": "USD"
            },
            "bookingEntry": "CREDIT",
            "transactionDate": "2018-11-09T02:38:40.000Z",
            "transactionStatus": "FUNDS_ON_HOLD",
			"transactionMemo": "Awaiting delivery",
	    			"paymentsEntity": "eBay Commerce Inc."
        },
        {
            "transactionId": "7********8",
            "orderId": "0********2",
            "payoutId": "5*****8",
            "salesRecordReference": "4********9",
            "buyer": {
                "username": "r********2"
            },
            "transactionType": "SALE",
            "amount": {
                "value": "414",
                "currency": "USD"
            },
            "bookingEntry": "CREDIT",
            "transactionDate": "2018-11-01T04:25:16.000Z",
            "transactionStatus": "PAYOUT",
	    		  "paymentsEntity": "eBay Commerce Inc."
        },
        {
            "transactionId": "2********5",
            "orderId": "0********3",
            "payoutId": "5*****8",
            "salesRecordReference": "4********5",
            "buyer": {
                "username": "r********2"
            },
            "transactionType": "REFUND",
            "amount": {
                "value": "76.5",
                "currency": "USD"
            },
            "bookingEntry": "DEBIT",
            "transactionDate": "2018-10-31T11:27:19.000Z",
            "transactionStatus": "PAYOUT",
	    		  "paymentsEntity": "eBay Commerce Inc."
        },
        {
            "transactionId": "2********6",
            "orderId": "0********6",
            "payoutId": "5*****8",
            "salesRecordReference": "4********6",
            "buyer": {
                "username": "r********2"
            },
            "transactionType": "REFUND",
            "amount": {
                "value": "103.5",
                "currency": "USD"
            },
            "bookingEntry": "DEBIT",
            "transactionDate": "2018-10-31T11:21:37.000Z",
            "transactionStatus": "PAYOUT",
	    		  "paymentsEntity": "eBay Commerce Inc."
        },
        {
            "transactionId": "2********9",
            "orderId": "0********4",
            "payoutId": "5*****8",
            "salesRecordReference": "4********6",
            "buyer": {
                "username": "r********2"
            },
            "transactionType": "SALE",
            "amount": {
                "value": "207",
                "currency": "USD"
            },
            "bookingEntry": "CREDIT",
            "transactionDate": "2018-10-31T10:43:11.000Z",
            "transactionStatus": "PAYOUT",
	    		  "paymentsEntity": "eBay Commerce Inc."
        },
        {
            "transactionId": "2********4",
            "orderId": "0********8",
            "payoutId": "5*****8",
            "salesRecordReference": "4********5",
            "buyer": {
                "username": "r********2"
            },
            "transactionType": "SALE",
            "amount": {
                "value": "207",
                "currency": "USD"
            },
            "bookingEntry": "CREDIT",
            "transactionDate": "2018-10-31T10:41:03.000Z",
            "transactionStatus": "PAYOUT",
	    		  "paymentsEntity": "eBay Commerce Inc."
        },
        {
            "transactionId": "2********6",
            "orderId": "0********7",
            "salesRecordReference": "4********3",
            "buyer": {
                "username": "r********2"
            },
            "transactionType": "REFUND",
            "amount": {
                "value": "101.5",
                "currency": "USD"
            },
            "bookingEntry": "DEBIT",
            "transactionDate": "2018-10-31T10:27:27.000Z",
            "transactionStatus": "FUNDS_PROCESSING",
	    		  "paymentsEntity": "eBay Commerce Inc."
        },
        {
            "transactionId": "2********7",
            "orderId": "0********7",
            "salesRecordReference": "4********2",
            "buyer": {
                "username": "r********2"
            },
            "transactionType": "REFUND",
            "amount": {
                "value": "103.5",
                "currency": "USD"
            },
            "bookingEntry": "DEBIT",
            "transactionDate": "2018-10-31T10:21:59.000Z",
            "transactionStatus": "FUNDS_PROCESSING",
	    		  "paymentsEntity": "eBay Commerce Inc."
        },
        {
            "transactionId": "2********8",
            "orderId": "0********1",
            "salesRecordReference": "4********3",
            "buyer": {
                "username": "r********2"
            },
            "transactionType": "SALE",
            "amount": {
                "value": "207",
                "currency": "USD"
            },
            "bookingEntry": "CREDIT",
            "transactionDate": "2018-10-27T03:32:08.000Z",
            "transactionStatus": "FUNDS_PROCESSING",
	    		  "paymentsEntity": "eBay Commerce Inc."
        },
        {
            "transactionId": "2********7",
            "orderId": "0********1",
            "salesRecordReference": "4********2",
            "buyer": {
                "username": "r********2"
            },
            "transactionType": "SALE",
            "amount": {
                "value": "207",
                "currency": "USD"
            },
            "bookingEntry": "CREDIT",
            "transactionDate": "2018-10-26T06:26:45.000Z",
            "transactionStatus": "FUNDS_PROCESSING",
	    		  "paymentsEntity": "eBay Commerce Inc."
        },
        {
            "transactionId": "2********7",
            "orderId": "0********8",
            "salesRecordReference": "4********1",
            "buyer": {
                "username": "r********2"
            },
            "transactionType": "SALE",
            "amount": {
                "value": "207",
                "currency": "USD"
            },
            "bookingEntry": "CREDIT",
            "transactionDate": "2018-10-26T06:24:47.000Z",
            "transactionStatus": "FUNDS_PROCESSING",
	    		  "paymentsEntity": "eBay Commerce Inc."
        },
        {
            "transactionId": "2********8",
            "orderId": "0********1",
            "payoutId": "5*****4",
            "salesRecordReference": "4********0",
            "buyer": {
                "username": "r********2"
            },
            "transactionType": "SALE",
            "amount": {
                "value": "207",
                "currency": "USD"
            },
            "bookingEntry": "CREDIT",
            "transactionDate": "2018-10-26T06:20:17.000Z",
            "transactionStatus": "PAYOUT",
	    		  "paymentsEntity": "eBay Commerce Inc."
        },
        {
            "transactionId": "2********9",
            "orderId": "0********4",
            "payoutId": "5*****8",
            "salesRecordReference": "4********9",
            "buyer": {
                "username": "r********2"
            },
            "transactionType": "SALE",
            "amount": {
                "value": "207",
                "currency": "USD"
            },
            "bookingEntry": "CREDIT",
            "transactionDate": "2018-10-24T13:35:24.000Z",
            "transactionStatus": "PAYOUT",
	    		  "paymentsEntity": "eBay Commerce Inc."
        },
        {
            "transactionId": "2********4",
            "orderId": "0********4",
            "payoutId": "5*****8",
            "salesRecordReference": "4********8",
            "buyer": {
                "username": "r********2"
            },
            "transactionType": "SALE",
            "amount": {
                "value": "207",
                "currency": "USD"
            },
            "bookingEntry": "CREDIT",
            "transactionDate": "2018-10-24T13:34:21.000Z",
            "transactionStatus": "PAYOUT",
	    		  "paymentsEntity": "eBay Commerce Inc."
        },
        {
            "transactionId": "9********2",
            "orderId": "0********3",
            "payoutId": "5*****4",
            "salesRecordReference": "4********7",
            "buyer": {
                "username": "e********2"
            },
            "transactionType": "SALE",
            "amount": {
                "value": "6.74",
                "currency": "USD"
            },
            "bookingEntry": "CREDIT",
            "transactionDate": "2018-10-23T18:34:46.000Z",
            "transactionStatus": "PAYOUT",
	    		  "paymentsEntity": "eBay Commerce Inc."
        },
        {
            "transactionId": "9********8",
            "orderId": "0********2",
            "salesRecordReference": "4********6",
            "buyer": {
                "username": "e********2"
            },
            "transactionType": "SALE",
            "amount": {
                "value": "6.74",
                "currency": "USD"
            },
            "bookingEntry": "CREDIT",
            "transactionDate": "2018-10-23T18:32:35.000Z",
            "transactionStatus": "FUNDS_PROCESSING",
	    		  "paymentsEntity": "eBay Commerce Inc."
        },
        {
            "transactionId": "9********4",
            "orderId": "0********6",
            "salesRecordReference": "4********5",
            "buyer": {
                "username": "e********2"
            },
            "transactionType": "SALE",
            "amount": {
                "value": "6.74",
                "currency": "USD"
            },
            "bookingEntry": "CREDIT",
            "transactionDate": "2018-10-23T18:30:02.000Z",
            "transactionStatus": "FUNDS_PROCESSING",
	    		  "paymentsEntity": "eBay Commerce Inc."
        },
        {
            "transactionId": "9********7",
            "orderId": "0********8",
            "salesRecordReference": "4********4",
            "buyer": {
                "username": "e********2"
            },
            "transactionType": "SALE",
            "amount": {
                "value": "6.74",
                "currency": "USD"
            },
            "bookingEntry": "CREDIT",
            "transactionDate": "2018-10-23T18:27:11.000Z",
            "transactionStatus": "FUNDS_PROCESSING",
	    		  "paymentsEntity": "eBay Commerce Inc."
        },
        {
            "transactionId": "9********7",
            "orderId": "0********3",
            "salesRecordReference": "4********3",
            "buyer": {
                "username": "e********2"
            },
            "transactionType": "SALE",
            "amount": {
                "value": "6.74",
                "currency": "USD"
            },
            "bookingEntry": "CREDIT",
            "transactionDate": "2018-10-23T18:25:00.000Z",
            "transactionStatus": "FUNDS_PROCESSING",
	    		  "paymentsEntity": "eBay Commerce Inc."
        }
    ],
    "total": 20
}

Sample 2: Get Sales Within a Date Range

This call sample retrieves sales within a date range. Two filter parameters are used and configured to return sales within a stated date range.

Input

For this sample, two filter query parameters are used - one to filter by the transaction type of SALE, and one to filter within a date range. In this sample, the date range is between October 23 and November 9, 2018.

Below is the syntax to use for a non-date filter:

?filter=filter_type:{filter_value}

The syntax to use for a date range filter is slightly different, and is shown below. Notice the date range filter uses square brackets instead of curly brackets.

?filter=payoutDate:[YYYY-MM-DDTHH:MM:SS.SSSZ..YYYY-MM-DDTHH:MM:SS.SSSZ]

GET

https://apiz.ebay.com/sell/finances/v1/transaction?filter=transactionType:{SALE}&filter=transactionDate:[2018-10-23T00:00:01.000Z..2018-11-09T00:00:01.000Z]

Output

The output returns details on 16 sales that occurred within the specified date range. Since no pagination query parameters were used, the limit value defaults to 20 (up to 20 transactions per page of the result set) and the offset value defaults to 0 (the first transaction in the result set is shown first). Since only 16 successful sales transactions are returned, this response is showing all sales that occurred within the date range.

Each sales transaction is identified with its transactionId value. This transactionId value is auto-generated by eBay as soon as a buyer purchases an item, or if there is a commitment to buy (e.g., a winning bidder of an auction). For many of the sales transactions in this response, payouts have already been issued (the transactionStatus value shows PAYOUT, and the payoutId value identifies the payout. For other sales transactions, the transactionStatus value shows FUNDS_ON_HOLD or FUNDS_PROCESSING, which means the payout associated with the sales transaction has yet to occur. If the transactionStatus value shows FUNDS_ON_HOLD, the transactionMemo provides information on the reason for the hold or when the hold will be released.

{
    "href": "https://apiz.ebay.com/sell/finances/v1/transaction?filter=transactionType%3A%7BSALE%7D&limit=20&offset=0",
    "limit": 20,
    "offset": 0,
    "transactions": [
        {
            "transactionId": "2********2",
            "orderId": "0********1",
            "salesRecordReference": "4********1",
            "buyer": {
                "username": "r********2"
            },
            "transactionType": "SALE",
            "amount": {
                "value": "207",
                "currency": "USD"
            },
            "bookingEntry": "CREDIT",
            "transactionDate": "2018-11-09T02:42:14.000Z",
            "transactionStatus": "FUNDS_ON_HOLD",
			"transactionMemo": "Awaiting delivery",
	    "paymentsEntity": "eBay Commerce Inc."
        },
        {
            "transactionId": "2********0",
            "orderId": "0********2",
            "salesRecordReference": "4********0",
            "buyer": {
                "username": "r********2"
            },
            "transactionType": "SALE",
            "amount": {
                "value": "207",
                "currency": "USD"
            },
            "bookingEntry": "CREDIT",
            "transactionDate": "2018-11-09T02:38:40.000Z",
            "transactionStatus": "FUNDS_ON_HOLD",
			"transactionMemo": "Awaiting delivery",
	    "paymentsEntity": "eBay Commerce Inc."
        },
        {
            "transactionId": "7********8",
            "orderId": "0********2",
            "payoutId": "5*****8",
            "salesRecordReference": "4********9",
            "buyer": {
                "username": "r********2"
            },
            "transactionType": "SALE",
            "amount": {
                "value": "414",
                "currency": "USD"
            },
            "bookingEntry": "CREDIT",
            "transactionDate": "2018-11-01T04:25:16.000Z",
            "transactionStatus": "PAYOUT",
	    "paymentsEntity": "eBay Commerce Inc."
        },
        {
            "transactionId": "2********9",
            "orderId": "0********6",
            "payoutId": "5*****8",
            "salesRecordReference": "4********6",
            "buyer": {
                "username": "r********2"
            },
            "transactionType": "SALE",
            "amount": {
                "value": "207",
                "currency": "USD"
            },
            "bookingEntry": "CREDIT",
            "transactionDate": "2018-10-31T10:43:11.000Z",
            "transactionStatus": "PAYOUT",
	    "paymentsEntity": "eBay Commerce Inc."
        },
        {
            "transactionId": "2********4",
            "orderId": "0********8",
            "payoutId": "5*****8",
            "salesRecordReference": "4********5",
            "buyer": {
                "username": "r********2"
            },
            "transactionType": "SALE",
            "amount": {
                "value": "207",
                "currency": "USD"
            },
            "bookingEntry": "CREDIT",
            "transactionDate": "2018-10-31T10:41:03.000Z",
            "transactionStatus": "PAYOUT",
	    "paymentsEntity": "eBay Commerce Inc."
        },
        {
            "transactionId": "2********8",
            "orderId": "0********7",
            "salesRecordReference": "4********3",
            "buyer": {
                "username": "r********2"
            },
            "transactionType": "SALE",
            "amount": {
                "value": "207",
                "currency": "USD"
            },
            "bookingEntry": "CREDIT",
            "transactionDate": "2018-10-27T03:32:08.000Z",
            "transactionStatus": "FUNDS_PROCESSING",
	    "paymentsEntity": "eBay Commerce Inc."
        },
        {
            "transactionId": "2********7",
            "orderId": "0********7",
            "salesRecordReference": "4********2",
            "buyer": {
                "username": "r********2"
            },
            "transactionType": "SALE",
            "amount": {
                "value": "207",
                "currency": "USD"
            },
            "bookingEntry": "CREDIT",
            "transactionDate": "2018-10-26T06:26:45.000Z",
            "transactionStatus": "FUNDS_PROCESSING",
	    "paymentsEntity": "eBay Commerce Inc."
        },
        {
            "transactionId": "2********7",
            "orderId": "0********8",
            "salesRecordReference": "4********1",
            "buyer": {
                "username": "r********2"
            },
            "transactionType": "SALE",
            "amount": {
                "value": "207",
                "currency": "USD"
            },
            "bookingEntry": "CREDIT",
            "transactionDate": "2018-10-26T06:24:47.000Z",
            "transactionStatus": "FUNDS_PROCESSING",
	    "paymentsEntity": "eBay Commerce Inc."
        },
        {
            "transactionId": "2********8",
            "orderId": "0********1",
            "payoutId": "5*****4",
            "salesRecordReference": "4********0",
            "buyer": {
                "username": "r********2"
            },
            "transactionType": "SALE",
            "amount": {
                "value": "207",
                "currency": "USD"
            },
            "bookingEntry": "CREDIT",
            "transactionDate": "2018-10-26T06:20:17.000Z",
            "transactionStatus": "PAYOUT",
	    "paymentsEntity": "eBay Commerce Inc."
        },
        {
            "transactionId": "2********9",
            "orderId": "0********4",
            "payoutId": "5*****8",
            "salesRecordReference": "4********9",
            "buyer": {
                "username": "r********2"
            },
            "transactionType": "SALE",
            "amount": {
                "value": "207",
                "currency": "USD"
            },
            "bookingEntry": "CREDIT",
            "transactionDate": "2018-10-24T13:35:24.000Z",
            "transactionStatus": "PAYOUT",
	    "paymentsEntity": "eBay Commerce Inc."
        },
        {
            "transactionId": "2********4",
            "orderId": "0********4",
            "payoutId": "5*****8",
            "salesRecordReference": "4********8",
            "buyer": {
                "username": "r********2"
            },
            "transactionType": "SALE",
            "amount": {
                "value": "207",
                "currency": "USD"
            },
            "bookingEntry": "CREDIT",
            "transactionDate": "2018-10-24T13:34:21.000Z",
            "transactionStatus": "PAYOUT",
	    "paymentsEntity": "eBay Commerce Inc."
        },
        {
            "transactionId": "9********2",
            "orderId": "0********3",
            "payoutId": "5*****4",
            "salesRecordReference": "4********7",
            "buyer": {
                "username": "e********2"
            },
            "transactionType": "SALE",
            "amount": {
                "value": "6.74",
                "currency": "USD"
            },
            "bookingEntry": "CREDIT",
            "transactionDate": "2018-10-23T18:34:46.000Z",
            "transactionStatus": "PAYOUT",
	    "paymentsEntity": "eBay Commerce Inc."
        },
        {
            "transactionId": "9********8",
            "orderId": "0********2",
            "salesRecordReference": "4********6",
            "buyer": {
                "username": "e********2"
            },
            "transactionType": "SALE",
            "amount": {
                "value": "6.74",
                "currency": "USD"
            },
            "bookingEntry": "CREDIT",
            "transactionDate": "2018-10-23T18:32:35.000Z",
            "transactionStatus": "FUNDS_PROCESSING",
	    "paymentsEntity": "eBay Commerce Inc."
        },
        {
            "transactionId": "9********4",
            "orderId": "0********6",
            "salesRecordReference": "4********5",
            "buyer": {
                "username": "e********2"
            },
            "transactionType": "SALE",
            "amount": {
                "value": "6.74",
                "currency": "USD"
            },
            "bookingEntry": "CREDIT",
            "transactionDate": "2018-10-23T18:30:02.000Z",
            "transactionStatus": "FUNDS_PROCESSING",
	    "paymentsEntity": "eBay Commerce Inc."
        },
        {
            "transactionId": "9********7",
            "orderId": "0********8",
            "salesRecordReference": "4********4",
            "buyer": {
                "username": "e********2"
            },
            "transactionType": "SALE",
            "amount": {
                "value": "6.74",
                "currency": "USD"
            },
            "bookingEntry": "CREDIT",
            "transactionDate": "2018-10-23T18:27:11.000Z",
            "transactionStatus": "FUNDS_PROCESSING",
	    "paymentsEntity": "eBay Commerce Inc."
        },
        {
            "transactionId": "9********7",
            "orderId": "0********3",
            "salesRecordReference": "4********3",
            "buyer": {
                "username": "e********2"
            },
            "transactionType": "SALE",
            "amount": {
                "value": "6.74",
                "currency": "USD"
            },
            "bookingEntry": "CREDIT",
            "transactionDate": "2018-10-23T18:25:00.000Z",
            "transactionStatus": "FUNDS_PROCESSING",
	    "paymentsEntity": "eBay Commerce Inc."
        }
    ],
    "total": 16
}

Sample 3: Get Sales With Payment Holds

This call sample retrieves sales with payment holds. Two filter parameters are used and configured to return sales with payment holds.

Input

For this sample, two filter query parameters are used - one to filter by the transaction type of SALE, and one to filter by the transaction status of FUNDS_ON_HOLD

Below is the syntax to use for a non-date filter:

?filter=filter_type:{filter_value}

GET

https://apiz.ebay.com/sell/finances/v1/transaction?filter=transactionType:{SALE}&filter=transactionStatus:{FUNDS_ON_HOLD}

Output

The output indicates that there are only two sales transactions where payout funds are on hold. The transactionMemo field gives more details on the reason for the hold or when the hold will be released. To get more information on payment holds, including the expected fund release date, the user can call getOrder.

{
    "href": "https://apiz.ebay.com/sell/finances/v1/transaction?filter=transactionStatus%3A%7BFUNDS_ON_HOLD%7D&limit=20&offset=0",
    "limit": 20,
    "offset": 0,
    "transactions": [
        {
            "transactionId": "2********2",
            "orderId": "0********1",
            "salesRecordReference": "4********1",
            "buyer": {
                "username": "r********2"
            },
            "transactionType": "SALE",
            "amount": {
                "value": "207",
                "currency": "USD"
            },
            "bookingEntry": "CREDIT",
            "transactionDate": "2018-11-09T02:42:14.000Z",
            "transactionStatus": "FUNDS_ON_HOLD",
			"transactionMemo": "Awaiting delivery",
	    "paymentsEntity": "eBay Commerce Inc."
        },
        {
            "transactionId": "2********0",
            "orderId": "0********2",
            "salesRecordReference": "4********0",
            "buyer": {
                "username": "r********2"
            },
            "transactionType": "SALE",
            "amount": {
                "value": "207",
                "currency": "USD"
            },
            "bookingEntry": "CREDIT",
            "transactionDate": "2018-11-09T02:38:40.000Z",
            "transactionStatus": "FUNDS_ON_HOLD",
			"transactionMemo": "Awaiting delivery",
	    "paymentsEntity": "eBay Commerce Inc."
        }
    ],
    "total": 2
}

Sample 4: Get Refunds for Specific Buyer

This call sample gets refunds for a specific buyer. Two filter parameters are used and configured to return refunds issued to a specific buyer.

Input

For this sample, two filter query parameters are used: one to filter by the transaction type of REFUND, and one to filter by the buyer's eBay user ID. For this particular call sample, the buyer's eBay user ID is r********2, so all refunds issued to this buyer by the are returned.

Below is the syntax to use for a non-date filter:

?filter=filter_type:{filter_value}

GET

https://apiz.ebay.com/sell/finances/v1/transaction?filter=transactionType:{REFUND}&filter=buyerUsername:{r********2}

Output

A total of four refunds to the buyer are part of the result set, as indicated by a value of 4 in the total field. The seller has already been paid out for two of the sales transactions where the buyer will receive a refund, but the seller is still waiting for the payouts for the two other sales transactions.

{
    "href": "https://apiz.ebay.com/sell/finances/v1/transaction?filter=transactionType%3A%7BREFUND%7D%2CbuyerUsername%3A%7Br********2%7D&limit=20&offset=0",
    "limit": 20,
    "offset": 0,
    "transactions": [
        {
            "transactionId": "2********5",
            "orderId": "0********3",
            "payoutId": "5*****8",
            "salesRecordReference": "4********5",
            "buyer": {
                "username": "r********2"
            },
            "transactionType": "REFUND",
            "amount": {
                "value": "76.5",
                "currency": "USD"
            },
            "bookingEntry": "DEBIT",
            "transactionDate": "2018-10-31T11:27:19.000Z",
            "transactionStatus": "PAYOUT",
	    "paymentsEntity": "eBay Commerce Inc."
        },
        {
            "transactionId": "2********6",
            "orderId": "0********6",
            "payoutId": "5*****8",
            "salesRecordReference": "4********6",
            "buyer": {
                "username": "r********2"
            },
            "transactionType": "REFUND",
            "amount": {
                "value": "103.5",
                "currency": "USD"
            },
            "bookingEntry": "DEBIT",
            "transactionDate": "2018-10-31T11:21:37.000Z",
            "transactionStatus": "PAYOUT",
	    "paymentsEntity": "eBay Commerce Inc."
        },
        {
            "transactionId": "2********6",
            "orderId": "0********7",
            "salesRecordReference": "4********3",
            "buyer": {
                "username": "r********2"
            },
            "transactionType": "REFUND",
            "amount": {
                "value": "101.5",
                "currency": "USD"
            },
            "bookingEntry": "DEBIT",
            "transactionDate": "2018-10-31T10:27:27.000Z",
            "transactionStatus": "FUNDS_PROCESSING",
	    "paymentsEntity": "eBay Commerce Inc."
        },
        {
            "transactionId": "2********7",
            "orderId": "0********7",
            "salesRecordReference": "4********2",
            "buyer": {
                "username": "r********2"
            },
            "transactionType": "REFUND",
            "amount": {
                "value": "103.5",
                "currency": "USD"
            },
            "bookingEntry": "DEBIT",
            "transactionDate": "2018-10-31T10:21:59.000Z",
            "transactionStatus": "FUNDS_PROCESSING",
	    "paymentsEntity": "eBay Commerce Inc."
        }
    ],
    "total": 4
}

Sample 5: Shipping Label Transactions

This call sample shows shipping label transactions, including a purchase of a shipping label, a refund for a shipping label, and a price adjustment for cost of shipping label.

Input

For this sample, a transactionType filter is used to retrieve only shipping label transactions. The value of the transactionType filter is set to SHIPPING_LABEL.

Below is the syntax to use for a non-date filter:

?filter=filter_type:{filter_value}

GET

https://apiz.ebay.com/sell/finances/v1/transaction?filter=transactionType:{SHIPPING_LABEL}

Output

A total of five shipping label transactions are part of the result set, as indicated by a value of 5 in the total field. The transactionMemo field gives more details on each shipping label transaction, and the bookingEntry field value indicates whether it is charge (debit) or credit to the seller.

{
	"href": "https://apiz.ebay.com/sell/finances/v1/transaction?filter=transactionType%3A%7BSHIPPING_LABEL%7D&limit=20&offset=0",
	"limit": 20,
	"offset": 0,
	"transactions": [
		{
				"transactionId": "2********0",
				"orderId": "0********3",
				"payoutId": "5*****3",
				"salesRecordReference": "0",
				"buyer": {
						"username": "r********1"
				},
				"transactionType": "SHIPPING_LABEL",
				"amount": {
						"value": "1.87",
						"currency": "USD"
				},
				"bookingEntry": "CREDIT",
				"transactionDate": "2020-02-10T07:51:10.000Z",
				"transactionStatus": "PAYOUT",
				"transactionMemo": "Refund - underpaid postage dispute accepted"
		},
		{
				"transactionId": "2********9",
				"orderId": "0********3",
				"payoutId": "5*****3",
				"salesRecordReference": "0",
				"buyer": {
						"username": "r********1"
				},
				"transactionType": "SHIPPING_LABEL",
				"amount": {
						"value": "3.08",
						"currency": "USD"
				},
				"bookingEntry": "DEBIT",
				"transactionDate": "2020-02-10T07:49:28.000Z",
				"transactionStatus": "PAYOUT",
				"transactionMemo": "Charge - underpaid postage"
		},
		{
				"transactionId": "2********9",
				"orderId": "0********3",
				"payoutId": "5*****3",
				"salesRecordReference": "0",
				"buyer": {
						"username": "r********1"
				},
				"transactionType": "SHIPPING_LABEL",
				"amount": {
						"value": "7.02",
						"currency": "USD"
				},
				"bookingEntry": "DEBIT",
				"transactionDate": "2020-02-08T00:25:26.000Z",
				"transactionStatus": "PAYOUT",
				"transactionMemo": "Shipping label purchased"
		},
		{
				"transactionId": "0********3",
				"payoutId": "5*****3",
				"salesRecordReference": "0",
				"buyer": {
						"username": "E********Y"
				},
				"transactionType": "SHIPPING_LABEL",
				"amount": {
						"value": "1.01",
						"currency": "USD"
				},
				"bookingEntry": "DEBIT",
				"transactionDate": "2020-02-07T09:04:12.000Z",
				"transactionStatus": "PAYOUT",
				"transactionMemo": "Charge - underpaid postage"
		},
		{
				"transactionId": "0********3",
				"payoutId": "5*****3",
				"salesRecordReference": "0",
				"buyer": {
						"username": "E********Y"
				},
				"transactionType": "SHIPPING_LABEL",
				"amount": {
						"value": "7.0",
						"currency": "USD"
				},
				"bookingEntry": "DEBIT",
				"transactionDate": "2020-02-07T09:03:16.000Z",
				"transactionStatus": "PAYOUT",
				"transactionMemo": "Shipping label purchased"
		}
	],
	"total": 5
}

Sample 6: Get final value fees for an order

This call sample shows final value fees for a specific order. An orderId value is used as a filter, so only transactions related to that sales order are returned.

Input

For this sample, orderId is include as a filter, and the seller wishes to retrieve all transactions related to the order ID 03-00011-61743.

GET

https://apiz.ebay.com/sell/finances/v1/transaction?filter=orderId:{0********3}

Output

Only one SALE transaction is returned for the order. The totalFeeBasisAmount is the total amount of the order used to calculate the seller's final value fees for the order. The total amount of seller fees deducted from a seller payout associated with the order is shown in the totalFeeAmount field. Line item-level information about seller fees are returned in the orderLineItems array. This particular order contains just one line item.

{
	"transactionId": "0********3",
	"orderId": "0********3",
	"payoutId": "5*****1",
	"salesRecordReference": "0",
	"buyer": {
			"username": "f********1"
	},
	"transactionType": "SALE",
	"amount": {
			"value": "500.9",
			"currency": "USD"
	},
	"totalFeeBasisAmount": {
			"value": "610.71",
			"currency": "USD"
	},
	"totalFeeAmount": {
			"value": "58.1",
			"currency": "USD"
	},
	"orderLineItems": [
			{
					"lineItemId": "1********3",
					"feeBasisAmount": {
							"value": "610.71",
							"currency": "USD"
					},
					"marketplaceFees": [
							{
									"feeType": "FINAL_VALUE_FEE_FIXED_PER_ORDER",
									"amount": {
											"value": "2.2",
											"currency": "USD"
									}
							},
							{
									"feeType": "FINAL_VALUE_FEE",
									"amount": {
											"value": "55.9",
											"currency": "USD"
									}
							}
					]
			}
	],
	"bookingEntry": "CREDIT",
	"transactionDate": "2020-06-01T10:16:35.000Z",
	"transactionStatus": "PAYOUT",
	"paymentsEntity": "eBay Commerce Inc."
}