Just getting started with the Fulfillment API? See the following documents for details on using this API:

The API release history

The following table lists recent Fulfillment API releases. For older releases, see the Fulfillment API release notes archive.

Version Release Date Summary of Release
Version 1.19.17 2022-10-19 EU and UK Payments regulations now require Digital Signatures to be included in HTTP payloads for the issueRefund method.
Version 1.19.16 2022-10-04 Added support for eBay shipping.
Version 1.19.15 2022-09-19 Added support for eBay International Shipping.
Version 1.19.14 2022-06-30 Added and updated error codes for the uploadEvidenceFile method.
Version 1.19.13 2022-06-16

Effective July 1, 2022, eBay is required to collect and remit sales tax in Canada; the following changes have been incorporated in this release:

  • Added support to collect and remit (C&R) Canada sales tax
  • Sales tax is now being collected for Digitally Delivered Goods (DDG)

Version 1.19.12 2022-05-31 Two error codes were added and three error codes were updated for the issueRefund method.
Version 1.19.11 2022-05-05 Added new Schema to support eBay's Vault program.
Version 1.19.10 2021-10-18 Changed the limit maximum value to 200 for getOrders method.
Version 1.19.9 2021-08-18 Added two enumeration values (APPEAL_DENIED and APPEAL_GRANTED) for the ActivityEnum type.
Version 1.19.8 2021-07-26 Added a new enumeration value (DISPUTE_REVERSED) for the ActivityEnum type.

Version 1.19.17

Due to EU and UK Payments regulatory requirements, an additional security verification via Digital Signatures is required for the issueRefund method when called on behalf of EU/UK sellers. Refer to Digital Signatures for APIs for information about creating signatures to be included in the HTTP payload.

Version 1.19.16

API updates

This API release contains the following update.

Added schema to support eBay shipping

An EbayCollectedCharges type was added to the LineItem type to provide the breakdown of costs that are collected by eBay from the buyer.

The following containers were added to the getOrder and getOrders methods:

Note: Currently, ebayCollectedCharges and ebayShipping are returned only if eBay is directly charging the buyer for eBay shipping.

  • ebayCollectedCharges container consists of a breakdown of costs that are collected by eBay from the buyer for this order.

  • ebayShipping container consists of costs related to eBay Shipping collected by eBay from the buyer of this order.

An EbayShipping type was added to the Program type to provide information about the management of the shipping for the order.

The following container was added was added to the getOrder and getOrders methods:

  • shippingLabelProvidedBy container provides the shipping label provider. If EBAY, this order is managed by eBay shipping and a free shipping label by eBay is downloadable by the seller via the eBay website

Tip: See more details about Authenticity Guarantee and how eBay shipping applies to eligible sneaker listings.

Version 1.19.15

API updates

This API release contains the following update.

Support for eBay International Shipping added

Support for eBay International Shipping has been added. On the US marketplace, the Global Shipping Program is scheduled to be replaced by this new intermediated shipping program (eBay International Shipping). US Sellers opted in to the Global Shipping Program will automatically get opted into eBay International Shipping once it becomes available to them. All US sellers will be migrated by March 31, 2023. As long as the US seller's account is opted in to eBay International Shipping, this shipping option will be automatically enabled for all listings where international shipping is available.

Added schema to support eBay International shipping

An EbayInternationalShipping type was added to provide details about an order line item being managed through eBay International Shipping.

The following containers were added or modified:

  • ebayInternationalShipping container was added to the getOrder and getOrders methods

  • ebaySupportedFulfillment container (and the FulfillmentStartInstruction type) now supports eBay International Shipping

Version 1.19.14

API updates

This API release contains the following update.

Error codes

The following error codes were added to the uploadEvidenceFile method:

  • Error 33105: You have reached the maximum number of files that you can upload.
  • Error 33106: The file name should not be empty and should not exceed 255 characters.
  • Error 33107: Only one file can be uploaded per request.

Additionally, the file size limit described in error 33006 was changed from 10MB to 1.5MB.

In the methods addEvidence and updateEvidence, the description for error code 33104 was updated to state: "The combined size of attached files should be 1.5MB or less."

Version 1.19.13

API updates

This API release contains the following updates.

eBay now collects and remits Canadian federal and provincial sales tax

Canadian federal and provincial sales tax information is now returned as part of the getOrder and getOrders methods.

Sales tax is now being collected for Digitally Delivered Goods (DDG)

Sales tax information collected on DDG is now returned as part of the getOrder and getOrders methods.

Version 1.19.12

API updates

This API release contains the following update.

New error codes

The following error codes were added to the issueRefund method:

Code Meaning
34929 You cannot refund this order yet since the buyer payment has not been processed. Please try again later.
34930 Default payment method limit exceeded. Please use a different payment option or try again later.

Error code updates

The following issueRefund method error code meanings were updated:

Code Meaning
34917 This order was already refunded.
34920 It's too late to issue a refund for this order.
34923 Refund cannot be issued for this type of order.

Version 1.19.11

API updates

This API release contains the following update.

New schema to support eBay's Vault program

The following schema changes have been made to the getOrder and getOrders methods in this release to support eBay's Vault program:

  • ebayVault field added to Program type: This field provides information about the specific eBay Vault program selected for eligible items within an order.
  • EbayVaultProgram type added: This type provides information about the eBay vault program that has been selected for an order and includes the following field:
    • fulfillmentType: This field specifies how an eBay vault order will be fulfilled.
  • New EbayVaultFulfillmentTypeEnum: Specifies which EbayVaultProgram has been selected for an order.
  • New FULFILLED_BY_EBAY enumeration value added to FulfillmentInstructionsType: Indicates that eBay will package and ship an order as specified by fulfillmentType.

Version 1.19.10

API updates

This API release contains the following update.

Updated limit

The limit value (the number of orders to return per page of the result set) used by the getOrders method now has a maximum value of 200.

Version 1.19.9

API updates

This API release contains the following update.

New enumeration values

Two enumeration values were added to the ActivityEnum for the PaymentDisputeActivity type used by the getActivities method.

  • APPEAL_DENIED: This enumeration value indicates eBay has declined the seller's appeal and upheld the original decision.
  • APPEAL_GRANTED: This enumeration value indicates eBay has granted the seller's appeal.

Version 1.19.8

API updates

This API release contains the following update.

New enumeration value

A new enumeration value was added to the ActivityEnum for the PaymentDisputeActivity type used by the getActivities method.

The new enumeration value, DISPUTE_REVERSED, indicates that in the case of a dispute that was previously closed as Seller Lost, the decision has been reversed to Seller Won. eBay will credit back to the seller the amount that was recouped by eBay when the dispute was originally closed as Seller Lost.