Skip to main content
Release VersionRelease DateDescription of Release
1.36.32026-06-22

Corrected payment-related schema details

1.36.22025-05-21

Added support for the IT marketplace and associated CBT flows

1.36.12025-02-05

Added new BUYER_PROTECTION enum to ServiceTypeEnum

1.36.02023-10-04

Added itemOnHold field to OrderLineItem type.

1.35.02023-07-25

Added support for purchasing auction items

1.34.02022-01-10

Added support for paying the international duties at checkout

1.33.12022-10-10

Updated error messages about PayPal accounts for the placeOrder method

1.33.02022-09-22

Added ebayShipping boolean to Checkout and Order

1.32.02022-08-15

Added enumeration values for tax classifications

1.31.02022-06-14
  • Added support to collect and remit (C&R) Canada sales tax
  • Removed guest checkout payment flows
1.30.02022-02-22

Added types and methods to support the selection of add-on services to items in an order.

1.29.12021-03-10

Removed support for applied coupons and promotion codes from the getPurchaseOrder and getGuestPurchaseOrder methods.

1.29.02020-12-23
  • Added support for line item tax details.
  • Updated response field descriptions to inform of value-added tax (VAT) inclusion in applicable jurisdictions.

1.36.3

The following changes have been made in this release.

Document changes only to the payment-related schema details in PaymentMethod, PaymentInstructionEnum, and PaymentMethodTypeEnum, correct enum values for TaxType and TaxClassificationEnum, plus various miscellaneous corrections.

1.36.2

The following changes have been made in this release.

Italy Marketplace support

The Order API v1 now supports the Italy (EBAY_IT) marketplace.

CBT support

The Order API V1 now supports the following CBT (Cross Border Trade) flows:

  • Spain to Italy (EBAY_ES to EBAY_IT)

  • France to Italy (EBAY_FR to EBAY_IT)

1.36.1

The following changes have been made in this release.

New BUYER_PROTECTION enum added

A new BUYER_PROTECTION enum was added under ServiceTypeEnum type to account for the new Buyer Protection fee that will be charged to buyers purchasing items from private sellers on the eBay UK marketplace. eBay will automatically add this fee to the checkout session and getPurchaseOrder response. The Buyer Protection fee and the tax against the fee will be shown under the addonServices array.

Please note that the updateAddonServicesStatus method cannot be used to remove the Buyer Protection service. The following error code will be returned if this is attempted: 18005: Selected add-on service {fieldName} is required for this purchase.

1.36.0

The following changes have been made in this release.

Schema change

The following field has been added to the OrderLineItem type which is used by the getPurchaseOrder method:

  • itemOnHold: When this value is true it indicates that the item has been put on hold due to a violation of eBay Policy.

1.35.0

The following changes have been made in this release.

Added Support for Purchasing Auction Items

Buyers can now purchase items that have been won in an auction.

Added New Error Message

Error message 15056 has been added to the initiateGuestCheckoutSession method, as shown in the table below.

Error ID Description
15056 The buyer is not the winning bidder of the auction.

Revised Error Message

The description for error message 15018 has been updated as shown in the table below. This affects the initiateCheckoutSession method.

Error ID Description
15018 The item is not available for purchase. This can be for several reasons including the listing has ended. Remove the item and resubmit the call.

1.34.0

The following changes have been made in this release.

Added support for paying international duties at checkout

Buyers can now choose to pay international duties during checkout.

If an item is eligible both for payment of duties at pickup and payment of duties during checkout, only the option to collect duties during checkout will be offered.
Added new enum

The IMPORT_DUTY_TAX enum was added to the TaxClassificationEnum type. This enum indicates that the import duties are being collected from the buyer at checkout.

Added importDuties to the lineItem and

The importDuties container was added to lineItem and PricingSummary in the following methods. The amount in the importDuties fields indicate the amount of import duties due at checkout for the line item and order, respectively.

importDuties applies only to eBay International Shipping (eIS) orders, and eIS is only available to sellers on the US marketplace.
  • initiateCheckoutSession
  • getCheckoutSession
  • updatePaymentInfo
  • updateQuantity
  • updateShippingOption
  • updateShippingAddress
  • applyCoupon
  • removeCouple
  • updateAddonServicesStatus
  • getPurchaseOrder

