Skip to main content

GET/payout_settings

Important! Split-payout functionality is only available to mainland China sellers, who can split payouts between their Payoneer account and bank account. Card payouts are not currently available for sellers in mainland China.


This method returns details on two payment instruments defined on a seller's account, including the ID, type, status, nickname, last four digits of the account number, and payout percentage for the instruments.

Using the instrumentId returned with this method, sellers can makes changes to the payout split of the instruments with the updatePayoutPercentage method. Note that the instrumentStatus of a payment instrument, also returned using this method, must be ACTIVE in order to do split payouts on that payment instrument.

Input

Resource URI

GET https://api.ebay.com/sell/account/v2/payout_settings

This method is supported in Sandbox environment. To access the endpoint, just replace the api.ebay.com root URI with api.sandbox.ebay.com

URI parameters

This method has no URI parameters.

HTTP request headers

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

All other standard RESTful request headers are optional. For more information on standard RESTful request headers, see the HTTP request headers- opens rest request components page table.

OAuth scope

This request requires an access token created with the client credentials 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

Response fields

Output container/fieldTypeDescription
payoutInstrumentsarray of PayoutInstrument

This array provides details about the seller's accounts defined for the seller's account.

Payment accounts can only receive payouts if the status of the payout instrument is ACTIVE.

Occurrence: Always

payoutInstruments.accountLastFourDigitsstring

The last four digits of the account that the seller uses to receive payouts. This may be the last four digits of a bank account or a payment processor account such as Payoneer.

Occurrence: Always

payoutInstruments.instrumentIdstring

The unique reference identifier for a payout instrument. The instrumentId is needed to change the split-payout percentages through an updatePayoutPercentage request.

Occurrence: Always

payoutInstruments.instrumentStatusInstrumentStatusEnum

The status of a payout instrument. Valid payout instrument statuses include:

  • PENDING: This status indicates that the account must be verified before it can be used.
  • ACTIVE:This status indicates that payouts are enabled on this account.
  • VERIFICATION_FAILED: This status indicates that verification has failed for this account and payouts are disabled.
  • INACTIVE: This status indicates that this account has become inactive and payouts are disabled.

See InstrumentStatusEnum for more details on each instrument status value.

Note: Payment accounts can only receive payouts if the status of a payout instrument is ACTIVE.

Occurrence: Conditional

payoutInstruments.instrumentTypestring

The type of account that received payouts. The value returned in this field may be:

  • BANK: Indicates that the payout was made to a seller's bank account.
  • CARD (Not Currently Available): Indicates that the payout went to a seller's debit card.
  • The name of a digital wallet provider or payment processor (e.g., PAYONEER)

Note: Only Payoneer is currently supported for sellers in mainland China. Card payouts are not currently available for sellers in mainland China.

Occurrence: Always

payoutInstruments.nicknamestring

When instrumentType returns BANK, this value is the seller-provided nickname that the seller uses to represent the bank account that receives the payout.

When instrumentType returns CARD, this value is the debit card network for the debit card that receives the payout.

When instrumentType returns a provider of digital wallet or payment processing services, the value returned is the name of the service provider (e.g., PAYONEER)

Note: Only Payoneer is currently supported for sellers in mainland China. Card payouts are not currently available for sellers in mainland China.

Occurrence: Always

payoutInstruments.payoutPercentagestring

The current payout percentage allocated to an instrument. For example, 50 indicates that 50% of the payout goes to the instrument.

Occurrence: Conditional

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.

StatusMeaning
200Success
500Internal Server Error

Error codes

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

CodeDomainCategoryMeaning
395000API_ACCOUNTAPPLICATIONThere was a problem with an eBay internal system or process. Contact eBay developer support for assistance.

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 Payout Settings

This sample retrieves the information for two payout instruments for a seller.

Input

Only the GET HTTP method and the endpoint are used for this method.

GEThttps://api.ebay.com/sell/account/v2/payout_settings

Output

If the call is successful, the output returns the instrumentId, instrumentType, instrumentStatus, nickname, and accountLastFourDigits. If a payout percentage is set, payoutPercentage will be returned.