openapi: 3.0.0 info: title: eBay Account Advertising_eligibility Transfer API description: The Account API gives sellers the ability to configure their eBay seller accounts, including the seller's policies (eBay business policies and seller-defined custom policies), opt in and out of eBay seller programs, configure sales tax tables, and get account information.

For details on the availability of the methods in this API, see Account API requirements and restrictions. contact: name: eBay Inc, license: name: eBay API License Agreement url: https://go.developer.ebay.com/api-license-agreement version: v1.9.2 servers: - url: https://api.ebay.com{basePath} description: Production variables: basePath: default: /sell/account/v1 tags: - name: Transfer paths: /transfer/{transfer_Id}: get: tags: - Transfer description: '

Important! Due to EU & UK Payments regulatory requirements, an additional security verification via Digital Signatures is required for certain API calls that are made on behalf of EU/UK sellers, including all Finances API methods. Please refer to Digital Signatures for APIs to learn more on the impacted APIs and the process to create signatures to be included in the HTTP payload.


This method retrieves detailed information regarding a TRANSFER transaction type. A TRANSFER is a monetary transaction type that involves a seller transferring money to eBay for reimbursement of one or more charges. For example, when a seller reimburses eBay for a buyer refund.

If an ID is passed into the URI that is an identifier for another transaction type, this call will return an http status code of 404 Not found.' operationId: getTransfer parameters: - name: X-EBAY-C-MARKETPLACE-ID in: header description: This header identifies the seller's eBay marketplace.

See HTTP request headers for the marketplace ID values.

Note: If a marketplace ID value is not provided, the default value of EBAY_US is used. required: true schema: type: string - name: transfer_Id in: path description: This path parameter is used to specify the unique identifier of the TRANSFER transaction type you wish to retrieve.

Use the getTransactions method to retrieve this value by setting the transactionType filter to TRANSFER. The transfer_id value will then be returned in the transaction_id field of the response. required: true schema: type: string responses: '200': description: Success. content: application/json: schema: $ref: '#/components/schemas/Transfer' '400': description: Bad Request '404': description: Not found. x-response-codes: errors: '135012': domain: API_FINANCES category: REQUEST description: The transfer id was not found. '500': description: Internal Server Error x-response-codes: errors: '135000': domain: API_FINANCES category: APPLICATION description: There was a problem with an eBay internal system or process. Contact eBay developer support for assistance. security: - api_auth: - https://api.ebay.com/oauth/api_scope/sell.finances components: schemas: Amount: type: object properties: convertedFromCurrency: type: string description: 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. For implementation help, refer to eBay API documentation convertedFromValue: type: string description: 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. convertedToCurrency: type: string description: Note: This field is only applicable for Mainland China sellers with an available CNY Bank payment instrument. This response can only have a value of CNY.The three-letter ISO 4217 code representing the currency of the amount in the convertedToValue field.

This field is only returned for payouts to bank accounts when currency conversion was applied by eBay. For implementation help, refer to eBay API documentation convertedToValue: type: string description: Note: This field is only applicable for Mainland China sellers with an available CNY Bank payment instrument. This response only returns value in CNY.The monetary value after any conversion is performed, in the currency specified by the convertedToCurrency field. This value is the converted amount.

The field is only returned for payouts to bank accounts when currency conversion was applied by eBay. currency: type: string description: '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. For implementation help, refer to eBay API documentation' exchangeRate: type: string description: 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.

