Add Shopping Cart to Deposits

A shopping cart enables the merchant to send a list of items for purchase. The shoppingCart is an optional xml element of:

  • getRedirectDataRequest (in case of Redirect Integration, see getRedirectData) or
  • initiatePaymentRequest (in case of Backend2Backend Integration, see initiatePayment)
  • initiatePaymentFromReferenceRequest (in case of Backend2Backend Integration, see initiatePayment)

The shopping cart element must be used for the following payment methods:

  • PayByInvoiceDeposit (235)

Example of a valid shoppingCart element:

<shoppingCart>
  <items>
    <item>
      <product>
        <id>123</id>
        <name>Jeans</name>
        <description>stonewashed</description>
        <unitPrice>
          <grossAmount>30</grossAmount>
          <taxAmount rate="20" name="VAT">5</taxAmount>">5</taxAmount>
        </unitPrice>
      </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>Skirt</name>
      <description>Flowers Design</description>
      <unitPrice>
        <grossAmount>40</grossAmount>
        <taxAmount rate="10" name="VAT">3.63</taxAmount>
      </unitPrice>
    </product>
    <quantity>2</quantity>
    <totalPrice>
      <grossAmount>80</grossAmount>
      <taxAmount rate="10" name="MwSt">7.27</taxAmount>
    </totalPrice>
    <discount>
      <name>Spring-Promotion</name>
      <grossAmount>-10</grossAmount>
      <taxAmount rate="10" name="VAT">-0.91</taxAmount>
    </discount>
  </item>
  </items>
<subTotalAmount>90</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>
  </discount>
</discounts>
<amountsByTax>
  <amountByTax taxName="VAT" taxRate="10">
    <grossAmount>70</grossAmount>
    <taxAmount>6.36</taxAmount>
  </amountByTax>
  <amountByTax taxName="VAT" taxRate="20">
    <grossAmount>40</grossAmount>
    <taxAmount>6.67</taxAmount>
  </amountByTax>
</amountsByTax>
</shoppingCart>

Redirect Integration

See PayByInvoice Deposit (via RatePay) for an example of the getRedirectDataRequest with shoppingCart element.

Backend2Backend Integration

See PayByInvoice Deposit (via RatePay) for an example of the initiatePaymentRequest with shoppingCart element.