--- title: Order API v1 description: "**Note:** This is the V1 version of the Order API which supports member checkout payment flows. If you need to support guest checkout payment flows, use the [V2 version](/develop/api/buy/order_v2_api) of the Order API. The **Order V1 API** is part of the eBay Buy APIs. It is used to purchase items and track the purchase orders. The Order V1 API supports the complete checkout process. Use the Order API with the other Buy APIs to create a buying application that lets eBay members buy from eBay sellers without visiting the eBay site. The Buy APIs provide the ability to purchase eBay items from your app or website. **Note:** This is a [![](https://developer.ebay.com/cms/img/docs/partners-api.svg \"Limited Release\")(Limited Release)](/api-docs/static/versioning.html#limited) API available only to select developers approved by business units. For information on how to obtain access to this API in production, see the [Buy APIs Requirements](/api-docs/buy/static/buy-requirements.html)." api_version: 1.0 api_name: order_api_v1 api_type: REST api_group: buy/order_api_v1 source_url: html: https://developer.ebay.com/develop/api/buy/order_api_v1 md: https://developer.ebay.com/develop/api/buy/order_api_v1.md --- # Order API v1 API **Note:** This is the V1 version of the Order API which supports member checkout payment flows. If you need to support guest checkout payment flows, use the [V2 version](/develop/api/buy/order_v2_api) of the Order API. The **Order V1 API** is part of the eBay Buy APIs. It is used to purchase items and track the purchase orders. The Order V1 API supports the complete checkout process. Use the Order API with the other Buy APIs to create a buying application that lets eBay members buy from eBay sellers without visiting the eBay site. The Buy APIs provide the ability to purchase eBay items from your app or website. **Note:** This is a [![](https://developer.ebay.com/cms/img/docs/partners-api.svg "Limited Release")(Limited Release)](/api-docs/static/versioning.html#limited) API available only to select developers approved by business units. For information on how to obtain access to this API in production, see the [Buy APIs Requirements](/api-docs/buy/static/buy-requirements.html). ## API Methods The following API methods are available: ### applyCoupon #### POST /checkout_session/{checkoutSessionId}/apply_coupon **Description:** **Important!**[![Limited Release](/cms/img/docs/partners-api.svg "Limited Release")(Limited Release)]() You must be whitelisted to use this method. This method adds a coupon to an eBay checkout session and applies it to all the eligible items in the order. The **checkoutSessionId** is passed in as a URI parameter and is required. The redemption code of the coupon is in the payload and is also required. ##### **Restrictions** * **Maximum:** One coupon per order * For a list of supported sites and other restrictions, see [API Restrictions](/api-docs/buy/static/ref-marketplace-supported.html) in the Buy Integration Guide. **Parameters:** - **checkoutSessionId** (string) *required* - This path parameter specifies the unique eBay-assigned session identifier for a specific eBay marketplace. This value is returned by the [initiateGuestCheckoutSession](/develop/api/buy/order_api_v2#buy-order_api_v2-guest_checkout_session-initiateguestcheckoutsession) method. **Note:** When using this ID, the X-EBAY-C-MARKETPLACE-ID value and developer App ID must be the same as that used when this guest checkout session was created. See [Checkout session restrictions](/api-docs/buy/static/ref-marketplace-supported.html) in the Buy Integration Guide for details. - **Content-Type** (string) *required* - This header indicates the format of the request body provided by the client. Its value should be set to **application/json**. - **X-EBAY-C-ENDUSERCTX** (string) - This header is used to specify the **deviceId** for the device/user attempting to make the call. It contains an alphanumeric string that allows a payment gateway to track an API call attempt and confirm that it is a verified payment attempt by a device/user. - **X-EBAY-C-MARKETPLACE-ID** (string) *required* - This header identifies the eBay marketplace where the order will occur. **Note:** For this method, this value must match the **X-EBAY-C-MARKETPLACE-ID** used when the associated checkout session was created. See [HTTP request headers]() for the marketplace ID values. ### getCheckoutSession #### GET /checkout_session/{checkoutSessionId} **Description:** This method returns the details of the specified eBay member checkout session. The **checkoutSessionId** is passed in as a URI parameter and is required. This method has no request payload. ##### **Restrictions** For a list of supported sites and other restrictions, see [API Restrictions](/api-docs/buy/static/ref-marketplace-supported.html) in the Buy Integration Guide. **Parameters:** - **checkoutSessionId** (string) *required* - This path parameter specifies the unique eBay-assigned session identifier for a specific eBay marketplace. This value is returned by the [initiateGuestCheckoutSession](/develop/api/buy/order_v2_api#buy-order_v2_api-guest_checkout_session-initiateguestcheckoutsession) method. **Note:** When using this ID, the X-EBAY-C-MARKETPLACE-ID value and developer App ID must be the same as that used when this guest checkout session was created. See [Checkout session restrictions](/api-docs/buy/static/ref-marketplace-supported.html) in the Buy Integration Guide for details. - **X-EBAY-C-ENDUSERCTX** (string) - This header is used to specify the **deviceId** for the device/user attempting to make the call. It contains an alphanumeric string that allows a payment gateway to track an API call attempt and confirm that it is a verified payment attempt by a device/user. - **X-EBAY-C-MARKETPLACE-ID** (string) *required* - This header identifies the eBay marketplace where the order will occur. **Note:** For this method, this value must match the **X-EBAY-C-MARKETPLACE-ID** used when the associated checkout session was created. See [HTTP request headers]() for the marketplace ID values. ### initiateCheckoutSession #### POST /checkout_session/initiate **Description:** This method creates an eBay member checkout session, which is the first step in performing a checkout. You use this method to create a checkout session before you can process a checkout. If the address submitted cannot be validated, a warning message will be returned. The method returns a **checkoutSessionId** that you use as a URI parameter in subsequent checkout methods. Also see [Negative Testing Using Stubs]() for information on how to emulate error conditions for this method using stubs. **Tip:** To test the entire checkout flow, you might need a 'test' credit card. You can generate a credit card number from [http://www.getcreditcardnumbers.com](). ##### Restrictions For a list of supported sites and other restrictions, see [API Restrictions](/api-docs/buy/static/ref-marketplace-supported.html) in the Buy Integration Guide. **Parameters:** - **Content-Type** (string) *required* - This header indicates the format of the request body provided by the client. Its value should be set to **application/json**. - **X-EBAY-C-ENDUSERCTX** (string) - This header is used to specify the **deviceId** for the device/user attempting to make the call. It contains an alphanumeric string that allows a payment gateway to track an API call attempt and confirm that it is a verified payment attempt by a device/user. - **X-EBAY-C-MARKETPLACE-ID** (string) *required* - This header identifies the eBay marketplace where the order will occur. See [HTTP request headers]() for the marketplace ID values. ### placeOrder #### POST /checkout_session/{checkoutSessionId}/place_order **Description:** This method creates the purchase order, pays for the items, and terminates the specified eBay member checkout session. The **checkoutSessionId** is passed in as a URI parameter and is required. Although there is not a request payload, for this method you must pass in `{ }` in the request body. Also see [Negative Testing Using Stubs](/api-docs/buy/static/ref-buy-negative-testing.html) for information on how to emulate error conditions for this method using stubs. ##### Restrictions For a list of supported sites and other restrictions, see [API Restrictions](/api-docs/buy/static/ref-marketplace-supported.html) in the Buy Integration Guide. **Note:** If the credit card is declined, the checkout session is unusable. You will need to create a new checkout session for the order using the **initiateCheckoutSession** method. **Parameters:** - **checkoutSessionId** (string) *required* - This path parameter specifies the unique eBay-assigned session identifier for a specific eBay marketplace. This value is returned by the [initiateGuestCheckoutSession](/develop/api/buy/order_api_v2#buy-order_api_v2-guest_checkout_session-initiateguestcheckoutsession) method. **Note:** When using this ID, the X-EBAY-C-MARKETPLACE-ID value and developer App ID must be the same as that used when this guest checkout session was created. See [Checkout session restrictions](/api-docs/buy/static/ref-marketplace-supported.html) in the Buy Integration Guide for details. - **X-EBAY-C-ENDUSERCTX** (string) - This header is used to specify the **deviceId** for the device/user attempting to make the call. It contains an alphanumeric string that allows a payment gateway to track an API call attempt and confirm that it is a verified payment attempt by a device/user. - **X-EBAY-C-MARKETPLACE-ID** (string) *required* - This header identifies the eBay marketplace where the order will occur. **Note:** For this method, this value must match the **X-EBAY-C-MARKETPLACE-ID** used when the associated checkout session was created. See [HTTP request headers]() for the marketplace ID values. ### removeCoupon #### POST /checkout_session/{checkoutSessionId}/remove_coupon **Description:** [![Limited Release](/cms/img/docs/partners-api.svg "Limited Release")(Limited Release)](https://developer.ebay.com/api-docs/static/versioning.html#limited) You must be whitelisted to use this method. This method removes a coupon from an eBay member checkout session. The **checkoutSessionId** is passed in as a URI parameter and is required. The redemption code of the coupon is specified in the payload and is also required. ##### **Restrictions** For a list of supported sites and other restrictions, see [API Restrictions](/api-docs/buy/static/ref-marketplace-supported.html) in the Buy Integration Guide. **Parameters:** - **checkoutSessionId** (string) *required* - This path parameter specifies the unique eBay-assigned session identifier for a specific eBay marketplace. This value is returned by the [initiateGuestCheckoutSession](/develop/api/buy/order_api_v2#buy-order_api_v2-guest_checkout_session-initiateguestcheckoutsession) method. **Note:** When using this ID, the X-EBAY-C-MARKETPLACE-ID value and developer App ID must be the same as that used when this guest checkout session was created. See [Checkout session restrictions](/api-docs/buy/static/ref-marketplace-supported.html) in the Buy Integration Guide for details. - **Content-Type** (string) *required* - This header indicates the format of the request body provided by the client. Its value should be set to **application/json**. - **X-EBAY-C-ENDUSERCTX** (string) - This header is used to specify the **deviceId** for the device/user attempting to make the call. It contains an alphanumeric string that allows a payment gateway to track an API call attempt and confirm that it is a verified payment attempt by a device/user. - **X-EBAY-C-MARKETPLACE-ID** (string) *required* - This header identifies the eBay marketplace where the order will occur. **Note:** For this method, this value must match the **X-EBAY-C-MARKETPLACE-ID** used when the associated checkout session was created. See [HTTP request headers]() for the marketplace ID values. ### updateAddonServicesStatus #### POST /checkout_session/{checkoutSessionId}/update_add_on_services_status **Description:** This method changes the selection of add-on services for one line item for the checkout session. **Parameters:** - **checkoutSessionId** (string) *required* - This path parameter specifies the unique eBay-assigned session identifier for a specific eBay marketplace. This value is returned by the [initiateGuestCheckoutSession](/develop/api/buy/order_v2_api#buy-order_v2_api-guest_checkout_session-initiateguestcheckoutsession) method. **Note:** When using this ID, the X-EBAY-C-MARKETPLACE-ID value and developer App ID must be the same as that used when this guest checkout session was created. See [Checkout session restrictions](/api-docs/buy/static/ref-marketplace-supported.html) in the Buy Integration Guide for details. - **Content-Type** (string) *required* - This header indicates the format of the request body provided by the client. Its value should be set to **application/json**. - **X-EBAY-C-ENDUSERCTX** (string) - This header is used to specify the **deviceId** for the device/user attempting to make the call. It contains an alphanumeric string that allows a payment gateway to track an API call attempt and confirm that it is a verified payment attempt by a device/user. - **X-EBAY-C-MARKETPLACE-ID** (string) *required* - This header identifies the eBay marketplace where the order will occur. **Note:** For this method, this value must match the **X-EBAY-C-MARKETPLACE-ID** used when the associated checkout session was created. See [HTTP request headers]() for the marketplace ID values. ### updatePaymentInfo #### POST /checkout_session/{checkoutSessionId}/update_payment_info **Description:** **Important!** This method has been deprecated and will be decommissioned on June 2nd, 2026. This method changes the payment method information of the specified eBay member checkout session. ##### **Restrictions** For a list of supported sites and other restrictions, see [API Restrictions](/api-docs/buy/static/ref-marketplace-supported.html) in the Buy Integration Guide. **Parameters:** - **checkoutSessionId** (string) *required* - This path parameter specifies the unique eBay-assigned session identifier for a specific eBay marketplace. This value is returned by the [initiateGuestCheckoutSession](/develop/api/buy/order_api_v2#buy-order_api_v2-guest_checkout_session-initiateguestcheckoutsession) method. **Note:** When using this ID, the X-EBAY-C-MARKETPLACE-ID value and developer App ID must be the same as that used when this guest checkout session was created. See [Checkout session restrictions](/api-docs/buy/static/ref-marketplace-supported.html) in the Buy Integration Guide for details. - **Content-Type** (string) *required* - This header indicates the format of the request body provided by the client. Its value should be set to **application/json**. - **X-EBAY-C-ENDUSERCTX** (string) - This header is used to specify the **deviceId** for the device/user attempting to make the call. It contains an alphanumeric string that allows a payment gateway to track an API call attempt and confirm that it is a verified payment attempt by a device/user. - **X-EBAY-C-MARKETPLACE-ID** (string) *required* - This header identifies the eBay marketplace where the order will occur. **Note:** For this method, this value must match the **X-EBAY-C-MARKETPLACE-ID** used when the associated checkout session was created. See [HTTP request headers]() for the marketplace ID values. ### updateQuantity #### POST /checkout_session/{checkoutSessionId}/update_quantity **Description:** This method changes the quantity of the specified line item in an eBay member checkout session. **Note:** This method is **not** applicable to auction item checkouts, as the **quantity** field must be `1`. If this field is updated to any other value, an error will be returned. ##### **Restrictions** For a list of supported sites and other restrictions, see [API Restrictions](/api-docs/buy/static/ref-marketplace-supported.html) in the Buy Integration Guide. **Parameters:** - **checkoutSessionId** (string) *required* - This path parameter specifies the unique eBay-assigned session identifier for a specific eBay marketplace. This value is returned by the [initiateGuestCheckoutSession](/develop/api/buy/order_api_v2#buy-order_api_v2-guest_checkout_session-initiateguestcheckoutsession) method. **Note:** When using this ID, the X-EBAY-C-MARKETPLACE-ID value and developer App ID must be the same as that used when this guest checkout session was created. See [Checkout session restrictions](/api-docs/buy/static/ref-marketplace-supported.html) in the Buy Integration Guide for details. - **Content-Type** (string) *required* - This header indicates the format of the request body provided by the client. Its value should be set to **application/json**. - **X-EBAY-C-ENDUSERCTX** (string) - This header is used to specify the **deviceId** for the device/user attempting to make the call. It contains an alphanumeric string that allows a payment gateway to track an API call attempt and confirm that it is a verified payment attempt by a device/user. - **X-EBAY-C-MARKETPLACE-ID** (string) *required* - This header identifies the eBay marketplace where the order will occur. **Note:** For this method, this value must match the **X-EBAY-C-MARKETPLACE-ID** used when the associated checkout session was created. See [HTTP request headers]() for the marketplace ID values. ### updateShippingAddress #### POST /checkout_session/{checkoutSessionId}/update_shipping_address **Description:** This method changes the shipping address for in an eBay member checkout session. All the line items in an order must be shipped to the same address, but the shipping method can be specific to the line item. **Note:** If the address submitted cannot be validated, a warning message will be returned. This does not prevent the method from executing, but you may want to verify the address. ##### **Restrictions** For a list of supported sites and other restrictions, see [API Restrictions](/api-docs/buy/static/ref-marketplace-supported.html) in the Buy Integration Guide. **Parameters:** - **checkoutSessionId** (string) *required* - This path parameter specifies the unique eBay-assigned session identifier for a specific eBay marketplace. This value is returned by the [initiateGuestCheckoutSession](/develop/api/buy/order_api_v2#buy-order_api_v2-guest_checkout_session-initiateguestcheckoutsession) method. **Note:** When using this ID, the X-EBAY-C-MARKETPLACE-ID value and developer App ID must be the same as that used when this guest checkout session was created. See [Checkout session restrictions](/api-docs/buy/static/ref-marketplace-supported.html) in the Buy Integration Guide for details. - **Content-Type** (string) *required* - This header indicates the format of the request body provided by the client. Its value should be set to **application/json**. - **X-EBAY-C-ENDUSERCTX** (string) - This header is used to specify the **deviceId** for the device/user attempting to make the call. It contains an alphanumeric string that allows a payment gateway to track an API call attempt and confirm that it is a verified payment attempt by a device/user. - **X-EBAY-C-MARKETPLACE-ID** (string) *required* - This header identifies the eBay marketplace where the order will occur. **Note:** For this method, this value must match the **X-EBAY-C-MARKETPLACE-ID** used when the associated checkout session was created. See [HTTP request headers]() for the marketplace ID values. ### updateShippingOption #### POST /checkout_session/{checkoutSessionId}/update_shipping_option **Description:** This method changes the shipping method for the specified line item in an eBay member checkout session. The shipping option can be set for each line item. This gives the shopper the ability choose the cost of shipping for each line item. ##### **Restrictions** For a list of supported sites and other restrictions, see [API Restrictions](/api-docs/buy/static/ref-marketplace-supported.html) in the Buy Integration Guide. **Parameters:** - **checkoutSessionId** (string) *required* - This path parameter specifies the unique eBay-assigned session identifier for a specific eBay marketplace. This value is returned by the [initiateGuestCheckoutSession](/api-docs/buy/order/resources/guest_checkout_session/methods/initiateGuestCheckoutSession) method. **Note:** When using this ID, the X-EBAY-C-MARKETPLACE-ID value and developer App ID must be the same as that used when this guest checkout session was created. See [Checkout session restrictions](/api-docs/buy/order/overview.html#checkout-restriction) in the Buy Integration Guide for details. - **Content-Type** (string) *required* - This header indicates the format of the request body provided by the client. Its value should be set to **application/json**. - **X-EBAY-C-ENDUSERCTX** (string) - This header is used to specify the **deviceId** for the device/user attempting to make the call. It contains an alphanumeric string that allows a payment gateway to track an API call attempt and confirm that it is a verified payment attempt by a device/user. - **X-EBAY-C-MARKETPLACE-ID** (string) *required* - This header identifies the eBay marketplace where the order will occur. **Note:** For this method, this value must match the **X-EBAY-C-MARKETPLACE-ID** used when the associated checkout session was created. See [HTTP request headers]() for the marketplace ID values. ### getPurchaseOrder #### GET /purchase_order/{purchaseOrderId} **Description:** This method retrieves the details about a specific eBay member purchase order. It returns the line items, including purchase order status; dates created and modified; item quantity and listing data; payment and shipping information; and prices, taxes, and discounts and credits. The **purchaseOrderId** is passed in as a URI parameter and is required. This method has no request payload. The [placeOrder](/develop/api/buy/order_api_v1#buy-order_api_v1-checkout_session-placeorder) method initiates the payment process, which can sometimes take a few minutes. You can use this method to not only get the details of a purchase order but to check the value of the [purchaseOrderPaymentStatus](/develop/api/buy/order_v1_api#buy-order_api_v1-checkout_session-placeorder.purchaseordersummary.purchaseorderpaymentstatus) field to determine if the order has been paid for. If the order has been paid for, this field will return `PAID`. This method also returns the **legacyItemId**, **legacyTransactionId**, and **legacyOrderId** fields. The values in these fields enable eBay partners to use the [Post Order API]() for eBay member checkouts, to process a return or cancellation. For more information, see [Post order tasks](/api-docs/buy/static/api-order.html#Post) in the Buy Integration Guide. ##### **Restrictions** For a list of supported sites and other restrictions, see [API Restrictions](/api-docs/buy/static/ref-marketplace-supported.html) in the Buy Integration Guide. **Parameters:** - **purchaseOrderId** (string) *required* - This path parameter specifies the unique identifier of a purchase order made by an eBay member, for which details are to be retrieved. This value is returned by the [placeOrder](/develop/api/buy/order_api_v1#buy-order_api_v1-checkout_session-placeorder) method in the **purchaseOrderId** field. ## Error Codes The following error codes may be returned by this API: ### REQUEST Errors #### 15001 - API_ORDER **Description:** Missing field: {fieldName}. The indicated field is required for this request. Add the field and resubmit the call. #### 15002 - API_ORDER **Description:** Invalid field: {fieldName}. The indicated field contains an invalid value. This error can be returned due to multiple scenarios. Please refer to [Order API error details](/api-docs/buy/static/api-order.html#errordetails) for assistance on troubleshooting the issue. #### 15029 - API_ORDER **Description:** The X-EBAY-C-MARKETPLACE-ID value {fieldValue} is invalid for this checkout session because it is different from the X-EBAY-C-MARKETPLACE-ID header value used to create the session. For all calls in this checkout session, you must use X-EBAY-C-MARKETPLACE-ID {supportedValues}. #### 16002 - API_ORDER **Description:** The coupon does not exist. The coupon was ignored and no discount was applied to this order. #### 16003 - API_ORDER **Description:** The coupon has expired. No discount was applied to this order. #### 16004 - API_ORDER **Description:** The coupon has not been activated. The coupon was ignored and no discount was applied to this order. #### 16006 - API_ORDER **Description:** The coupon code is invalid. The coupon was ignored and no discount was applied to this order. #### 16022 - API_ORDER **Description:** The coupon code is invalid. The coupon was ignored and no discount was applied to this order. #### 16024 - API_ORDER **Description:** The coupon provided could not be applied. You may proceed with this session or provide another coupon. #### 15025 - API_ORDER **Description:** The App is not authorized to access this resource. #### 15034 - API_ORDER **Description:** The signature is invalid. Please verify that the signature is generated according to the specification. #### 15003 - API_ORDER **Description:** The checkout session requested does not exist. #### 15048 - API_ORDER **Description:** The value of {fieldName} is too long. For more information, see the documentation for this call. #### 17002 - API_ORDER **Description:** Invalid character(s) found in the shipping address. Please check name and shipping address fields, remove invalid character(s) and resubmit the call. #### 15004 - API_ORDER **Description:** The buyer's credit card information is missing. Please submit the buyer's credit card information using updatePaymentInfo method. #### 16025 - API_ORDER **Description:** The coupon was not applied to this cart. #### 1001 - API_ORDER **Description:** Invalid access token. Check the value of the Authorization HTTP request header. ### APPLICATION Errors #### 16020 - API_ORDER **Description:** Your application is not eligible for this coupon. The coupon was ignored and no discount was applied to this order. #### 15000 - API_ORDER **Description:** There was a problem with an eBay internal system or process. Contact eBay developer support for assistance. #### 18003 - API_ORDER **Description:** Selected add-on service {fieldName} is not eligible for the shipping destination. #### 18005 - API_ORDER **Description:** Selected add-on service {fieldName} is required for this purchase. #### 16001 - API_ORDER **Description:** There was a problem with an eBay internal system or process. Contact eBay developer support for assistance. ### BUSINESS Errors #### 15019 - API_ORDER **Description:** To place an order, you must have at least one line item. Use the initiateCheckoutSession call to add line items (maximum of {maxLineItems}) and create a new checkout session. #### 15021 - API_ORDER **Description:** This checkout session cannot be updated because the order has already been placed. #### 15027 - API_ORDER **Description:** The value {fieldValue} is not supported for the {fieldName}. The supported values are: {supportedValues}. #### 16000 - API_ORDER **Description:** The coupon is not valid for any of the items in the order. The coupon was ignored and no discount was applied to this order. #### 16001 - API_ORDER **Description:** You cannot apply multiple coupons to the same order. No discount was applied to this order. #### 16005 - API_ORDER **Description:** The coupon requires the buyer to spend a specific monetary amount. This threshold has not been met. The coupon was ignored and no discount was applied to this order. #### 16007 - API_ORDER **Description:** This coupon has already been used. The coupon was ignored and no discount was applied to this order. #### 16008 - API_ORDER **Description:** This coupon is no longer valid. The coupon was ignored and no discount was applied to this order. #### 16009 - API_ORDER **Description:** The coupon requires the buyer to spend a specific monetary amount. This threshold has not been met. The coupon was ignored and no discount was applied to this order. #### 16010 - API_ORDER **Description:** The coupon is not valid for the currency being used by the items. The coupon was ignored and no discount was applied to this order. #### 16012 - API_ORDER **Description:** The coupon is not valid for the {fieldName}. The coupon was ignored and no discount was applied to this order. #### 16013 - API_ORDER **Description:** The coupon is not valid for any of the item categories in the order. The coupon was ignored and no discount was applied to this order. #### 16014 - API_ORDER **Description:** The coupon is not valid for the selected payment method. The coupon was ignored and no discount was applied to this order. #### 16015 - API_ORDER **Description:** The coupon is not valid for the selected shipping option. The coupon was ignored and no discount was applied to this order. #### 16016 - API_ORDER **Description:** The coupon is valid only for items that are shipped domestically. The coupon was ignored and no discount was applied to this order. #### 16017 - API_ORDER **Description:** The coupon is valid only for items that are shipped internationally. The coupon was ignored and no discount was applied to this order. #### 16018 - API_ORDER **Description:** The buyer is not eligible for this coupon. The coupon was ignored and no discount was applied to this order. #### 16019 - API_ORDER **Description:** The coupon is not valid for guest eBay checkouts. The coupon was ignored and no discount was applied to this order. #### 16023 - API_ORDER **Description:** You cannot apply multiple coupons to the same order. The coupon was ignored and no discount was applied to this order. #### 15011 - API_ORDER **Description:** You have exceeded the maximum number of {maxLineItems} line items. Correct the request and resubmit the call. #### 15012 - API_ORDER **Description:** There is a limit on the quantity of this item that can be purchased. Reduce the quantity and resubmit the call. #### 15013 - API_ORDER **Description:** The quantity value is greater than the quantity available. Correct the quantity value and resubmit the call. #### 15014 - API_ORDER **Description:** The quantity submitted for this item is invalid. Correct the quantity value and resubmit the call. #### 15015 - API_ORDER **Description:** There is a problem with the credit card and it cannot be used to purchase items. Use the updatePaymentInfo call to change the payment information. #### 15016 - API_ORDER **Description:** The buyer is the seller of the item, which is not allowed. #### 15017 - API_ORDER **Description:** The payment for the order line items in your cart could not be processed due to issues with one or more sellers. #### 15018 - API_ORDER **Description:** 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. #### 15024 - API_ORDER **Description:** There is a problem with the buyer's payment method. Please check or provide another payment method for this order. #### 15026 - API_ORDER **Description:** The item is not shippable to the specified shipping address. #### 15028 - API_ORDER **Description:** The item {itemId} is not available for purchase because it cannot be shipped to {country}. #### 15031 - API_ORDER **Description:** The item is not purchasable because the buyer has been blocked by the seller. #### 15044 - API_ORDER **Description:** At least one of the items in the cart cannot be purchased using this API. The purchase can be done on eBay, through the eBay app or eBay website. #### 15045 - API_ORDER **Description:** The item cannot be purchased because the seller is away and is not processing orders. If you are trying to purchase more than one item, you need to create a new checkout session to purchase the other items. #### 15047 - API_ORDER **Description:** In compliance with applicable economic sanctions and trade restrictions, eBay is unavailable in your location. If you believe you are receiving this notice in error, please contact eBay's Customer Service. #### 15050 - API_ORDER **Description:** Your transaction cannot be completed with the given information. Contact eBay customer service. #### 15051 - API_ORDER **Description:** Additional user details required. Please complete your registration or contact eBay customer support. #### 15056 - API_ORDER **Description:** The buyer is not the winning bidder of the auction. #### 17001 - API_ORDER **Description:** Authentication with the payment provider failed. Please log into eBay.com and ensure payment provider accounts are properly linked. #### 20002 - API_ORDER **Description:** This item {itemId} is currently unavailable to buy from the seller. #### 15020 - API_ORDER **Description:** During the checkout process the item has been changed. Create a new checkout session for this item using the initiateCheckoutSession call. #### 15023 - API_ORDER **Description:** The payment cannot be processed due to an issue with the funding source, such as insufficient funds, or invalid payment details, such as card number or billing address error. To complete this order, use the appropriate initiate checkout session call to create a new session and either provide a new payment method or correct the payment details. #### 17000 - API_ORDER **Description:** The payment cannot be processed due to a payment processor issue, such as invalid incentive, funding or financing issue, etc. #### 15022 - API_ORDER **Description:** Some of the items cannot be purchased using a credit card and must be removed from the checkout session. ## Rate Limits See [API Call Limits](https://developer.ebay.com/develop/get-started/api-call-limits) on the eBay Developer Program. ## Resources ### Documentation - [eBay Developer Program](https://developer.ebay.com/) - [API Documentation](https://developer.ebay.com/develop/api/) - [SDKs and Widgets](https://developer.ebay.com/develop/sdks-and-widgets) - [Developer Community Forum](https://community.ebay.com/t5/Developer-Groups/ct-p/developergroup) ### Tools - [API Explorer](https://developer.ebay.com/my/api_test_tool) - [GraphQL Explorer](https://developer.ebay.com/my/graphql_explorer) ### Support - [Developer Support](https://developer.ebay.com/support/) - [API Status](https://developer.ebay.com/support/api-status) - [Release Notes](https://developer.ebay.com/develop/api/release_notes/) --- *Generated on 2026-08-10T16:04:39.803Z*