finances API1.0.0_alpha

Finances API

The Finances API is used by sellers in eBay's Managed Payments program to retrieve seller payout information. The data provided through this public API is similar to the data that the seller will see under the Payments tab of Seller Hub in My eBay. With eBay's Managed Payments program, eBay manages the entire payments process, including the available payment methods, and shortly after a buyer's payment clears, eBay distributes payouts directly to the seller's preferred bank account.

Below is a summary of the two resources and five operations available through the Finances API.

  • payout: a payout is distributed to the seller's bank account shortly after the buyer's payment for an order clears. A single seller payout may be for one order or numerous orders, depending on the number of orders paid for on a given day.
    • getPayout: this operation retrieves details on a specific payout. The unique identifier of the payout is needed to run this operation.
    • getPayouts: this operation retrieves details on multiple payouts. There are available filters to search for payouts processed within a date range, or sellers can search for payouts in different states (e.g., successful, failed, etc.). There are query parameters available for sorting and pagination control.
    • getPayoutSummary: this operation retrieves counts and dollar values for payouts, and the number of monetary transactions associated with the payouts. Similar to the getPayouts operation, this operation has filters to search for payouts processed within a date range, or payouts in different states (e.g., successful, failed, etc.).
  • transaction: in the Finances API, a "transaction" can be one of three things - a sales transaction (or order), a buyer refund, or a seller credit (issued by eBay). The transaction object contains identifiers for the order and payout, and the status and dollar value of the order/payout.
    • getTransactions: this operation retrieves details on one or more monetary transactions. There are available filters to search for transactions by type (sale, refund, or credit), transactions within a date range, transactions in different states, or sellers can search for a specific transaction according to order ID, payout ID, or buyer user name. There are query parameters available for sorting and pagination control.
    • getTransactionSummary: this operation retrieves counts and dollar values for payouts, seller credits, buyer refunds, and payment holds. Similar to the getTransactions operation, this operation has filters to search for transactions by type (sale, refund, or credit), transactions within a date range, transactions in different states, or sellers can search for a specific transaction according to order ID, payout ID, or buyer user name.

Finances API requirements and restrictions

The Finances API can be considered a 'standalone' API. Users do not have to be integrated with any other eBay public APIs in order to use the Finances API. The only user requirement is that the Seller must be opted in to the eBay Managed Payments Program. The getPaymentsProgram method of the Account API can be used to see if a seller is opted in to eBay Managed Payments.

Supported marketplaces

Currently, the eBay Managed Payments Program is only available to a limited number of US sellers, and the Finances API is only relevant and usable by those sellers. This program is expected to become available to Germany sellers later in 2019, and is expected to become available to more countries and more sellers in 2020. See the Spring 2019 Seller Update page for more information. This page includes a link that allows sellers to express their interest to eBay about joining the program.