1.33.1

The following changes have been made in this release.

Updated a new error message

The description for error message 15004 was updated as shown in the table below. This affects the placeOrder method.

Error ID

Description

15004

The buyer's credit card information is missing. Please submit the buyer's credit card information using updatePaymentInfo method.

Removed an error message

Error message 15030, as shown in the table below, was removed from the placeOrder method.

Error ID

Description

15030

To place the order, the user must have accepted the PayPal User Agreement and Privacy Policy. If they have explicitly accepted these, pass in true in the paymentTermsAccepted field. For more information, see the documentation for this call.

1.33.0

The following changes have been made in this release.

Added a new ebayShipping boolean field to Checkout and Order

This boolean field is returned as 'true' if eBay (and not the seller) will handle the shipment of the authenticated item to the buyer's address.

In Checkout, if this field is returned, the value in the ShippingOption container indicates the shipping cost the buyer will pay to eBay.

In Order, if this field is returned, the value in the ShippingDetail container indicates the shipping cost the buyer paid to eBay.

1.32.0

The following changes have been made in this release.

Enumeration values added for tax classification codes

These values were added to the taxClassificationEnum type:

  • DOMESTIC_LEG_TAX: Tax collected for shipping fees that are charged on the domestic leg of an international order
  • HANDLING_TAX: Tax collected for handling costs
  • IMPORT_TAX: Tax collected for fees charged to import an order, based on the value of the item
  • INTERNATIONAL_LEG_TAX: Tax collected for shipping fees that are charged on the international leg of an international order
  • SHIPPING_IMPORT_TAX: Tax collected for fees charged to import an order, based on the cost of the international leg of shipping

1.31.0

The following changes have been made in this release.

eBay now collects and remits Canadian federal and provincial sales tax

To support the handling and processing of Canadian sales tax, the following changes have been implemented.

Added new taxDetails container at the Order level

A new taxDetails container has been added to the CheckoutSessionResponse and PurchaseOrder types for the checkout and order methods.

This container provides detailed information about the Canadian taxes being collected for an order.

Schema Changes

To support the new taxDetails container, the following types were added:

  • TaxDetails
  • TaxClassificationEnum
  • TaxClassificationDetail
Removed Guest Checkout Flows

Order v1 API no longer supports guest checkout payment flows.

Schema Changes

The following methods (and all related resources) have been removed:

  • guest_checkout_session
  • proxy_guest_checkout_session
  • guest_purchase_order

Note: If you have a use case that requires guest checkout payment flows, please use the v2 version Order API.

1.30.0

The following changes have been made in this release.

Added the method updateAddonServicesStatus to checkout_session

The new method updateAddonServicesStatus defines which add-on services are selected for a checkout session.

Added the types AddonService and AddonServiceInput

AddonService defines the add-on services that apply to a line item in an order. AddonServiceInput defines the add-on services that are selected for a checkout session.

Note: Although this field is still returned in the response payloads, no promotion data will be provided.

1.29.1

The following changes have been made in this release.

Removed support for applied coupons

The appliedCoupons container is no longer returned in the response payload of the getPurchaseOrder and getGuestPurchaseOrder methods.

Removed support for promotion codes

Promotion data is no longer returned for the promotionCode field in the response payload of the getPurchaseOrder and getGuestPurchaseOrder methods.

Note: Although this field is still returned in the response payloads, no promotion data will be provided.

1.29.0

The following changes have been made in this release.

Added a new taxDetails container

A new taxDetails container was added to the LineItem and OrderLineItem types for the checkout and order methods.

This new container provides a breakdown of the tax information for the line item, such as the tax jurisdiction and the tax type.

Updated field descriptions for value-added tax (VAT)

The following response field descriptions where updated to inform users that the value returned includes a value-added tax (VAT) for applicable jurisdictions when requested from supported marketplaces:

  • baseDeliveryCost
  • baseUnitPrice
  • deliveryCost
  • priceSubtotal

To see the VAT-inclusive pricing/cost, users must pass the X-EBAY-C-MARKETPLACE-ID request header specifying the supported marketplace (such as EBAY_GB).

Note: Refer to the VAT Obligations in the EU article for more information about VAT.