Bei der Vorauthorisierungsanfrage wird überprüft, ob der Kunde mit einer der BillPay-Zahlungsarten bestellen darf. Im BillPay-System wird durch diesen Request eine Identitäts- und Bonitätsanfrage angestoßen, die als Ergebnis einen der beiden Werte "APPROVED" oder "DENIED" an Ihr System zurück liefert.

Im Falle einer erfolgreichen Autorisierung wird die Bestellung im BillPay-System mit der von Ihnen als reference übermittelten eindeutigen ID angelegt. Aus juristischer Sicht wird in diesem Moment die Forderung, die sich aus der Bestellung gegenüber dem Kunden ergibt an BillPay abgetreten.

Request

XML Header

<?xml version="1.0" encoding="UTF-8"?>

Data Knoten

Attribut Pflicht Werte Details
tcaccepted + 0/1 Gibt an, ob die BillPay AGB vom Kunden akzeptiert wurden
expecteddaystillshipping + N..7 Payment Typ 1-4: Übertragung der erwarteten Versandverzögerung, Payment Typ 7: Anzahl Tage bis zum Reiseantritt des Kunden
capturerequestnecessary + Standard: 0 Flag zur Nutzung von Autocapture. Wichtig: Ein Abweichen von diesem Standard kann nur in Absprache mit dem BillPay Integrations-Support zugelassen werden.
paymenttype + 1: Rechnung
2: Lastschrift
3: Ratenkauf
4: PayLater
7: PayLater mit Schuldbeitritt
Id der gewünschten Zahlart
version + wird vom Bibliothek festgelegt Versionsnummer der genutzten API
<data 
    tcaccepted="1" 
    expecteddaystillshipping="0" 
    capturerequestnecessary="0" 
    paymenttype="1" 
    api_version="1.5.11">
    <!-- Request Daten -->
</data>

Default Params Knoten (Händler Zugangsdaten)

Attribut Pflicht Werte Details
mid + N..4 Ihre Händler Id
pid + N..4 Ihre domainspezifische Portal Id
bpsecure + String MD5 Hash des geheimen Passwort
    <default_params 
        mid="4441" 
        pid="6021" 
        bpsecure="25d55ad283aa400af464c76d713c07ad"/>

Preauth Params Knoten

Dieser Knoten ist nur dann erforderlich, wenn Ihr Portal unsere "Prescoring" Anfrage nutzt. Wenn Sie Prescoring vertraglich nicht vereinbart haben, können Sie diesen Knoten ignorieren.

Attribut Pflicht Werte Details
is_prescored + 0: Nein
1: Ja
Wert zeigt an, ob eine Prescore Anfrage vorher gesendet wurde.

Wenn für Ihr Portal Prescoring aktiviert ist, muss der Wert "1" gesendet werden.
bptid + AN ... 50 BillPay Transaktionsnummer
Die Transaktionsnummer wird in der Antwort auf die Prescore Anfrage gesendet. Die Transaktionsnummer dient dazu, die Prescore und Preauthorize-Anfragen einander zu zuordnen.
    <preauth_params 
        is_prescored="1" 
        bptid="1aa2fb2d-2b78-4393-bf06-be0012dda337" />

Customer Details Knoten (Rechnungsadresse des Kunden)

Attribut Pflicht Werte Details
customerid - AN..40 Kundennummer beim Händler
(Erlaubte Zeichen: 0-9, a-z, A-Z, .,-,_,/)
customertype + g: Gast
n: Neukunde
e: Existierend
Art des Kunden
salutation + Vorgabe: siehe Glossar Anreden Anrede
title - AN..20 akademischer Titel (z.B. "Dr.")
firstName + AN..40 Vorname
lastName + AN..40 Nachname
street + AN..40 Straße
streetNo - N..7 Hausnummer
addressAddition - AN..40 zusätzliche Adressdaten
zip + AN..7 Postleitzahl
city + AN..40 Ort
country + ISO3166-aplha-3 Land des Endkunden (z.B."DEU")
email + AN..40 (exkl. nicht valide Sonderzeichen) E-Mail-Adresse
phone -* AN..40 Telefonnummer
cellPhone - AN..40 Mobiltelefonnummer
birthday -* JJJJMMTT Geburtsdatum
language + ISO639-1 Sprache des Endkunden (z.B. "de")
ip + IPv4 & IPv6 IP-Adresse des Clients
customerGroup + p: Privat
b: Business/Geschäftskunde
Kundengruppe
    <customer_details 
        customerid="123456" 
        customertype="e" 
        salutation="Herr" 
        title="" 
        firstName="Thomas" 
        lastName="Testkunde" 
        street="Tinnowitzerstrasse 1" 
        streetNo="" 
        addressAddition="" 
        zip="10115" 
        city="Berlin" 
        country="DEU" 
        email="anymail@gmx.de" 
        phone="03012345678" 
        cellPhone="" 
        birthday="19741012" 
        language="de" 
        ip="127.0.0.1" 
        customerGroup="p" />

