Skip to main content
The Storefront API Checkout provides functions for the order and checkout process. It covers the steps that typically take place between the shopping cart and order completion. These include:
  • Determining and selecting shipping methods
  • Determining and selecting payment methods
  • Calculating totals (including taking into account discounts, surcharges, and other price-relevant components)
  • Checking and accepting checkout-relevant data (e.g. delivery/billing data, prerequisites, and conditions for order completion)
  • Triggering order completion and transitioning into the respective payment flow (depending on the payment method)
In addition, the interface provides access to all relevant settings and rules for the order process, e.g. minimum order values, small-quantity surcharges, and other checkout-relevant restrictions or surcharge logic, so that these can be correctly considered and displayed in the frontend.
This Storefront API is currently still being developed and is at present available only with a limited scope of functions. Which information and endpoints are currently included can be found in the interface description below. The further development of this interface is being continuously continued.

​
Supported methods

List of all supported methods.
CommandEndpointsGETPUTPOSTDELETE
Retrieve checkout statuscheckout/status
Set account typecheckout/setAccountType

​
Methods for the checkout

The following methods provide information about the current checkout process of the active session.

​
GET checkout/status

The following call returns the total costs for the checkout process (including small-quantity surcharge “surcharge”, shipping and payment method costs, vouchers, etc.). It can be used, for example, to update the total amount in the checkout without reloading the page. 
GET https://<your-shop>.de/api/v1/checkout/status

​
Parameter overview

​
Header parameters

ParameterDescription
x-sessionRequired field
ID of the current session.
More information: Storefront API Basics

​
Example response

{
   "currency" : "EUR",
   "paymentCost" : 0,
   "shippingCost" : 0,
   "surchargeCost" : 0,
   "total" : 14.9,
   "totalGross" : 14.9,
   "totalNet" : 12.52,
   "totalTax" : 2.38,
   "totalVoucher" : 0,
   "totalWeight" : 0
}

​
POST checkout/setAccountType

The following call sets the type of account used for the order in the checkout. This determines whether the customer orders as a new customer, existing customer, or guest. 
POST https://<your-shop>.de/api/v1/checkout/setAccountType

​
Example request

{
    "accountType": "guest"
}

​
Parameter overview

​
Header parameters

ParameterDescription
x-sessionRequired field
ID of the current session.
More information: Storefront API Basics

​
Body parameters

ParameterTypeDescription
accountTypestringRequired field
Type of customer account.
Valid values:
- "new" - New customer
- "registered" - Registered customer
- "guest" - Order without registration