Extended requirements

The following payment systems are covered in this section: BILLPAY, ELV, KLARNA, PAYPAL
As additional requirements the following elements need to be stated within the MDXI XML.

For detailed information about the MDXI XML or specific elements see chapter MDXI XML.

  • The ClientIP provides the IP address of the customer.
<ClientIP>208.67.222.222</ClientIP>
  • The ShoppingCart should be provided as detailed as possible and item prices should be stated as gross prices with an tax amount.
<ShoppingCart>
   <Description>Example shopping cart</Description>
   <Item>
      <ProductNr>001</ProductNr>
      <Description>Test product A</Description>
      <Quantity>2</Quantity>
      <ItemPrice Tax="1.00">6.00</ItemPrice>
   </Item>
   <Item>
      <ProductNr>002</ProductNr>
      <Description>Test product B</Description>
      <Quantity>1</Quantity>
      <ItemPrice Tax="1.80">10.80</ItemPrice>
   </Item>
   <SubTotal>22.80</SubTotal>
   <Discount>-5.00</Discount>
   <ShippingCosts Tax="1.25">7.50</ShippingCosts>
   <Tax>5.05</Tax>
</ShoppingCart>

The shopping cart total must also be equal the price stated in the element Price outside the ShoppingCart. If not, the complete shopping cart is discarded. See the MDXI XML chapter for detailed information about stating amounts and calculating the total amount.

<Price>25.30</Price>
  • The Address should be provided as detailed as possible with the elements Name, Street, Zip, City, Country, Email, Phone and State. State is to specifiy if the address is of Argentina, Brazil, Canada, China, Indonesia, India, Japan, Mexico, Thailand or USA. If Mode=ReadWrite is set and the required elements are set empty, the data can be entered by the customer on the mPAY24 PayPage.
<BillingAddr Mode="ReadOnly">
   <Name Gender="M" Birthday="1990-01-31">John Doe</Name>
   <Street>Main street 1</Street>
   <Zip>1010</Zip>
   <City>Vienna</City>
   <Country Code="AT" />
   <Email>[email protected]</Email>
   <Phone>+4368012345678</Phone>
</BillingAddr>
  • The ShippingAddr only needs to be provided if it differs from the BillingAddr.

Important: Payments could be rejected by the acquirer if invalid data is provided or neccessary data is missing.

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:etp="https://www.mpay24.com/soap/etp/1.5/ETP.wsdl">
   <SOAP-ENV:Header />
   <SOAP-ENV:Body>
      <etp:SelectPayment>
         <merchantID>90000</merchantID>
         <mdxi>
            <Order>
               <ClientIP>208.67.222.222</ClientIP>
               <Tid>90021</Tid>
               <TemplateSet Language="DE" CSSName="MODERN"/>
               <ShoppingCart>
                  <Description>Example shopping cart</Description>
                  <Item>
                     <ProductNr>001</ProductNr>
                     <Description>Test product A</Description>
                     <Quantity>2</Quantity>
                     <ItemPrice Tax="1.00">6.00</ItemPrice>
                  </Item>
                  <Item>
                     <ProductNr>002</ProductNr>
                     <Description>Test product B</Description>
                     <Quantity>1</Quantity>
                     <ItemPrice Tax="1.80">10.80</ItemPrice>
                  </Item>
                  <SubTotal>22.50</SubTotal>
                  <Discount>-5.00</Discount>
                  <ShippingCosts Tax="1.25">7.50</ShippingCosts>
                  <Tax>5.05</Tax>
               </ShoppingCart>
               <Price>25.30</Price>
               <BillingAddr Mode="ReadOnly">
                  <Name Gender="M" Birthday="1990-01-31">John Doe</Name>
                  <Street>Main street 1</Street>
                  <Zip>1010</Zip>
                  <City>Vienna</City>
                  <Country Code="AT" />
                  <Email>[email protected]</Email>
                  <Phone>+4368012345678</Phone>
               </BillingAddr>
               <URL>
                  <Success>http://www.hotelmuster.at/succ.php</Success>
                  <Error>http://www.hotelmuster.at/err.php</Error>
                  <Confirmation>http://www.hotelmuster.at/conf.php</Confirmation>
               </URL>
            </Order>
         </mdxi>
      </etp:SelectPayment>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>