Cancellation Request (Vollstornierung)

Über den "Cancel"-Request wird eine zuvor bei BillPay eröffnete Forderung vollständig storniert. Falls der Kunde bereits Zahlungen an BillPay geleistet hat ("Kauf auf Rechnung", "Ratenkauf Schweiz") oder der fällige Betrag bereits vom Konto eingezogen wurde ("Lastschrift", "PayLater"), wird der geleistete Betrag automatisiert an den Kunden zurücküberwiesen und eine entsprechende Mitteilung versendet.

*Hinweis: Ggf. entstehen bei der Vollstornierung einer Bestellung Kosten für den Händler.

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

Cancel Params Knoten

Attribut Pflicht Werte Details
reference + AN..40 Eindeutige Bestellnummer beim Händler (erlaubte Zeichen: 0-9,a-z,A-Z,.,-,_,/)
carttotalgross + N..7 Aktueller Bruttogesamtwert der Bestellung in kleinster Währungseinheit (1,00 EUR = 100)
currency + Vorgabe ISO 4217 Dreistelliger Währungscode (z.B. "EUR")
    <cancel_params 
        reference="1773673332" 
        carttotalgross="43000" 
        currency="EUR" />    

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" />
   <cancel_params reference="1773673332" carttotalgross="43000" currency="EUR" />
</data>  

Response

Als Response auf den "Cancel"-Request liefert das BillPay System keine zusätzlichen Parameter außer dem Fehlercode / der Fehlermeldung.

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