Negative Testing for Order API

When creating your app, you will want to test the app's response to error conditions. However, some error conditions are difficult to simulate. The following has be created to assist you in testing the Order API error conditions.

This document contains the information you need to run code stubs that let you simulate the error conditions in the sandbox. Submit the methods below as you usually would making the following changes in the request.

 

Error Name (not returned)

Error ID

Methods Supported

ERROR_STRING

MAX_NUMBER_OF_ITEMS_EXCEEDED 15011 initiateCheckoutSession MaxNumberOfItemsExceeded
CHECKOUT_ITEM_QUANTITY_UNAVAILABLE 15012 initiateCheckoutSession
updateQuantity
QuantityExceedsAvailability
CHECKOUT_MAX_LIMIT_EXCEEDED 15013 initiateCheckoutSession
updateQuantity
MustBuyLess
BUYING_SERVICE_MUST_BUY_ALL 15014 updateQuantity MustBuySpecificQuantity
CHECKOUT_MAX_LIMIT_EXCEEDED 15015 updatePaymentInfo CreditCardExpired
CHECKOUT_BUYER_IS_SELLER 15016 initiateCheckoutSession BuyerIsSeller
CHECKOUT_ITEM_CANNOT_BE_PRCHASED_RIGHT_NOW 15017 initiateCheckoutSession ItemNotAvailable
CHECKOUT_ITEM_NOT_AVAILABLE_FOR_PURCHASE 15018 initiateCheckoutSession ItemNotPurchasable
CHECKOUT_EMPTY 15019 updateQuantity
updatePaymentInfo
updateShippingAddress
updateShippingOption
placeOrder
SessionWithoutLineItems
CHECKOUT_ITEM_VERSION_INVALID 15020 placeOrder ItemRevised
CHECKOUT_NOT_OPEN_FOR_MODIFICATIONS 15021 updateQuantity
updatePaymentInfo
updateShippingAddress
updateShippingOption
SessionLocked
CHECKOUT_INVALID_PAYMENT_METHOD 15022 placeOrder PaymentMethodInvalid
PAYMENT_INSTRUMENT_DECLINED 15023 placeOrder CreditCardDeclined
PAYMENT_PAYER_ACTION_LOGIN 15024 placeOrder PaypalAuthenticationIssue

 

Method Examples

The following are examples of initiateCheckoutSession and placeOrder methods using stubs.

Note: Personal data, such as seller's name, buyer's name and address, etc. have been anonymized in the requests and the responses, per eBay policy.

placeOrder PAYMENT_INSTRUMENT_DECLINED error example
POST https://api.sandbox.ebay.com/buy/order/v1/guest/checkout_session/testError|CreditCardDeclined/place_order
updateQuantity CHECKOUT_ITEM_QUANTITY_UNAVAILABLE error example
POST https://api.sandbox.ebay.com/buy/order/v1/guest/checkout_session/testError|QuantityExceedsAvailability/update_quantity

{
  "lineItemId":"55555555",
  "quantity":2
}
initiateCheckoutSession MAX_NUMBER_OF_ITEMS_EXCEEDED error example
POST https://api.sandbox.ebay.com/buy/order/v1/guest/checkout_session/initiate

{
  "contactEmail" : "testEmail@someSite.com",
  "contactFirstName":"Test",
  "contactLastName":"Buyer",
  "shippingAddress" : {
    "recipient" : "testError",
    "phoneNumber" : "999 999 9999",
    "addressLine1" : "123 Some Street",
    "city" : "San Jose",
    "stateOrProvince" : "CA",
    "postalCode" : "95134",
    "country" : "US"
  },
  "lineItemInputs" : [ {
    "quantity" : 1,
    "itemId" : "testError|MaxNumberOfItemsExceeded"
  }
 ]
}