Update Order Request

Mit dem Update kann die Referenznummer einer Bestellung nachträglich geändert werden. Achtung! Mit der Änderung der Bestellreferenz vor Aktivierung ändert sich zwingend der Verwendungszweck auf der Überweisung. Der neue Verwendungszweck muss im Anschluss aus der Antwort zum getBillPayBankData ausgelesen werden.

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

update_params-Knoten

In diesem Knoten wird die Bestellreferenznummer der Bestellung aktualisiert, indem die nach der Autorisierung vergebene BillPay-Transaction ID und die neue gewünschte Bestellreferenz übergeben wird.

Attribut Pflicht Werte Details
bptid + AN..50 Eindeutige BillPay Transaktionsnummer für diese Anfrage
reference + AN..40 Neue Bestellnummer beim Händler (erlaubte Zeichen: 0-9, a-z, A-Z,.,-,_,/)
<update_params
        bptid="1aa2fb2d-2b78-4393-bf06-be0012dda337"
        reference="Bestellnummer321"/>

id_update_list-Knoten

In diesem Knoten werden einzelne id_update-Knoten übergeben, deren Parameter zu aktualisierende Artikel-IDs des Warenkorbs sowie die neue gewünschte ID pro Artikel enthalten.

Attribut Pflicht Werte Details
articleid + AN..40 Die ursprüngliche Artikel ID des Warenkorbs
updateid + AN..40 Die neue Artikel ID für den Warenkorb
<id_update_list>
        <id_update articleid="54321" updateid="12345"/>
</id_update_list>

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"/>
    <update_params 
        bptid="b61648a3-46a1-4771-834f-903b89510ed9" 
        reference="1591605922_updated" />
    <id_update_list>
      <id_update 
          articleid="1234" 
          updateid="1234_mod" />
      <id_update 
          articleid="2345" 
          updateid="2345_mod" />
    </id_update_list>
</data>        

Update Order Response

<?xml version="1.0" encoding="UTF-8"?>
<data api_version="1.5.11" customer_message="" merchant_message="" error_code="0">
</data>