| Table of Contents |
|---|
Über BillPay
Allgemeines zu BillPay
Bei BillPay verschicken Sie als Händler die Rechnung mit dem Logo und der Kontoverbindung von BillPay. Der Dienstleister zahlt Ihnen den Rechnungsbetrag aus und kümmert sich anschließend um das komplette nachgelagerte Debitorenmanagement.
Hinweis: Billpay wird zum Ende März 2022 eingestellt.
| Page properties | ||||||||
|---|---|---|---|---|---|---|---|---|
|
Weitere Informationen finden Sie auch auf der Webseite von BillPay (http://www.billpay.de).
Hinweis: Zur einfacheren Integration in den Shop des Händlers gibt es von BillPay ein Javascript-Widget zur Darstellung der BillPay-Zahlungsarten im Checkout-Prozess, das eingebunden werden muss. Eine Dokumentation des Widgets findet sich online auf der Webseite https://techdocs.billpay.de/de/An_Entwickler/JavaScript-Widget.html.
Diagramm zum Prozessablauf
BillPay Prozessablauf inklusive Zahlartensteuerung PreScore (oberhalb der mittleren Linie)
| Multiexcerpt include | ||||||
|---|---|---|---|---|---|---|
|
| Multiexcerpt include | ||||||
|---|---|---|---|---|---|---|
|
Aufruf der Schnittstelle für BillPay-Rechnungskauf
Dieses Kapitel beschreibt, wie Sie eine BillPay-Zahlung initialisieren. Nach erfolgreicher Initialisierung können Sie BillPay-Zahlungen bei Lieferung buchen. Zusätzlich können Sie BillPay-Reservierungen teilweise aktivieren und so das Zahlungsziel für den Kunden setzen. Auch eine nachträgliche Änderung des Warenkorbs ist über dieselbe Schnittstelle möglich und hier im Anschluss beschrieben. Ebenso wird die Stornierung einer BillPay-Zahlung hier nachfolgend erklärt.
Um eine Zahlung mit BillPay über eine Server-zu-Server-Verbindung auszuführen, rufen verwenden Sie bitte folgende URL auf:
|
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Request_Intro PageWithExcerpt Reuse API
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Parameter für BillPay-Zahlungen
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Response_Intro PageWithExcerpt Reuse API
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Antwort-Parameter für BillPay-Zahlungen
Nachträgliche Warenkorbänderung
Der Inhalt eines Warenkorbs kann nachträglich bei Retouren oder zusätzlichen Artikeln noch geändert werden. Dabei wird der alte Warenkorb komplett ersetzt, Adresse, Referenznummern, Währung, Zahlart und Ratenanzahl bleiben jedoch erhalten. Bei gleichem oder geringerem Warenkorbwert wird die Änderung stets akzeptiert. Bei einer Erhöhung des Bestellwertes wird eine erneute Autorisierung versucht. Nur im Erfolgsfall gilt dann der neue Warenkorb, sonst bleibt der bisherige bestehen. Bei einer Warenkorbänderung einer bereits aktivierten Bestellung informiert BillPay den Kunden über den geänderten Forderungsbetrag.
Um den zugehörigen Warenkorb einer mit BillPay zuvor initialisierten Zahlung zu ändern, rufen verwenden Sie bitte folgende URL auf:
|
Die folgende Tabelle beschreibt die zu verschlüsselnden Übergabeparameter:
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Parameter für nachträgliche Warenkorbänderung bei BillPay-Zahlungen
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Response_Intro PageWithExcerpt Reuse API
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Ergebnis-Parameter für BillPay-Zahlungen
BillPay mit Zahlartensteuerung (PreScore)
Mit der Zahlartensteuerung von BillPay können Onlinehändler in ihrem Onlineshop eine Vorauswahl der BillPay-Zahlarten treffen, die einem bestimmten Kunden angezeigt werden. So sieht der Kunde nur die für ihn zulässigen Zahlarten, wodurch die Konversionsrate steigt. Für die Zahlartensteuerung muss die Prüfung des Endkunden auf Identität und Bonität bereits vor Auswahl der Zahlart erfolgen. Die BillPay-Zahlartensteuerung ist damit eine Alternative zur Prüfung der Endkundenanfrage nach Auswahl einer Zahlungsart. Ein Händlerportal bei BillPay kann entweder mit Zahlartensteuerung oder ohne Zahlartensteuerung arbeiten, aber nicht beides zur gleichen Zeit.
Zur Nutzung der Zahlartensteuerung muss der Händler einen entsprechenden Vertrag mit BillPay haben und dafür freigeschaltet sein. Für diesen Ablauf teilt sich der BillPay-Vorgang in die vorangestellte Zahlartensteuerung (PreScore) sowie die folgende Anlage der BillPay-Zahlung, die jetzt mit weniger Aufrufparametern auskommt. Die Antwort auf die Reservierung entspricht wieder dem oben erklärten normalen Ablauf.
Um die Zahlartensteuerung von BillPay über eine Server-zu-Server-Verbindung auszuführen, rufen verwenden Sie bitte folgende URL auf:
|
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Request_Intro PageWithExcerpt Reuse API
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Parameter für BillPay-Zahlartensteuerung (PreScore)
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Response_Intro PageWithExcerpt Reuse API
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Antwort-Parameter für BillPay-Zahlartensteuerung
Zum Anlagen und Reservieren der Zahlung sind im zweiten Aufruf je nach Zahlart nur noch wenige zusätzliche Parameter erforderlich.
Hinweis: Sobald der Kunde seine personenbezogenen Daten oder den Warenkorb ändert, muss die Zahlartensteuerung erneut gesendet werden. Die vorher ausgeführte Zahlartensteuerung ist nicht mehr gültig.
Um die BillPay-Zahlung über eine Server-zu-Server-Verbindung anzulegen, rufen verwenden Sie bitte folgende URL auf:
|
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Request_Intro PageWithExcerpt Reuse API
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Parameter für BillPay-Zahlung nach Zahlartensteuerung
Die Antwort-Parameter entsprechen nun dem oben erläuterten allgemeinen Ablauf.
PayLater über BillPay
Dieses Kapitel beschreibt, wie Sie eine PayLater-Zahlung über BillPay abwickeln. PayLater ist eine Erweiterung der BillPay-Anbindung. Weitere Funktionen und allgemeine Parameter sind in der allgemeinen BillPay-Dokumentation beschrieben.
Um PayLater-Zahlung über BillPay durchzuführen, rufen verwenden Sie bitte folgende URL auf:
|
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Request_Intro PageWithExcerpt Reuse API
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Parameter für PayLater über BillPay
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Response_Intro PageWithExcerpt Reuse API
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Antwort-Parameter für PayLater über BillPay
Buchung & Teilbuchung über Socket-Verbindung
Buchungen sind über eine Server-zu-Server-Kommunikation möglich. Der Händler kann eine BillPay-Reservierung vollständig oder teilweise aktivieren und so das Zahlungsziel für den Kunden setzen. Übergibt der Händler dabei eine neue Referenznummer, so wird die Referenznummer der Reservierung erst aktualisiert und danach erfolgt die Aktivierung der Rechnung. Um eine Buchung (Capture) über eine Server-zu-Server-Verbindung auszuführen, verwenden Sie bitte folgende URL:
|
Die folgenden Tabellen beschreiben die Übergabeparameter und Rückgabewerte, die über die Socket-Verbindung ausgetauscht werden.
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Request_Intro PageWithExcerpt Reuse API
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Parameter für Buchung von BillPay-Zahlungen
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Response_Intro PageWithExcerpt Reuse API
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Antwort-Parameter für Buchung von BillPay-Zahlungen
Storno von BillPay-Zahlungen
Stornierungen sind über eine Server-zu-Server-Kommunikation möglich. Bei BillPay können sowohl Reservierungen als auch Aktivierungen storniert werden, wobei zwischen Voll- und Teilstornierungen zu unterscheiden ist. Um eine BillPay-Zahlung zu stornieren, verwenden Sie bitte die folgende URL:
|
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Request_Intro PageWithExcerpt Reuse API
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Parameter für Storno von BillPay-Zahlungen
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Response_Intro PageWithExcerpt Reuse API
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Ergebnis-Parameter für Storno von BillPay-Zahlungen
Batch-Nutzung der Schnittstelle
Grundsätzliche Informationen zur Arbeit mit Batch-Dateien sowie zu deren Aufbau erfahren Sie im separaten Handbuch zum Batchmanager. Im Batch-Verfahren sind nicht alle Funktionen verfügbar, die für die Online-Schnittstelle verfügbar sind.Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Batch_Intro PageWithExcerpt Reuse API
Dieses Kapitel beschreibt die Parameter, die Sie im Datensatz (Record) für die Ausführung einer BillPay-Zahlung übergeben müssen und welche Informationen Sie der Antwort-Datei über den Status des Zahlungsvorgangs entnehmen können.
Folgende Tabelle gibt eine Übersicht der pro Aktion jeweils möglichen Batch-Versionen und ihrer Besonderheiten:
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Beschreibung der möglichen Batch-Versionen
Der Aufbau für eine BillPay-Zahlung in einer einzureichenden Batch-Datei sieht folgendermaßen aus:
| Multiexcerpt include | ||||||
|---|---|---|---|---|---|---|
|
Beispiel für Master-MID-Funktion:
| Multiexcerpt include | ||||||
|---|---|---|---|---|---|---|
|
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Batch_Request_Intro PageWithExcerpt Reuse API
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Beschreibung der Felder im Datensatz von Batch-Dateien
Der Record-Bereich in der Antwort-Datei zu Batch-Transaktionen sieht folgendermaßen aus:
| Multiexcerpt include | ||||||
|---|---|---|---|---|---|---|
|
folgende Tabelle beschreibt die Antwort-Parameter, die der Batch-Manager im Record-Bereich zu jeder Transaktion speichert (hier nicht erklärte Standardparameter wie etwa <TransID> oder <RefNR> und Aufrufparameter, werden unverändert zum Aufruf wieder zurückgegeben und sind vorstehend beschrieben):Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Batch_Response_Intro PageWithExcerpt Reuse API
| Table Filter | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Beschreibung der Ergebnis-Parameter im Datensatz von Batch-Dateien