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 include detailed information with the following elements: Name, Street, Zip, City, Country, Email, Phone, and State. State specifies the address location for Argentina, Brazil, Canada, China, Indonesia, India, Japan, Mexico, Thailand, or USA. When Mode=ReadWrite is set and required elements are empty, customers can enter data on the mPAY24 PayPage. When Mode=ReadOnly, customers cannot modify the data.

<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>

test