The shoppingCart represents customer shopping cart for which a payment is triggered.
Example:
<shoppingCart>
<items>
<item>
<product>
<id>123</id>
<name>Jeans</name>
<description>stonewashed</description>
<unitPrice>
<grossAmount>40</grossAmount>
<taxAmount rate="20" name="VAT">6.67</taxAmount>
</unitPrice>
<type>Physical</type>
</product>
<quantity>1</quantity>
<totalPrice>
<grossAmount>30</grossAmount>
<taxAmount rate="20" name="VAT">5</taxAmount>
</totalPrice>
<discount>
<name>Jeans-Promotion</name>
<grossAmount>-10</grossAmount>
<taxAmount rate="20" name="VAT">-1.67</taxAmount>
</discount>
</item>
<item>
<product>
<id>456</id>
<name>CD Rom</name>
<description>CD Rom</description>
<unitPrice>
<grossAmount>50</grossAmount>
<taxAmount rate="10" name="VAT">4.54</taxAmount>
</unitPrice>
<type>Digital</type>
</product>
<quantity>2</quantity>
<totalPrice>
<grossAmount>80</grossAmount>
<taxAmount rate="10" name="MwSt">7.27</taxAmount>
</totalPrice>
<discount>
<name>Spring-Promotion</name>
<grossAmount>-20</grossAmount>
<taxAmount rate="10" name="VAT">-1.82</taxAmount>
</discount>
</item>
<item>
<product>
<id>789</id>
<name>Gift Card</name>
<description>Gift Card Purchase</description>
<unitPrice>
<grossAmount>15</grossAmount>
<taxAmount rate="20" name="VAT">2.5</taxAmount>
</unitPrice>
<type>GiftCard</type>
</product>
<quantity>1</quantity>
<totalPrice>
<grossAmount>15</grossAmount>
<taxAmount rate="20" name="VAT">2.5</taxAmount>
</totalPrice>
</item>
</items>
<subTotalAmount>125</subTotalAmount>
<shippingCost>
<name>Express</name>
<grossAmount>30</grossAmount>
<taxAmount rate="20" name="VAT">5</taxAmount>
</shippingCost>
<discounts>
<discount>
<name>Sales-Discount</name>
<grossAmount>-10</grossAmount>
<taxAmount rate="20" name="VAT">-1.67</taxAmount>
<type>Discount</type>
</discount>
</discounts>
<amountsByTax>
<amountByTax taxName="VAT" taxRate="10">
<grossAmount>80</grossAmount>
<taxAmount>7.27</taxAmount>
</amountByTax>
<amountByTax taxName="VAT" taxRate="20">
<grossAmount>45</grossAmount>
<taxAmount>7.5</taxAmount>
</amountByTax>
</amountsByTax>
<totalAmount>145</totalAmount>
<totalTaxAmount>18.1</totalTaxAmount>
</shoppingCart>
Fields:
| field (type, required) | description |
|---|---|
| items (arrayOfItem, required) | The shopping cart items |
| items.item (item, required) | One item of the shopping cart |
| items.item.product (product, required) | Product |
| items.item.product.id (string, required) | Product ID |
| items.item.product.name (string, required) | Product Name Example: "Jeans" |
| items.item.product.description (string) | Product Description Example: "Stonewashed Size L" |
| items.item.product.unitPrice (amountWithTax, required) | Price of the Product Item (per unit) including tax if applicable |
| items.item.product.type (itemType) | The type of the product Needed for specific payment methods, e.g. Klarna Deposit The allowed values for this field can be found on the relevant payment method documentation page. |
| items.item.quantity (positiveInt, required) | Number of items |
| items.item.totalPrice (amountWithTax, required) | Total price considering numbers of item and unit price including tax if applicable Calculation: (unitPrice - discount per unit) x quantity = totalPrice or unitPrice x quantity - total discount per item = totalPrice |
| items.item.discount (amountWithTaxAndName) | Total discount per item with tax (if applicable) and discount name (name is mandatory). Calculation: discount per unit x quantity |
| subTotalAmount (decimal) | Sub total amount of the shopping cart. This amount does not include potential shipping costs or discounts on shopping cart level |
| shippingCost (amountWithTaxAndName) | Shipping Costs with Tax (if applicable) and Name (name is mandatory) |
| discounts (array of type amountWithTaxAndNameAndType) | Discount(s) on shopping cart level. Collection of discount (max 100 items) |
| amountsByTax (array of type amountByTax) | Collection of amountByTax (max 100 items) |
| amountsByTax.amountByTax (amountByTax) | List of grouped amounts per tax category |
| amountsByTax.amountByTax.taxName (amountByTax, attribute) | Name/description of the Tax type Example: "VAT" |
| amountsByTax.amountByTax.taxRate (amountByTax, attribute) | Tax rate (percentage) Example: "10" |
| amountsByTax.amountByTax.grossAmount (amountByTax) | Gross Amount of tax category group (sum of totalPrice of all items with the same tax rate), grouped per tax rate |
| amountsByTax.amountByTax.taxAmount (amountByTax) | Tax amount of tax category group (sum of totalPrice of all items with the same tax rate), grouped per tax rate |
| totalAmount (decimal) | Total amount of the shopping cart. This amount also includes potential shipping costs or discounts on shopping cart level |
| totalTaxAmount (decimal) | Total tax amount of the shopping cart (if applicable). This amount also includes the tax of potential shipping costs or discounts on shopping cart level |
Please note that the total amount of the shopping cart is not part of the shoppingCart element, but is to be found in getRedirectDataRequest.redirectParameters.grossAmount or initiatePayment.amount.
XML Schema:
<s:complexType name="shoppingCart">
<s:sequence>
<s:element minOccurs="1" maxOccurs="1" name="items">
<s:complexType>
<s:sequence>
<s:element minOccurs="1" maxOccurs="100" name="item" >
<s:complexType>
<s:sequence>
<s:element minOccurs="1" maxOccurs="1" name="product">
<s:complexType>
<s:sequence>
<s:element minOccurs="1" maxOccurs="1" name="id" type="lengthRestrictedString" />
<s:element minOccurs="1" maxOccurs="1" name="name" type="lengthRestrictedString" />
<s:element minOccurs="0" maxOccurs="1" name="description" type="lengthRestrictedString" />
<s:element minOccurs="1" maxOccurs="1" name="unitPrice" type="amountWithTax" />
<s:element minOccurs="0" maxOccurs="1" name="type" type="itemType" />
</s:sequence>
</s:complexType>
</s:element>
<s:element minOccurs="1" maxOccurs="1" name="quantity" type="positiveInt" />
<s:element minOccurs="1" maxOccurs="1" name="totalPrice" type="amountWithTax" />
<s:element minOccurs="0" maxOccurs="1" name="discount" type="amountWithTaxAndName" />
</s:sequence>
</s:complexType>
</s:element>
</s:sequence>
</s:complexType>
</s:element>
<s:element minOccurs="0" maxOccurs="1" name="subTotalAmount" type="s:decimal" />
<s:element minOccurs="0" maxOccurs="1" name="shippingCost" type="amountWithTaxAndName" />
<s:element minOccurs="0" maxOccurs="1" name="discounts" nillable="true">
<s:complexType>
<s:sequence>
<s:element minOccurs="1" maxOccurs="100" name="discount" type="amountWithTaxAndNameAndType" />
</s:sequence>
</s:complexType>
</s:element>
<s:element minOccurs="0" maxOccurs="1" name="amountsByTax" nillable="true">
<s:complexType>
<s:sequence>
<s:element minOccurs="1" maxOccurs="100" name="amountByTax" type="amountByTax"></s:element>
</s:sequence>
</s:complexType>
</s:element>
</s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="totalAmount" type="s:decimal" />
<s:element minOccurs="0" maxOccurs="1" name="totalTaxAmount" type="s:decimal" />
</s:complexType>