phone ist Pflichtfeld wenn paymenttype gleich 3/4/7 (alle Finanzierungskäufe) oder wenn country gleich NLD

birthday ist Pflichtfeld wenn customerGroup gleich "p"

Shipping Details Knoten (Versandadresse des Kunden)

In diesem Knoten kann eine zur Rechnungsadresse abweichende Liederadresse übergeben werden. Achtung: Aus Risikogründen kann dieses Feature leider nicht allen Portalen angeboten werden und bedarf einer vertraglichen Einigung. Bitte sprechen Sie vorab mit einem unserer Mitarbeiter über diese Möglichkeit.

*Alle abweichenden Adressdaten müssen nur dann ausgefüllt werden, wenn useBillingAddress = 0

*phone ist Pflichtfeld wenn paymenttype gleich 3/4/7 (alle Finanzierungskäufe) oder wenn country gleich NLD

Attribut Pflicht Werte Details
useBillingAddress + 0/1 0: abweichende Lieferadresse nutzen
1: Rechnungsadresse als Lieferadresse nutzen
Kennzeichen, ob die Rechnungsadresse gleich der Lieferadresse des Kunden ist.
salutation +* Vorgabe: siehe Glossar Anreden Anrede
title - AN..20 akademischer Titel (z.B. "Dr.")
firstName +* AN..40 Vorname
lastName +* AN..40 Nachname
street +* AN..40 Straße
streetNo - N..7 Hausnummer
addressAddition - AN..40 zusätzliche Adressdaten
zip +* AN..7 Postleitzahl
city +* AN..40 Ort
country +* ISO3166-aplha-3 Land des Endkunden (z.B."DEU")
phone -* AN..40 Telefonnummer
cellPhone - AN..40 Mobiltelefonnummer
    <shipping_details 
        useBillingAddress="1" 
        salutation="" 
        title="" 
        firstName="" 
        lastName="" 
        street="" 
        streetNo=""
        addressAddition="" 
        zip="" 
        city="" 
        country="" 
        phone="" 
        cellPhone="" />

Company Details Knoten (Details zu Geschäftskunden)

