<?xml version="1.0" encoding="UTF-8"?>
<?xml-stylesheet type="text/xsl" href="https://webservices.micropayment.de/xslt/?tpl=public.service-html.transformer"?>
<service request-protocol="HTTP_PARAMS" response-protocol="NVP" type="PrepayService" location="https://webservices.micropayment.de/public/prepay/public/v1.0/nvp">
  <description>Api steuert die Bezahlung per Vorkasse</description>
  <types>
    <type name="void" type="void">
      <description><![CDATA[keine Rückgabe]]></description>
    </type>
    <type name="string" type="string">
      <description><![CDATA[String: ein Datentyp der eine Folge von Zeichen (z. B. Buchstaben, Ziffern, Sonderzeichen und Steuerzeichen) aus einem definierten Zeichensatz enthält]]></description>
    </type>
    <type name="integer" type="integer">
      <description><![CDATA[Integer: ein Datentyp der ganzzahlige Werte speichert]]></description>
    </type>
    <type name="array" type="array">
      <description><![CDATA[Array: eine Datenstruktur die eine Liste von Elementen, meißt eines einheitlichen Datentyps, enthält - die Elemente werden über einen ganzzahligen(integer) Index adressiert]]></description>
    </type>
    <type name="null" type="null">
      <description><![CDATA[keine Rückgabe]]></description>
    </type>
    <type name="bool" type="bool">
      <description><![CDATA[Boolean - ein Datentyp der immer einen von zwei Werten annimmt um eine logische Aussage zu treffen üblich sind  "true/false" oder "1/0" (wahr = 1; falsch = 0)]]></description>
    </type>
  </types>
  <methods>
    <method name="resetTest">
      <description><![CDATA[l�scht alle Kunden und Transaktionen in der Testumgebung]]></description>
      <parameters>
        <parameter name="accessKey" type="string" required="true">
          <description><![CDATA[AccessKey aus dem Controlcenter]]></description>
        </parameter>
        <parameter name="testMode" type="integer" required="true">
          <description><![CDATA[Muss 1 sein]]></description>
        </parameter>
      </parameters>
      <return type="void">
        <description><![CDATA[]]></description>
        <parameters/>
      </return>
    </method>
    <method name="customerCreate">
      <description><![CDATA[legt neuen Kunden an]]></description>
      <parameters>
        <parameter name="accessKey" type="string" required="true">
          <description><![CDATA[AccessKey aus dem Controlcenter]]></description>
        </parameter>
        <parameter name="testMode" type="integer" required="false" default="0">
          <description><![CDATA[ aktiviert Testumgebung]]></description>
        </parameter>
        <parameter name="customerId" type="string" required="false" default="null">
          <description><![CDATA[ eigene eindeutige ID des Kunden, wird anderenfalls erzeugt]]></description>
        </parameter>
        <parameter name="freeParams" type="array" required="false" default="null">
          <description><![CDATA[ Liste mit freien Parametern, die dem Kunden zugeordnet werden]]></description>
        </parameter>
      </parameters>
      <return type="array">
        <description><![CDATA[]]></description>
        <parameters>
          <parameter name="customerId" type="string" required="true">
            <description><![CDATA[eigene oder erzeugte eindeutige ID des Kunden]]></description>
          </parameter>
        </parameters>
      </return>
    </method>
    <method name="customerSet">
      <description><![CDATA[ordnet weitere freie Parameter dem Kunden zu, oder �ndert sie]]></description>
      <parameters>
        <parameter name="accessKey" type="string" required="true">
          <description><![CDATA[AccessKey aus dem Controlcenter]]></description>
        </parameter>
        <parameter name="testMode" type="integer" required="false" default="0">
          <description><![CDATA[ aktiviert Testumgebung]]></description>
        </parameter>
        <parameter name="customerId" type="string" required="true">
          <description><![CDATA[eindeutige ID des Kunden]]></description>
        </parameter>
        <parameter name="freeParams" type="array" required="false" default="null">
          <description><![CDATA[ Liste mit zus�tzlichen freien Parametern]]></description>
        </parameter>
      </parameters>
      <return type="void">
        <description><![CDATA[]]></description>
        <parameters/>
      </return>
    </method>
    <method name="customerGet">
      <description><![CDATA[ermittelt alle freien Parameter des Kunden]]></description>
      <parameters>
        <parameter name="accessKey" type="string" required="true">
          <description><![CDATA[AccessKey aus dem Controlcenter]]></description>
        </parameter>
        <parameter name="testMode" type="integer" required="false" default="0">
          <description><![CDATA[ aktiviert Testumgebung]]></description>
        </parameter>
        <parameter name="customerId" type="string" required="true">
          <description><![CDATA[ID des Kunden]]></description>
        </parameter>
      </parameters>
      <return type="array">
        <description><![CDATA[]]></description>
        <parameters>
          <parameter name="freeParams" type="array" required="false" default="null">
            <description><![CDATA[ Liste mit allen freien Parametern]]></description>
          </parameter>
        </parameters>
      </return>
    </method>
    <method name="customerList">
      <description><![CDATA[ermittelt alle Kunden]]></description>
      <parameters>
        <parameter name="accessKey" type="string" required="true">
          <description><![CDATA[AccessKey aus dem Controlcenter]]></description>
        </parameter>
        <parameter name="testMode" type="integer" required="false" default="0">
          <description><![CDATA[ aktiviert Testumgebung]]></description>
        </parameter>
        <parameter name="from" type="integer" required="false" default="0">
          <description><![CDATA[ Position des ersten auszugebenden Kunden]]></description>
        </parameter>
        <parameter name="count" type="integer" required="false" default="100">
          <description><![CDATA[ Anzahl der auszugebenden Kunden]]></description>
        </parameter>
      </parameters>
      <return type="array">
        <description><![CDATA[]]></description>
        <parameters>
          <parameter name="customerIdList" type="array" required="true">
            <description><![CDATA[Liste mit allen freien Parametern]]></description>
          </parameter>
          <parameter name="count" type="integer" required="true">
            <description><![CDATA[Anzahl der Kunden in der Liste]]></description>
          </parameter>
          <parameter name="maxCount" type="integer" required="true">
            <description><![CDATA[Gesamtanzahl aller Kunden]]></description>
          </parameter>
        </parameters>
      </return>
    </method>
    <method name="addressSet">
      <description><![CDATA[erzeugt oder �ndert Adressdaten eines Kunden]]></description>
      <parameters>
        <parameter name="accessKey" type="string" required="true">
          <description><![CDATA[AccessKey aus dem Controlcenter]]></description>
        </parameter>
        <parameter name="testMode" type="integer" required="false" default="0">
          <description><![CDATA[ aktiviert Testumgebung]]></description>
        </parameter>
        <parameter name="customerId" type="string" required="true">
          <description><![CDATA[ID des Kunden]]></description>
        </parameter>
        <parameter name="form" type="string" required="false" default="'NONE'">
          <description><![CDATA[ Anrede "NONE", "SIR", "MADAM", "MISS", "COMPANY"]]></description>
        </parameter>
        <parameter name="firstName" type="string" required="true">
          <description><![CDATA[Vorname]]></description>
        </parameter>
        <parameter name="surName" type="string" required="true">
          <description><![CDATA[Nachname]]></description>
        </parameter>
        <parameter name="address" type="string" required="false" default="">
          <description><![CDATA[ Zus�tzliche Angaben z.B. "bei Schmidt"]]></description>
        </parameter>
        <parameter name="street" type="string" required="true">
          <description><![CDATA[Strasse und Hausnummer]]></description>
        </parameter>
        <parameter name="zip" type="string" required="true">
          <description><![CDATA[Postleitzahl]]></description>
        </parameter>
        <parameter name="city" type="string" required="true">
          <description><![CDATA[Ort]]></description>
        </parameter>
        <parameter name="country" type="string" required="false" default="'DE'">
          <description><![CDATA[ Land]]></description>
        </parameter>
      </parameters>
      <return type="void">
        <description><![CDATA[]]></description>
        <parameters/>
      </return>
    </method>
    <method name="addressGet">
      <description><![CDATA[ermittelt die Adresse des Kunden]]></description>
      <parameters>
        <parameter name="accessKey" type="string" required="true">
          <description><![CDATA[AccessKey aus dem Controlcenter]]></description>
        </parameter>
        <parameter name="testMode" type="integer" required="false" default="0">
          <description><![CDATA[ aktiviert Testumgebung]]></description>
        </parameter>
        <parameter name="customerId" type="string" required="true">
          <description><![CDATA[ID des Kunden]]></description>
        </parameter>
      </parameters>
      <return type="array">
        <description><![CDATA[]]></description>
        <parameters>
          <parameter name="form" type="string" required="true">
            <description><![CDATA[Anrede]]></description>
          </parameter>
          <parameter name="firstName" type="string" required="true">
            <description><![CDATA[Vorname]]></description>
          </parameter>
          <parameter name="surName" type="string" required="true">
            <description><![CDATA[Nachname]]></description>
          </parameter>
          <parameter name="address" type="string" required="true">
            <description><![CDATA[Zus�tzliche Angaben]]></description>
          </parameter>
          <parameter name="street" type="string" required="true">
            <description><![CDATA[Strasse und Hausnummer]]></description>
          </parameter>
          <parameter name="zip" type="string" required="true">
            <description><![CDATA[Postleitzahl]]></description>
          </parameter>
          <parameter name="city" type="string" required="true">
            <description><![CDATA[Ort]]></description>
          </parameter>
          <parameter name="country" type="string" required="true">
            <description><![CDATA[Land]]></description>
          </parameter>
        </parameters>
      </return>
    </method>
    <method name="contactDataSet">
      <description><![CDATA[erzeugt oder �ndert Kontaktdaten eines Kunden]]></description>
      <parameters>
        <parameter name="accessKey" type="string" required="true">
          <description><![CDATA[AccessKey aus dem Controlcenter]]></description>
        </parameter>
        <parameter name="testMode" type="integer" required="false" default="0">
          <description><![CDATA[ aktiviert Testumgebung]]></description>
        </parameter>
        <parameter name="customerId" type="string" required="true">
          <description><![CDATA[ID des Kunden]]></description>
        </parameter>
        <parameter name="email" type="string" required="false" default="null">
          <description><![CDATA[ Emailadresse des Kunden]]></description>
        </parameter>
        <parameter name="phone" type="string" required="false" default="null">
          <description><![CDATA[ Festnetzanschluss]]></description>
        </parameter>
        <parameter name="mobile" type="string" required="false" default="null">
          <description><![CDATA[ Handynummer]]></description>
        </parameter>
        <parameter name="language" type="string" required="false" default="null">
          <description><![CDATA[ Sprache]]></description>
        </parameter>
      </parameters>
      <return type="void">
        <description><![CDATA[]]></description>
        <parameters/>
      </return>
    </method>
    <method name="contactDataGet">
      <description><![CDATA[ermittelt die Kontaktdaten des Kunden]]></description>
      <parameters>
        <parameter name="accessKey" type="string" required="true">
          <description><![CDATA[AccessKey aus dem Controlcenter]]></description>
        </parameter>
        <parameter name="testMode" type="integer" required="false" default="0">
          <description><![CDATA[ aktiviert Testumgebung]]></description>
        </parameter>
        <parameter name="customerId" type="string" required="true">
          <description><![CDATA[ID des Kunden]]></description>
        </parameter>
      </parameters>
      <return type="array">
        <description><![CDATA[]]></description>
        <parameters>
          <parameter name="email" type="string" required="true">
            <description><![CDATA[Emailadresse]]></description>
          </parameter>
          <parameter name="phone" type="string" required="true">
            <description><![CDATA[Festnetzanschluss]]></description>
          </parameter>
          <parameter name="mobile" type="string" required="true">
            <description><![CDATA[Handynummer]]></description>
          </parameter>
          <parameter name="language" type="string" required="true">
            <description><![CDATA[Sprache]]></description>
          </parameter>
        </parameters>
      </return>
    </method>
    <method name="sessionCreate">
      <description><![CDATA[erzeugt einen neuen Bezahlvorgang
 l�st die Benachrichtigung sessionStatus mit dem Status "INIT" aus]]></description>
      <parameters>
        <parameter name="accessKey" type="string" required="true">
          <description><![CDATA[AccessKey aus dem Controlcenter]]></description>
        </parameter>
        <parameter name="testMode" type="integer" required="false" default="0">
          <description><![CDATA[ aktiviert Testumgebung]]></description>
        </parameter>
        <parameter name="customerId" type="string" required="true">
          <description><![CDATA[ID des Kunden]]></description>
        </parameter>
        <parameter name="sessionId" type="string" required="false" default="null">
          <description><![CDATA[ eigene eindeutige ID des Vorgangs, wird anderenfalls erzeugt]]></description>
        </parameter>
        <parameter name="project" type="string" required="true">
          <description><![CDATA[das Projektk�rzel f�r den Vorgang]]></description>
        </parameter>
        <parameter name="projectCampaign" type="string" required="false" default="null">
          <description><![CDATA[ ein Kampagnenk�rzel des Projektbetreibers]]></description>
        </parameter>
        <parameter name="account" type="string" required="false" default="null">
          <description><![CDATA[ Account des beteiligten Webmasters]]></description>
        </parameter>
        <parameter name="webmasterCampaign" type="string" required="false" default="">
          <description><![CDATA[ ein Kampagnenk�rzel des Webmasters]]></description>
        </parameter>
        <parameter name="amount" type="integer" required="false" default="null">
          <description><![CDATA[ abzurechnender Betrag in Cent, Standard aus Konfiguration]]></description>
        </parameter>
        <parameter name="currency" type="string" required="false" default="'EUR'">
          <description><![CDATA[ W�hrung]]></description>
        </parameter>
        <parameter name="title" type="string" required="false" default="null">
          <description><![CDATA[ Bezeichnung der zu kaufenden Sache, Standard aus Konfiguration]]></description>
        </parameter>
        <parameter name="payText" type="string" required="false" default="null">
          <description><![CDATA[ Verwendungszweck f�r �berweisung, Standard Projektname und $title]]></description>
        </parameter>
        <parameter name="expireDays" type="string" required="false" default="21">
          <description><![CDATA[ Ablauf der Session in Tagen, genauer Ablauf wird als $expireDate zur�ckgegeben]]></description>
        </parameter>
        <parameter name="ip" type="string" required="false" default="null">
          <description><![CDATA[ IP des Benutzers]]></description>
        </parameter>
        <parameter name="freeParams" type="array" required="false" default="null">
          <description><![CDATA[ Liste mit freien Parametern, die dem Vorgang zugeordnet werden]]></description>
        </parameter>
      </parameters>
      <return type="array">
        <description><![CDATA[]]></description>
        <parameters>
          <parameter name="sessionId" type="string" required="true">
            <description><![CDATA[eigene oder erzeugte eindeutige ID des Vorgangs]]></description>
          </parameter>
          <parameter name="status" type="string" required="true">
            <description><![CDATA[Vorgangsstatus "INIT"]]></description>
          </parameter>
          <parameter name="amount" type="integer" required="true">
            <description><![CDATA[�bergebener Betrag bzw. Standard aus Konfiguration in Cent]]></description>
          </parameter>
          <parameter name="currency" type="string" required="true">
            <description><![CDATA[�bergebene W�hrung bzw. "EUR"]]></description>
          </parameter>
          <parameter name="title" type="string" required="true">
            <description><![CDATA[�bergebene Kaufsache bzw. Standard aus Konfiguration]]></description>
          </parameter>
          <parameter name="payToken" type="string" required="true">
            <description><![CDATA[Token, das Kunde bei �berweisung angeben muss]]></description>
          </parameter>
          <parameter name="payText" type="string" required="true">
            <description><![CDATA[Verwendungszweck, inkl. Token]]></description>
          </parameter>
          <parameter name="expireDate" type="string" required="true">
            <description><![CDATA[Ablaufdatum der Session, kann bis zu 2 Tagen l�nger sein als durch expireDays vorgegeben]]></description>
          </parameter>
          <parameter name="dueDate" type="string" required="true">
            <description><![CDATA[letzter �berweisungstermin f�r Kunden]]></description>
          </parameter>
          <parameter name="bankName" type="string" required="true">
            <description><![CDATA[Bank, an die �berwiesen werden soll]]></description>
          </parameter>
          <parameter name="bankCountry" type="string" required="true">
            <description><![CDATA[Land der Bank]]></description>
          </parameter>
          <parameter name="bankCode" type="string" required="true">
            <description><![CDATA[Bankleitzahl]]></description>
          </parameter>
          <parameter name="accountNumber" type="string" required="true">
            <description><![CDATA[Kontonummer]]></description>
          </parameter>
          <parameter name="accountHolder" type="string" required="true">
            <description><![CDATA[Kontoinhaber]]></description>
          </parameter>
          <parameter name="bic" type="string" required="true">
            <description><![CDATA[SWIFT BIC f�r ausl�ndische Kunden]]></description>
          </parameter>
          <parameter name="iban" type="string" required="true">
            <description><![CDATA[IBAN]]></description>
          </parameter>
        </parameters>
      </return>
    </method>
    <method name="sessionSet">
      <description><![CDATA[ordnet weitere freie Parameter der Session zu, oder �ndert sie]]></description>
      <parameters>
        <parameter name="accessKey" type="string" required="true">
          <description><![CDATA[AccessKey aus dem Controlcenter]]></description>
        </parameter>
        <parameter name="testMode" type="integer" required="false" default="0">
          <description><![CDATA[ aktiviert Testumgebung]]></description>
        </parameter>
        <parameter name="sessionId" type="string" required="true">
          <description><![CDATA[ID des Vorgangs]]></description>
        </parameter>
        <parameter name="freeParams" type="array" required="false" default="null">
          <description><![CDATA[ Liste mit zus�tzlichen freien Parametern]]></description>
        </parameter>
      </parameters>
      <return type="void">
        <description><![CDATA[]]></description>
        <parameters/>
      </return>
    </method>
    <method name="sessionGet">
      <description><![CDATA[ermittelt Daten eines Bezahlvorgangs]]></description>
      <parameters>
        <parameter name="accessKey" type="string" required="true">
          <description><![CDATA[AccessKey aus dem Controlcenter]]></description>
        </parameter>
        <parameter name="testMode" type="integer" required="false" default="0">
          <description><![CDATA[ aktiviert Testumgebung]]></description>
        </parameter>
        <parameter name="sessionId" type="string" required="true">
          <description><![CDATA[ID des Vorgangs]]></description>
        </parameter>
      </parameters>
      <return type="array">
        <description><![CDATA[]]></description>
        <parameters>
          <parameter name="status" type="string" required="true">
            <description><![CDATA[Vorgangsstatus "INIT", "OPEN", "PAID", "OVERPAID", "CLOSED"]]></description>
          </parameter>
          <parameter name="customerId" type="string" required="true">
            <description><![CDATA[ID des Kunden]]></description>
          </parameter>
          <parameter name="project" type="string" required="true">
            <description><![CDATA[zugeordnetes Projekt]]></description>
          </parameter>
          <parameter name="projectCampaign" type="string" required="true">
            <description><![CDATA[zugeordnete Projektkampagne]]></description>
          </parameter>
          <parameter name="account" type="string" required="true">
            <description><![CDATA[zugeordneter Webmasteraccount]]></description>
          </parameter>
          <parameter name="webmasterCampaign" type="string" required="true">
            <description><![CDATA[zugeordnete Webmasterkampagne]]></description>
          </parameter>
          <parameter name="amount" type="integer" required="true">
            <description><![CDATA[�bergebener Betrag bzw. Standard aus Konfiguration in Cent]]></description>
          </parameter>
          <parameter name="orderAmount" type="integer" required="true">
            <description><![CDATA[geforderter Betrag der Session]]></description>
          </parameter>
          <parameter name="paidAmount" type="integer" required="true">
            <description><![CDATA[bereits bezahlter Betrag]]></description>
          </parameter>
          <parameter name="openAmount" type="integer" required="true">
            <description><![CDATA[offener bzw. �berzahlter (negativer) Betrag, Differenz aus orderAmount und paidAmount]]></description>
          </parameter>
          <parameter name="currency" type="string" required="true">
            <description><![CDATA[�bergebene W�hrung bzw. "EUR"]]></description>
          </parameter>
          <parameter name="title" type="string" required="true">
            <description><![CDATA[�bergebene Kaufsache bzw. Standard aus Konfiguration]]></description>
          </parameter>
          <parameter name="payToken" type="string" required="true">
            <description><![CDATA[Token, das Kunde bei �berweisung angeben muss]]></description>
          </parameter>
          <parameter name="payText" type="string" required="true">
            <description><![CDATA[Verwendungszweck f�r �berweisung]]></description>
          </parameter>
          <parameter name="expireDate" type="string" required="true">
            <description><![CDATA[Ablaufdatum]]></description>
          </parameter>
          <parameter name="dueDate" type="string" required="true">
            <description><![CDATA[letzter �berweisungstermin]]></description>
          </parameter>
          <parameter name="bankName" type="string" required="true">
            <description><![CDATA[Bank]]></description>
          </parameter>
          <parameter name="bankCode" type="string" required="true">
            <description><![CDATA[Bankleitzahl]]></description>
          </parameter>
          <parameter name="accountNumber" type="string" required="true">
            <description><![CDATA[Kontonummer]]></description>
          </parameter>
          <parameter name="accountHolder" type="string" required="true">
            <description><![CDATA[Kontoinhaber]]></description>
          </parameter>
          <parameter name="bic" type="string" required="true">
            <description><![CDATA[BIC]]></description>
          </parameter>
          <parameter name="iban" type="string" required="true">
            <description><![CDATA[IBAN]]></description>
          </parameter>
          <parameter name="ip" type="string" required="true">
            <description><![CDATA[IP des Benutzers]]></description>
          </parameter>
          <parameter name="freeParams" type="array" required="false" default="null">
            <description><![CDATA[ Liste mit allen freien Parametern]]></description>
          </parameter>
        </parameters>
      </return>
    </method>
    <method name="sessionList">
      <description><![CDATA[ermittelt alle Bezahlvorg�nge eines Kunden]]></description>
      <parameters>
        <parameter name="accessKey" type="string" required="true">
          <description><![CDATA[AccessKey aus dem Controlcenter]]></description>
        </parameter>
        <parameter name="testMode" type="integer" required="false" default="0">
          <description><![CDATA[ aktiviert Testumgebung]]></description>
        </parameter>
        <parameter name="customerId" type="string" required="true">
          <description><![CDATA[ID des Kunden]]></description>
        </parameter>
      </parameters>
      <return type="array">
        <description><![CDATA[]]></description>
        <parameters>
          <parameter name="count" type="integer" required="true">
            <description><![CDATA[Anzahl der Eintr�ge in sessionIdList]]></description>
          </parameter>
          <parameter name="sessionIdList" type="array" required="true">
            <description><![CDATA[0-indizierte Liste mit Vorgang-IDs]]></description>
          </parameter>
        </parameters>
      </return>
    </method>
    <method name="sessionChange">
      <description><![CDATA[Veranlasst eine Minderung des Betrags und ggf. eine (Teil-)Gutschrift]]></description>
      <parameters>
        <parameter name="accessKey" type="string" required="true">
          <description><![CDATA[AccessKey aus dem Controlcenter]]></description>
        </parameter>
        <parameter name="testMode" type="integer" required="false" default="0">
          <description><![CDATA[ aktiviert Testumgebung]]></description>
        </parameter>
        <parameter name="sessionId" type="string" required="true">
          <description><![CDATA[ID der zugeh�rigen Session]]></description>
        </parameter>
        <parameter name="amount" type="integer" required="true">
          <description><![CDATA[Minderung der Forderung, als positiver Betrag]]></description>
        </parameter>
      </parameters>
      <return type="array">
        <description><![CDATA[]]></description>
        <parameters>
          <parameter name="status" type="string" required="true">
            <description><![CDATA[ggf. neuer Status, "INIT", "OPEN", "PAID", "OVERPAID", "CLOSED"]]></description>
          </parameter>
          <parameter name="orderAmount" type="integer" required="true">
            <description><![CDATA[neuer geforderter Betrag]]></description>
          </parameter>
          <parameter name="paidAmount" type="integer" required="true">
            <description><![CDATA[insgesamt gezahlter Betrag]]></description>
          </parameter>
          <parameter name="openAmount" type="integer" required="true">
            <description><![CDATA[offener bzw. �berzahlter Betrag]]></description>
          </parameter>
        </parameters>
      </return>
    </method>
    <method name="sessionPayinTest">
      <description><![CDATA[simuliert einen Zahlungeingang f�r eine oder mehrere Sessions]]></description>
      <parameters>
        <parameter name="accessKey" type="string" required="true">
          <description><![CDATA[AccessKey aus dem Controlcenter]]></description>
        </parameter>
        <parameter name="testMode" type="integer" required="false" default="0">
          <description><![CDATA[ muss 1 sein]]></description>
        </parameter>
        <parameter name="sessionId" type="string" required="true">
          <description><![CDATA[ID der zugeh�rigen Session]]></description>
        </parameter>
        <parameter name="amount" type="integer" required="true">
          <description><![CDATA[gezahlter Betrag]]></description>
        </parameter>
        <parameter name="bankCountry" type="string" required="false" default="'DE'">
          <description><![CDATA[ Land der Bank]]></description>
        </parameter>
        <parameter name="bankCode" type="string" required="false" default="null">
          <description><![CDATA[ Bankleitzahl des Kunden]]></description>
        </parameter>
        <parameter name="accountNumber" type="string" required="false" default="null">
          <description><![CDATA[ Kontonummer des Kunden]]></description>
        </parameter>
        <parameter name="accountHolder" type="string" required="false" default="null">
          <description><![CDATA[ Kontoinhaber des Kunden]]></description>
        </parameter>
      </parameters>
      <return type="null">
        <description><![CDATA[]]></description>
        <parameters/>
      </return>
    </method>
    <method name="sessionRemindTest">
      <description><![CDATA[simuliert das Ausl�sen einer Erinnerungsmail
 l�st die Benachrichtigung sessionRemind aus]]></description>
      <parameters>
        <parameter name="accessKey" type="string" required="true">
          <description><![CDATA[AccessKey aus dem Controlcenter]]></description>
        </parameter>
        <parameter name="testMode" type="integer" required="false" default="0">
          <description><![CDATA[ muss 1 sein]]></description>
        </parameter>
        <parameter name="sessionId" type="string" required="true">
          <description><![CDATA[ID des Vorgangs]]></description>
        </parameter>
        <parameter name="lastRemind" type="bool" required="false" default="false">
          <description><![CDATA[ Letzte Erinnerung]]></description>
        </parameter>
      </parameters>
      <return type="null">
        <description><![CDATA[]]></description>
        <parameters/>
      </return>
    </method>
    <method name="sessionExpireTest">
      <description><![CDATA[simuliert den Ablauf einer Session
 l�st die Benachrichtigung sessionStatus mit dem Status "CLOSED" aus]]></description>
      <parameters>
        <parameter name="accessKey" type="string" required="true">
          <description><![CDATA[AccessKey aus dem Controlcenter]]></description>
        </parameter>
        <parameter name="testMode" type="integer" required="false" default="0">
          <description><![CDATA[ muss 1 sein]]></description>
        </parameter>
        <parameter name="sessionId" type="string" required="true">
          <description><![CDATA[ID des Vorgangs]]></description>
        </parameter>
      </parameters>
      <return type="null">
        <description><![CDATA[]]></description>
        <parameters/>
      </return>
    </method>
    <method name="sessionRefundTest">
      <description><![CDATA[simuliert die automatische R�ck�berweisung f�r �berzahlte Betr�ge]]></description>
      <parameters>
        <parameter name="accessKey" type="string" required="true">
          <description><![CDATA[AccessKey aus dem Controlcenter]]></description>
        </parameter>
        <parameter name="testMode" type="integer" required="false" default="0">
          <description><![CDATA[ muss 1 sein]]></description>
        </parameter>
        <parameter name="sessionId" type="string" required="true">
          <description><![CDATA[ID des Vorgangs]]></description>
        </parameter>
      </parameters>
      <return type="null">
        <description><![CDATA[]]></description>
        <parameters/>
      </return>
    </method>
    <method name="transactionList">
      <description><![CDATA[ermittelt alle Transaktionen f�r einen Bezahlvorgang]]></description>
      <parameters>
        <parameter name="accessKey" type="string" required="true">
          <description><![CDATA[AccessKey aus dem Controlcenter]]></description>
        </parameter>
        <parameter name="testMode" type="integer" required="false" default="0">
          <description><![CDATA[ aktiviert Testumgebung]]></description>
        </parameter>
        <parameter name="sessionId" type="string" required="true">
          <description><![CDATA[ID des Vorgangs]]></description>
        </parameter>
      </parameters>
      <return type="array">
        <description><![CDATA[]]></description>
        <parameters>
          <parameter name="count" type="integer" required="true">
            <description><![CDATA[Anzahl der Eintr�ge in transactionIdList]]></description>
          </parameter>
          <parameter name="transactionIdList" type="array" required="true">
            <description><![CDATA[0-indizierte Liste mit Transaktions-IDs]]></description>
          </parameter>
        </parameters>
      </return>
    </method>
    <method name="transactionGet">
      <description><![CDATA[ermittelt Daten einer Transaktion]]></description>
      <parameters>
        <parameter name="accessKey" type="string" required="true">
          <description><![CDATA[AccessKey aus dem Controlcenter]]></description>
        </parameter>
        <parameter name="testMode" type="integer" required="false" default="0">
          <description><![CDATA[ aktiviert Testumgebung]]></description>
        </parameter>
        <parameter name="transactionId" type="string" required="true">
          <description><![CDATA[ID des Vorgangs]]></description>
        </parameter>
      </parameters>
      <return type="array">
        <description><![CDATA[]]></description>
        <parameters>
          <parameter name="sessionId" type="string" required="true">
            <description><![CDATA[ID des Vorgangs]]></description>
          </parameter>
          <parameter name="date" type="string" required="true">
            <description><![CDATA[Datum der Transaktion]]></description>
          </parameter>
          <parameter name="type" type="string" required="true">
            <description><![CDATA[Art der Transaktion "CREATE", "PAYIN", "CHANGE", "REFUND", "EXPIRE"]]></description>
          </parameter>
          <parameter name="orderAmount" type="integer" required="true">
            <description><![CDATA[Ver�nderung des geforderten Betrags]]></description>
          </parameter>
          <parameter name="paidAmount" type="integer" required="true">
            <description><![CDATA[Ver�nderung des bezahlten Betrags]]></description>
          </parameter>
          <parameter name="openAmount" type="integer" required="false" default="null">
            <description><![CDATA[ Ver�nderung des offenen Betrags]]></description>
          </parameter>
        </parameters>
      </return>
    </method>
  </methods>
  <notifications>
    <notification name="sessionStatus">
      <description><![CDATA[Benachrichtigt bei jeder �nderung des Vorgangsstatus
 wird erstmalig durch die Funktionen sessionCreate ausgel�st und liefert den status "INIT"
 der Status "CLOSED" wird durch Ablauf der Wartefrist bzw. sessionExpireTest erreicht
 der abschliessende Status "PAID" wird durch typischerweise durch Bezahlung bzw. sessionPayinTest erreicht,
 kann aber auch zB. durch sessionChange bei vorheriger Unterzahlung ausgel�st werden.]]></description>
      <parameters>
        <parameter name="testMode" type="integer" required="true">
          <description><![CDATA[1 bei aktivierter Testumgebung]]></description>
        </parameter>
        <parameter name="customerId" type="string" required="true">
          <description><![CDATA[ID des Kunden]]></description>
        </parameter>
        <parameter name="sessionId" type="string" required="true">
          <description><![CDATA[ID des Vorgangs]]></description>
        </parameter>
        <parameter name="status" type="string" required="true">
          <description><![CDATA[Vorgangsstatus "INIT", "PAID", "CLOSED"]]></description>
        </parameter>
        <parameter name="orderAmount" type="string" required="true">
          <description><![CDATA[gesamter Forderungbetrag]]></description>
        </parameter>
        <parameter name="paidAmount" type="string" required="true">
          <description><![CDATA[gesamt bezahlter Betrag]]></description>
        </parameter>
        <parameter name="openAmount" type="string" required="true">
          <description><![CDATA[offener Betrag]]></description>
        </parameter>
        <parameter name="freeParams" type="array" required="true">
          <description><![CDATA[Liste der freien Parameter]]></description>
        </parameter>
      </parameters>
      <return type="null">
        <description><![CDATA[]]></description>
        <parameters/>
      </return>
    </notification>
    <notification name="sessionEmail">
      <description><![CDATA[Benachrichtigt, wenn dem Kunden eine Email zugesandt wurde oder werden sollte
 der Parameter sent gibt an, ob die Email bereits versandt wurde]]></description>
      <parameters>
        <parameter name="testMode" type="integer" required="true">
          <description><![CDATA[1 bei aktivierter Testumgebung]]></description>
        </parameter>
        <parameter name="customerId" type="string" required="true">
          <description><![CDATA[ID des Kunden]]></description>
        </parameter>
        <parameter name="sessionId" type="string" required="true">
          <description><![CDATA[ID des Vorgangs]]></description>
        </parameter>
        <parameter name="transactionId" type="string" required="true">
          <description><![CDATA[ID der zugeh�rigen Transaction (ausser bei "REMIND" und "LASTREMIND")]]></description>
        </parameter>
        <parameter name="type" type="string" required="true">
          <description><![CDATA[Art der Email "CREATE", "REMIND", "LASTREMIND", "PAYIN", "CHANGE", "EXPIRE"]]></description>
        </parameter>
        <parameter name="sent" type="bool" required="true">
          <description><![CDATA[Email wurde versandt]]></description>
        </parameter>
      </parameters>
      <return type="null">
        <description><![CDATA[]]></description>
        <parameters/>
      </return>
    </notification>
    <notification name="transactionCreate">
      <description><![CDATA[Benachrichtigt bei Erstellung einer neuen Transaktion
 wird ausgel�st durch die Funktionen sessionCreate und sessionChange, sowie die durch Ereignisse bzw. die
 zugeh�rigen Testfunktionen sessionPayinTest, sessionExpireTest und sessionRefundTest]]></description>
      <parameters>
        <parameter name="testMode" type="integer" required="true">
          <description><![CDATA[1 bei aktivierter Testumgebung]]></description>
        </parameter>
        <parameter name="sessionId" type="string" required="true">
          <description><![CDATA[ID des Vorgangs]]></description>
        </parameter>
        <parameter name="transactionId" type="string" required="true">
          <description><![CDATA[ID der Transaktion]]></description>
        </parameter>
        <parameter name="date" type="string" required="true">
          <description><![CDATA[Datum der Transaktion]]></description>
        </parameter>
        <parameter name="type" type="string" required="true">
          <description><![CDATA[Transaktionsart "CREATE", "PAYIN", "CHANGE", "REFUND", "EXPIRE"]]></description>
        </parameter>
        <parameter name="orderAmount" type="string" required="true">
          <description><![CDATA[�nderung des Forderungbetrags]]></description>
        </parameter>
        <parameter name="paidAmount" type="string" required="true">
          <description><![CDATA[�nderung des bezahlten Betrags]]></description>
        </parameter>
        <parameter name="openAmount" type="string" required="true">
          <description><![CDATA[�nderung des offenen Betrags]]></description>
        </parameter>
      </parameters>
      <return type="null">
        <description><![CDATA[]]></description>
        <parameters/>
      </return>
    </notification>
  </notifications>
</service>
