Get BillPay Bank Data Request

Mit dem getBillPayBankData-Request können die Kontodaten für eine Bestellung angefordert werden. Die Response enthält alle Informationen, die zum Begleichen der Forderung durch den Käufer nötig sind. Ist eine Bestellung bereits aktiviert, enthält diese auch das gesetzte Zahlungsziel.

Hinweis: In aller Regel reicht es aus, die Kontodaten aus der preauthorize-Response bei Auto-Capture oder der invoiceCreated-Response auszulesen. Der Request getBillPayBankData ist nur dann nötig, wenn das Abgreifen der Kontodaten über diese beiden Requests bspw. aus prozesstechnischen Gründen nicht möglich ist.

Request

XML Header

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

Data Knoten

Attribut Pflicht Werte Details
version + wird vom Bibliothek festgelegt Versionsnummer der genutzten API
<data 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"/>

Order Params Knoten

Attribut Pflicht Werte Details
reference + AN..40 Bestellnummer beim Händler (erlaubte Zeichen: 0-9, a-z, A-Z,.,-,_,/)
    <order_params reference="Testbestellung123"/>    

Vollständiges XML-Beispiel

<?xml version="1.0" encoding="UTF-8" ?>
<data api_version="1.5.11">
    <default_params 
        mid="4441" 
        pid="6021" 
        bpsecure="25d55ad283aa400af464c76d713c07ad"/>
        <order_params reference="2032322603" />   
</data>    

Get BillPay Bank Data Response

Die Response auf diesen Request liefert alle relevanten Konto- und Zahlungsmodalitäten.

*Hinweis: Durch die Teilaktivierung von einzelnen Bestellpositionen ergeben sich unterschiedliche Zahlungsziele pro Rechnung.

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_duedate + N..8 Zahlungsziel des Kunden im Format JJJJMMTT
duedate +* N..8 Zahlungsziel einer Teillieferung
invoice_number + AN..40 Rechnungsnummer für die aktivierte Forderung
(wurde diese nicht explizit vergeben, ergibt sie sich aus der Händlerreferenznummer+"#")
<?xml version="1.0" encoding="UTF-8" ?>
<data api_version="1.5.11"
    customer_message="" 
    error_code="0" 
    merchant_message="">
    <bank_account 
        account_holder="BillPay GmbH" 
        account_number="DE1200TEST333222110000492156" 
        bank_code="TESTBIC0001" 
        bank_name="BillPay Test Bank" 
        first_duedate="20160324" 
        invoice_reference="BP2032322603/3042">
        <invoice_list>
              <invoice 
                  duedate="20160324" 
                  invoice_number="2032322603#1"/>
        </invoice_list>
    </bank_account>    
</data>