Sollten Sie Ihre Ware an Geschäftskunden verkaufen (`customertype´ = "b"), müssen in diesem Knoten alle Details zum Geschäftskunden übergeben werden.

*siehe Glossar Vorgaben für Geschäftskunden

Attribut Pflicht Werte Details
name + AN..200 Name der Firma
legalForm + Vorgabe siehe Glossar Unternehmensformen Rechtsform der Firma
registerNumber +* AN..20 Handelsregisternummer/Firmenbuch
holderName +* AN..100 Name des Inhabers der Firma
taxNumber - AN..14 gültige UStIdNr. (DEXXXXXXXXX)
    <company_details
        name="Testfirma"
        legalForm="GmbH"
        registerNumber="HRB 122 029 B"
        holderName="Testinhaber"
        taxNumber="DE268874183" />

Article Data Knoten (Liste der bestellten Artikel)

Im article_data-Knoten werden alle Informationen rund um die in der Bestellung enthaltenen Warenkorbpositionen abgebildet. Pro einzigartigem Artikel wird ein `article´-Knoten gesetzt.

*Wichtig! IDs dürfen in einer Anfrage nicht mehrfach auftreten!

Attribut Pflicht Werte Details
articleid + AN..20 Eindeutige Artikel-ID für die Warenkorbposition*
articlequantity + N..7 Menge des Artikels im Warenkorb
articlename + AN..50 Name des Artikels
articlecategory - AN..50 Artikel Kategorie
articlesubcategory1 - AN..50 Artikel Sub-Kategorie
articlesubcategory2 - AN..50 Artikel Sub-Kategorie
articleprice + N..7 Nettopreis des Artikels in kleinster Währungseinheit (1,00 EUR = 100)
articlepricegross + N..7 Bruttopreis des Artikels in kleinster Währungseinheit (1,00 EUR = 100)
    <article_data>
         <article 
            articleid="1234" 
            articlequantity="2" 
            articlename="Shirt" 
            articlecategory="Clothing"
            articlesubcategory1="Van Laack"
            articleprice="10084" 
            articlepricegross="12000" />
        <article 
            articleid="2345" 
            articlequantity="1" 
            articlename="Hose" 
            articlecategory="Clothing"
            articlesubcategory1="Ralph Lauren"
            articleprice="16807" 
            articlepricegross="20000" />
    </article_data>

Bank Data Knoten (Kunden Kontodaten)

Die Bankdaten werden nur für die Zahlarten Lastschrift und PayLater benötigt. Dies ist der Fall, wenn der Parameter "payment" die Werte "2", "3", "4", "7" oder "9" enthält. Andernfalls werden die Bankdaten ignoriert.

Attribut Pflicht Werte Details
accountholder (wenn paymenttype in {2,3,4,7}) AN..100 Vor- und Nachname des Kontoinhabers
accountnumber (wenn paymenttype in {2,3,4,7}) AN..30 IBAN (International Bank Account Number)
sortcode (wenn paymenttype in {2,3,4,7}) AND LAND NOT DE AN..11 BIC (Bank Identifier Code)
    <bank_account  
        accountholder="Thomas Testkunde"
        accountnumber="DE12345678123456781234" 
        sortcode="" />

Total Knoten (Details zur Bestellung)

Im total-Knoten werden alle zusammenfassenden Informationen der Bestellung, sowie die händlerseitige Bestellnummer übergeben.

*Wenn Standard capturerequestnecessary = "0" eingehalten

Attribut Pflicht Werte Details
shippingname + AN..50 Versandkosten-Name (z.B. "Express-Versand")
shippingprice + N..7 Nettowert aller warenkorbspez. Kosten (z.B. Lieferkosten, Zuschläge) in kleinster Währungseinheit (1,00 EUR = 100)
shippingpricegross + N..7 Bruttowert aller warenkorbspez. Kosten (z.B. Lieferkosten, Zuschläge) in kleinster Währungseinheit (1,00 EUR = 100)
rebate + N..7 Positiver Nettowert aller Rabatte, Coupons und sonstiger betragsmindernder Posten in kleinster Währungseinheit (1,00 EUR = 100)
rebategross + N..7 Positiver Bruttowert aller Rabatte, Coupons und sonstiger betragsmindernder Posten in kleinster Währungseinheit (1,00 EUR = 100)
carttotalprice + N..7 Nettowert der Bestellung in kleinster Währungseinheit (1,00 EUR = 100)
carttotalpricegross + N..7 Bruttowert der Bestellung in kleinster Währungseinheit (1,00 EUR = 100)
currency + Vorgabe ISO4217 Dreistelliger Währungscode (z.B. "EUR")
reference +* AN..40 Eindeutige Bestellnummer beim Händler (erlaubte Zeichen: 0-9, a-z, A-Z,.,-,_,/)
    <total 
        shippingname="Express Versand" 
        shippingprice="840" 
        shippingpricegross="1000" 
        rebate="1681" 
        rebategross="2000" 
        carttotalprice="36134" 
        carttotalpricegross="43000" 
        currency="EUR"
        reference="1773673332" />

Rate Request Knoten

Für die Zahlungsarten PayLater / Ratenkauf (paymenttype="3" / paymenttype="4" / paymenttype="7") müssen zusätzlich zum total-Knoten spezifische Parameter für den Teilzahlungsplan übergeben werden.
Diese Werte werden festgelegt und in Ihren Checkout Formular von unseren Widget übergeben, wenn der Kunde seine bevorzugte Ratenoption in unserem Widget auswählt und weiter durch Ihren Checkout geht.

Attribut Pflicht Werte Details
term +* N..7 Laufzeit des Ratenplans
ratecount + N..7 Anzahl der Raten, die während der Laufzeit zu zahlen sind
totalamount + N..7 Gesamtbetrag gemäß Ratenplan inklusive der PayLater Gebühren
<rate_request ratecount="6" term="6" totalamount="45520"/>

Fraud Detection Knoten (Betrugsprävention)

In diesem Knoten wird die für die Session des Kunden vergebene einzigartige ID übergeben. Diese dient der Bekämpfung von Betrug in Ihrem Shop und muss immer identisch mit der als "identifier" benannten ID in der Konfiguration des JavaScript Widgets sein.

Attribut Pflicht Werte Details
session_id + AN..100 Session ID des Kunden
    <fraud_detection session_id="6bd7d364d6deeb5a46282fa9308da20f"/>

Async Capture Request Knoten (Anzahlungsprozess)

Für die Zahlungsarten PayLater / Ratenkauf bietet BillPay ein einzigartiges Feature: die Anzahlung von Teilbeträgen. Sollte ein Kunde auf Grund der Identitäts- und Bonitätsprüfung nicht zum Kauf über BillPay zugelassen worden sein, kann er/sie diese Entscheidung ggf. durch die Anzahlung via Online-Überweisung positiv beeinflussen.

In diesem Knoten übergeben Sie uns die für die Weiterleitung des Kunden relevanten URLs.

Attribut Pflicht Werte Details
redirect_url + AN Die Landingpage Ihres Shops, die den Kunden nach der Anzahlung über desen Erfolg/Misserfolg informiert.
notify_url + AN Händlerseitiger Webservice für das Statusupdate nach Anzahlung (enthält die Kostenaufstellung der PayLater- / Ratenkauf-Bestellung)
    <async_capture_request>
        <redirect_url><![CDATA[http://url1.de/redirect]]></redirect_url>
        <notify_url><![CDATA[http://url1.de/notify]]></notify_url>
    </async_capture_request>

Vollständiges XML-Beispiel Kauf auf Rechnung B2C

<?xml version="1.0" encoding="UTF-8"?>
<data tcaccepted="1" expecteddaystillshipping="0" capturerequestnecessary="0" paymenttype="1" api_version="1.5.11">
   <default_params mid="4441" pid="6021" bpsecure="25d55ad283aa400af464c76d713c07ad" />
   <customer_details customerid="" customertype="e" salutation="Herr" title="" firstName="Thomas" lastName="Testkunde" street="Tinnowitzerstrasse 1" streetNo="" addressAddition="" zip="10115" city="Berlin" country="DEU" email="anymail@gmx.de" phone="03012345678" cellPhone="" birthday="19741012" language="de" ip="127.0.0.1" customerGroup="p" />
  <shipping_details useBillingAddress="1" salutation="" title="" firstName="" lastName="" street="" streetNo="" addressAddition="" zip="" city="" country="" phone="" cellPhone="" />
  <total shippingname="Express Versand" shippingprice="840" shippingpricegross="1000" rebate="1681" rebategross="2000" carttotalprice="36134" carttotalpricegross="43000" currency="EUR" reference="1773673332" reference2="" />
  <article_data>
    <article articleid="1234" articlequantity="2" articlename="Shirt" articlecategory="Clothing" articlesubcategory1="Van Laack" articleprice="10084" articlepricegross="12000" />
    <article articleid="2345" articlequantity="1" articlename="Hose" articlecategory="Clothing" articlesubcategory1="Ralph Lauren" articleprice="16807" articlepricegross="20000" />
  </article_data>
  <fraud_detection session_id="97d3d1b1cc6b0686bbc1f19feec80e6c" />
</data>   

Vollständiges XML-Beispiel Kauf auf Rechnung B2B

<?xml version="1.0" encoding="UTF-8"?>
<data tcaccepted="1" expecteddaystillshipping="0" capturerequestnecessary="0" paymenttype="1" api_version="1.5.18">
  <default_params mid="4441" pid="6021" bpsecure="25d55ad283aa400af464c76d713c07ad" />
  <customer_details customerid="" customertype="e" salutation="Herr" title="" firstName="Thomas" lastName="Testkunde" street="Tinnowitzerstrasse 1" streetNo="" addressAddition="" zip="10115" city="Berlin" country="DEU" email="anymail@gmx.de" phone="03012345678" cellPhone="" birthday="19741012" language="de" ip="127.0.0.1" customerGroup="b" />
  <shipping_details useBillingAddress="1" salutation="" title="" firstName="" lastName="" street="" streetNo="" addressAddition="" zip="" city="" country="" phone="" cellPhone="" />
  <company_details name="Test Company" legalForm="gmbh" registerNumber="HRB 9874568" holderName="Thomas Testkunder" taxNumber="DE268874183" />
  <total shippingname="Express Versand" shippingprice="840" shippingpricegross="1000" rebate="1681" rebategross="2000" carttotalprice="36134" carttotalpricegross="43000" currency="EUR" reference="761463697" reference2="" />
  <article_data>
    <article articleid="1234" articlequantity="2" articlename="Shirt" articleprice="10084" articlepricegross="12000" />
    <article articleid="2345" articlequantity="1" articlename="Hose" articleprice="16807" articlepricegross="20000" />
  </article_data>
  <fraud_detection session_id="97d3d1b1cc6b0686bbc1f19feec80e6c" />
</data>  

Vollständiges XML-Beispiel Lastschrift

<?xml version="1.0" encoding="UTF-8"?>
<data tcaccepted="1" expecteddaystillshipping="0" capturerequestnecessary="0" paymenttype="2" api_version="1.5.18">
  <default_params mid="4441" pid="6021" bpsecure="25d55ad283aa400af464c76d713c07ad" />
  <customer_details customerid="" customertype="e" salutation="Herr" title="" firstName="Thomas" lastName="Testkunde" street="Tinnowitzerstrasse 1" streetNo="" addressAddition="" zip="10115" city="Berlin" country="DEU" email="anymail@gmx.de" phone="03012345678" cellPhone="" birthday="19741012" language="de" ip="127.0.0.1" customerGroup="p" />
  <shipping_details useBillingAddress="1" salutation="" title="" firstName="" lastName="" street="" streetNo="" addressAddition="" zip="" city="" country="" phone="" cellPhone="" />
  <bank_account accountholder="Thomas Testkunde" accountnumber="DE89370400440532013000" sortcode="" />
  <total shippingname="Express Versand" shippingprice="840" shippingpricegross="1000" rebate="1681" rebategross="2000" carttotalprice="36134" carttotalpricegross="43000" currency="EUR" reference="1519088641" reference2="" />
  <article_data>
    <article articleid="1234" articlequantity="2" articlename="Shirt" articleprice="10084" articlepricegross="12000" />
    <article articleid="2345" articlequantity="1" articlename="Hose" articleprice="16807" articlepricegross="20000" />
  </article_data>
  <fraud_detection session_id="12a854eb6758ec7770860a230269275b" />
</data>

Vollständiges XML-Beispiel PayLater/Ratenkauf

<?xml version="1.0" encoding="UTF-8"?>
<data tcaccepted="1" expecteddaystillshipping="0" capturerequestnecessary="0" paymenttype="4" api_version="1.5.18">
  <default_params mid="4441" pid="6021" bpsecure="25d55ad283aa400af464c76d713c07ad" />
  <customer_details customerid="" customertype="e" salutation="Herr" title="" firstName="Thomas" lastName="Testkunde" street="Tinnowitzerstrasse 1" streetNo="" addressAddition="" zip="10115" city="Berlin" country="DEU" email="anymail@gmx.de" phone="03012345678" cellPhone="" birthday="19741012" language="de" ip="127.0.0.1" customerGroup="p" />
  <shipping_details useBillingAddress="1" salutation="" title="" firstName="" lastName="" street="" streetNo="" addressAddition="" zip="" city="" country="" phone="" cellPhone="" />
  <rate_request ratecount="6" term="6" totalamount="45520" />
  <bank_account accountholder="Thomas Testkunde" accountnumber="DE89370400440532013000" sortcode="" />
  <total shippingname="Express Versand" shippingprice="840" shippingpricegross="1000" rebate="1681" rebategross="2000" carttotalprice="36134" carttotalpricegross="43000" currency="EUR" reference="1747930987" reference2="" />
  <article_data>
    <article articleid="1234" articlequantity="2" articlename="Shirt" articleprice="10084" articlepricegross="12000" />
    <article articleid="2345" articlequantity="1" articlename="Hose" articleprice="16807" articlepricegross="20000" />
  </article_data>
  <fraud_detection session_id="12a854eb6758ec7770860a230269275b" />
  <async_capture_request>
    <redirect_url>
<![CDATA[http://google.de/my_shops_paylater_giropay_redirect_url.php]]>
  </redirect_url>
  <notify_url>
<![CDATA[http://google.de/my_shops_paylater_giropay_notify_url.php]]>
  </notify_url>
  </async_capture_request>
</data>

Response

Data Knoten (Ergebnis der Anfrage)

Der data-Knoten enthält alle Informationen darüber, ob der Kunde zur Zahlung via BillPay zugelassen wurde und welche eindeutige ID (bptid) der gesendeten Anfrage vergeben wurde. Zudem wird eine Meldung zur Anzeige für den Kunden und eine Meldung für das Log der Händler mit übertragen.

Attribut Pflicht Werte Details
status + Vorgabe "APPROVED" / "DENIED" Status der Identitäts- und Bonitätsprüfung
bptid + AN..50
Eindeutige BillPay Transaktionsnummer für diese Anfrage
error_code + N..3 Fehlercode (0: kein Fehler);
merchant_message - AN..200 Detaillierte Fehlermeldung für den Händler
customer_message - AN..200 Fehlernachricht zur Anzeige für den Kunden im Frontend
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<data 
    bptid="1aa2fb2d-2b78-4393-bf06-be0012dda337" 
    customer_message="" 
    error_code="0" 
    merchant_message=""
    status="APPROVED">
<!-- weitere Antwortdaten -->
</data>

Corrected Address Knoten (Optional: Korrigierte Kundenadresse)

In diesem Knoten gibt die BillPay Schnittstelle die normalisierte Adresse des Kunden zurück.

Attribut Pflicht Werte Details
city + AN..50 Korrigierter Ort
country + Vorgabe ISO3166 alpha-3 Korrigierter Ländercode (z.B. "DEU")
street + AN..50 Korrigierte Straße
streetNo + AN..15 Korrigierte Hausnummer
zip + AN..7 Korrigierte Postleitzahl
    <corrected_address 
        city="Berlin" 
        country="DEU" 
        street="Zinnowitzer Str." 
        streetNo="1" 
        zip="10115"/>

Invoice Bank Account Knoten (nur "Rechnungskauf" & "Ratenkauf CHE", wenn capturerequestnecessary = "0")

In diesem Knoten liefert BillPay Ihnen die Kontodaten für die Kundenüberweisung zurück. Die Kontodaten sind auf den Kundendokumenten (Bestellbestätigung und Rechnung anzudrucken. Die Response liefert die Variablen, welche in einen durch BillPay bereit gestellten Textbaustein einzubetten sind. Bitte sprechen Sie uns an, falls Ihnen die Textbausteine noch nicht bereitgestellt wurden.

Attribut Pflicht Werte Details
account_holder + AN..255 Kontoinhaber für die Forderung
account_number + AN..40 BillPay IBAN für die Forderung
bank_code + AN..16 BillPay BIC für die Forderung
bank_name + AN..255 Name der BillPay Bank für die Forderung
invoice_reference + AN..255 Verwendungszweck für die Forderung
<invoice_bank_account 
    account_holder="BillPay GmbH" 
    account_number="DE07312312312312312" 
    bank_code="BELADEBEXXX" 
    bank_name="Sparkasse Berlin" 
    invoice_reference="BP555666777/9999"/>

Hire Purchase Knoten (nur für PayLater und Ratenkauf)

In diesem Knoten liefert BillPay die Informationen zum Ratenplan.

Attribut Pflicht Werte Details
instl_plan Parent Knoten
num_inst N Anzahl der durch den Kunden zu zahlenden monatlichen Teilbeträge
calc Kind Knoten des instl_plan Knotens.
-> duration N Laufzeit des Ratenplans in Monaten
-> fee_percent N Prozentuale Angabe der PayLater Gebühr
-> fee_total N Gesamt PayLater Gebühren
-> pre-payment N Angezahlter Betrag
-> total_amount N Gesamtbetrag der PayLater-Bestellung
-> eff_annual N Jährlicher Effektivzins in Prozent
-> nominal N Jährlicher Nominalzins in Prozent
instl_list Kind Knoten des instl_plan Knotens.
-> instl Kind Knoten des instl_list Knotens.
     date JJJJMMDD Datum des voraussichtlichen Einzugs
     Typ AN Typ der Rate („immediate“, „first“, „date“, „fee“)
<hire_purchase>
    <instl_plan num_inst="6">
      <calc>
        <duration>
          6
        </duration>
        <fee_percent>
          6.00
        </fee_percent>
        <fee_total>
          2520
        </fee_total>
        <pre_payment>
          0
        </pre_payment>
        <total_amount>
          45520
        </total_amount>
        <eff_anual>
          24.21
        </eff_anual>
        <nominal>
          20.57
        </nominal>
      </calc>
      <instl_list>
        <instl date="20160531" Typ="immediate">
          3520
        </instl>
        <instl date="20160630" Typ="first">
          7000
        </instl>
        <instl date="20160731" Typ="date">
          7000
        </instl>
        <instl date="20160831" Typ="date">
          7000
        </instl>
        <instl date="20160930" Typ="date">
          7000
        </instl>
        <instl date="20161031" Typ="date">
          7000
        </instl>
        <instl date="20161130" Typ="date">
          7000
        </instl>
      </instl_list>
    </instl_plan>
  </hire_purchase>