• It is the basic request before running any basket or checkout operation.
• This request is the precondition for adding items to the basket.
• It is always the first request for triggering a transaction operation.

• The basket is created and can be enriched with further details (add items, addresses, shipping and payment options).
• It cannot be transformed into an order (because of the missing information).
• The basket ID and the URI of the basket are returned.

• The basket must be already available (existing and valid Basket ID).

• This request adds a list of items to an existing basket.
• This request is the precondition for editing the shipping options (e.g., selecting another shipping method).

• The items are added to the active basket.
• The whole basket including the URI of the respective item(s) is returned.

• The basket must already be available (existing and valid Basket ID).
• At least one item must be already added to the basket.

• The client requests the options of a respective line item:
  • Shipping options and methods
  • Service line item options (e.g. whether a warranty is available or not)
  • Other item variations

• Returns:
  
  • The valid shipping options and methods of the item
  • Available service line items
  • Other item variations

• The basket must already be available (existing and valid Basket ID).
• At least one item must be already added to the basket.

• The client can set the following line item options:
  • Shipping options and method
    (multiple shipping enabled = multiple shipping buckets)
  • Item quantity
  • Item variation
  • Change shipping address of item
    (only if multiple shipping is supported)

• Returns the URI of the respective line item

/baskets/<basket-id>/items/<item-id>/sublineitems/warranty (for warranties)

/baskets/<basket-id>/items/<item-id>/sublineitems/giftwrap (for gift wraps)

/baskets/<basket-id>/items/<item-id>/sublineitems/giftmessage (for gift messages)

• The basket must be already available (existing and valid Basket ID).
• Item(s) must be added to the cart which is supporting the respective SubLineItem-type and has assigned a SubLineItem.

• The client adds a SubLineItem (warranty, gift wrap or gift message) to a LineItem at the shopping cart

• The basket must be already available (existing and valid Basket ID).
• Items should be added to the cart (not relevant for every option but especially for shipping options).

• The client requests the shipping options and methods which are valid for the current basket so that he can select one in a downstreamed step.

• Returns the shipping options and methods which are valid for the current basket

• Mandatory (in case of anonymous user or logged in user with missing addresses or saved payment information)
• Optional (in case of a logged in user who has saved at least one address and payment information at his account and when accelerated checkout is enabled)

• The basket must be already available (existing and valid Basket ID).
• Item(s) must be added to the basket.

• The client will update or add mandatory basket information:
  • Add/Edit Invoice and Shipping Address(es)
  • Edit Shipping Options and Methods (disables multiple shipping)
• The client will add additional B2B information to the cart.
• The client will add a promotion code to the cart.
• The client has created the basket as anonymous user and is logging in so that the basket will transformed (change authentication of the basket).

• Returns the updated or enriched basket

optional

• The basket must be already available (existing and valid Basket ID).
• Item(s) must be added to the basket.

• The client will request the available and valid payment methods for the current basket.

• Returns all available and valid payment methods for the current basket with its specific options and attributes

• mandatory (in case of anonymous user or logged in user with missing saved payment information)
• optional (in case of a logged in user who has saved at least one address and payment information at his account and when accelerated checkout is enabled)

• The basket must already be available (existing and valid Basket ID)
• Item(s) must be added to the basket

• The client set/select a payment method for his basket and will save the necessary payment information (e.g., the credit card data).

• Returns the URI of the PaymentInstrumentInfo (selected payment method and the necessary payment information)

mandatory if a redirect payment method is selected

• The basket must be already available (existing and valid Basket ID).
• Item(s) must be added to the basket.
• A redirect payment method must be selected.

• The client transfers the return URL´s to the shop system which are for the return back to the REST client after the redirect to the Payment Provider page
  • SuccessURL
  • FailURL
  • CancelURL

• • The shop system generates the redirect URL for the Payment Provider Redirect and transfers this URL to the REST client by the response.

mandatory if a redirect payment method is selected

• The basket must be already available (existing and valid Basket ID).
• Item(s) must be added to the basket.
• A redirect payment method must be selected.
• REST client must have transferred return URL`s to the shop system and must have received the redirect URL from the shop system.

• By return to the REST client after the payment transaction initialization at the payment provider page, the REST client transfers the relevant information back to the shop system
  
  • Inter alia, the token

• The shop system gets all necessary information to communicate with the payment provider after order confirmation to finalize and to confirm the payment transaction.
• The system returns full PaymentInstrumentInfo (PII) with all data (including data from the payment provider).

mandatory

• The basket must be already available (existing and valid Basket ID).

• The client get the calculated basket.

• Returns the basket's summary.

mandatory

• The basket must be already available (existing and valid Basket ID).
• Item(s) must be added to the basket.
• Invoice address must be added to the basket.
• Shipping address/es must be added to basket/buckets.
• The payment method must be selected and if necessary the Payment Information must be added.

• The client accepts the terms and conditions and submits the order.

• Returns the URI of the order