For sellers in mainland China, this field shows shows the exchange rate to convert the dollar value in the value field to the CNY value in the convertedToValue 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. value: type: string description: The monetary amount, in the currency specified by the currency field. This field is always returned with any container using Amount type. description: This type is used to express the dollar value and currency used for any transaction retrieved with the Finances API, including an order total, a seller payout, a buyer refund, or a seller credit. FundingSource: type: object properties: brand: type: string description: The brand name of the credit card or the name of the financial institution that is the source of payment. This field may not be populated for other funding sources. memo: type: string description: This field provides a note about the funding source. If the seller's credit card or bank account is the funding source, this field might contain the last four digits of the credit card or bank account. This field may also be returned as null. type: type: string description: 'The string value returned here indicates the funding source. Possible values include the following:' description: This type provided details on the funding source for the transfer. BalanceAdjustment: type: object properties: adjustmentAmount: description: The seller payout balance amount that will be applied toward the charges outlined in the charges array. $ref: '#/components/schemas/Amount' adjustmentType: type: string description: The enumeration value returned here indicates if the charge is a DEBIT or a CREDIT to the seller. Generally, all transfer transaction types are going to be DEBIT, since the money is being tranferred from the seller to eBay. For implementation help, refer to eBay API documentation description: This type is used by the balanceAdjustment container, which shows the seller payout balance that will be applied toward the charges outlined in the charges array. TransferDetail: type: object properties: balanceAdjustment: description: This container shows the seller payout balance that will be applied toward the charges outlined in the charges array. $ref: '#/components/schemas/BalanceAdjustment' charges: type: array description: This container is an array of one or more charges related to the transfer. Charges can be related to an order cancellation, order return, case, payment dispute, etc. items: $ref: '#/components/schemas/Charge' totalChargeNetAmount: description: This container shows the total amount that the seller owes for all of the charges outlined in the charges array. $ref: '#/components/schemas/Amount' description: This type is used by the transferDetail container, which provides more details about the transfer and the charge(s) associated with the transfer. Charge: type: object properties: cancellationId: type: string description: The unique identifier of an order cancellation. This field is only applicable and returned if the charge is related to an order cancellation. caseId: type: string description: The unique identifier of a case filed against an order. This field is only applicable and returned if the charge is related to a case filed against an order. chargeNetAmount: description: This container shows the net amount of the charge, which is the total amount of the charge minus the total amount of fees credited towards this refund as per eBay policy. It is possible for there to be multiple charges from multiple orders with one transfer. The net aggregate amount for all charges found in the charges array can be found in the transferDetail.totalChargeNetAmount container. $ref: '#/components/schemas/Amount' inquiryId: type: string description: The unique identifier of an Item Not Received (INR) inquiry filed against an order. This field is only applicable and returned if the charge is related to has an INR inquiry filed against the order. orderId: type: string description: The unique identifier of the order that is associated with the charge. paymentDisputeId: type: string description: The unique identifier of a third-party payment dispute filed against an order. This occurs when the buyer files a dispute against the order with their payment provider, and then the dispute comes into eBay's system. This field is only applicable and returned if the charge is related to a third-party payment dispute filed against an order. refundId: type: string description: The unique identifier of a buyer refund associated with the charge. returnId: type: string description: The unique identifier of an order return. This field is only applicable and returned if the charge is related to an order that was returned by the buyer. description: This type is used by the charge container, which is an array of one or more charges related to the transfer. Transfer: type: object properties: fundingSource: description: This container provides details about the seller's funding source to reimburse eBay for the transfer, such as a bank account, a credit card, or available seller payout funds. $ref: '#/components/schemas/FundingSource' transactionDate: type: string description: 'This timestamp indicates the date/time of the transfer. The following (UTC) format is used: YYYY-MM-DDTHH:MM:SS.SSSZ. For example, 2020-08-04T19:09:02.768Z' transferAmount: description: The amount of the transfer being deducted from the funding source. $ref: '#/components/schemas/Amount' transferDetail: description: This container provides more details about the transfer, including details on the charge(s) associated with the transfer. Multiple charges can be addressed with one transfer. $ref: '#/components/schemas/TransferDetail' transferId: type: string description: The unique identifier of the TRANSFER transaction type. This is the same value that was passed into the end of the call URI. description: This type is the base response type used by TRANSFER transaction type that is returned in the response. securitySchemes: api_auth: type: oauth2 description: The security definitions for this API. Please check individual operations for applicable scopes. flows: authorizationCode: authorizationUrl: https://auth.ebay.com/oauth2/authorize tokenUrl: https://api.ebay.com/identity/v1/oauth2/token scopes: https://api.ebay.com/oauth/api_scope/sell.account.readonly: View your account settings https://api.ebay.com/oauth/api_scope/sell.account: View and manage your account settings