Die Barzahlen-Schnittstelle zur individuellen Integration

API Bibliotheken Prozesse Funktionen Benachrichtigungen

Ihr Ansprechpartner:

Mathias Nestler

Chief Technology Officer

Tel: 030 - 346 46 16 - 00
integration@barzahlen.de

Ihre Nachricht an uns:

Individuelle Integration über die API

Wir bieten Ihnen Module für verschiedene Shopsysteme an. Sie verwenden ein System, welches noch nicht aufgeführt ist und möchten Barzahlen eigenständig anbinden?

Wir stellen Ihnen alle notwendigen Informationen zur Verfügung, um Barzahlen in Ihr System zu implementieren. Dazu gehören natürlich auch Warenwirtschafts- und Backendsysteme. Dank unserer leistungsfähigen API kann Barzahlen in alle gängigen Systeme nahtlos integriert werden.

Neben der Dokumentation zur eigenständigen API-Integration stellen wir Ihnen auch gerne eine fertige API Bibliothek zur Verfügung, mit der Sie die Schnittstelle zu Ihrem Shopsystem ganz einfach selbst entwickeln können.

Auf den folgenden Seiten finden Sie Informationen zur Kommunikation zwischen Ihrem Online-Shop und Barzahlen. Alle auftretenden Fragen zum Prozess, den verwendeten Methoden und Benachrichtigungen werden hier beantwortet.

${:home=>{:paragraph1=>"Barzahlen kann mehrere Benachrichtigungen via HTTP-Push an den Shop senden. Dazu muss im %{url1} eine Benachrichtigungs-URL hinterlegt sein. Wenn Sie eine fertige Barzahlen-Schnittstelle verwenden, finden Sie die entsprechende URL im Handbuch Ihres %{url2}.", :paragraph2=>"Eine Übersicht aller Benachrichtigungen ist in der folgenden Tabelle zu sehen:", :paragraph3=>"Barzahlen wertet als Antwort lediglich den HTTP-Statuscode aus. Ein anderer als Code 200 führt dazu, dass die URL nach etwa 30 Minuten erneut aufgerufen wird. Nach 24 Stunden wird die Benachrichtigung komplett abgebrochen und der Händler erhält per E-Mail einen entsprechenden Hinweis. Zusätzlich hat er im %{url} die Möglichkeit, die nicht zugestellten Benachrichtigungen erneut ausführen zu lassen.", :table=>{:transaction_paid=>"Transaktion bezahlt", :transaction_paid_text=>"Sobald der Kunde bei einem Offline-Partner bezahlt hat, wird der Shop benachrichtigt.", :transaction_expired=>"Transaktion abgelaufen", :transaction_expired_text=>"Nach einem vorher definierten Zeitraum läuft die Transaktion ab und eine Bezahlung der Transaktion ist nicht mehr möglich.", :refund_expired=>"Rückgabe abgelaufen", :refund_expired_text=>"Nach einem vorher definierten Zeitraum läuft die Rückgabe ab und ist nicht mehr möglich.", :refund_completed=>"Rückgabe abgeschlossen", :refund_completed_text=>"Nachdem der Kunde erfolgreich sein Geld zurückbekommen hat, erhält der Shop diese Benachrichtigung."}}, :payment_transactions=>{:heading=>"Benachrichtigungen bei Zahlungs-Transaktionen", :paragraph1=>"Laufende Transaktionen erhalten bei Benachrichtigungen die folgenden Parameter:", :img_alt=>"Benachrichtung bei Zahlungs-Transaktionen", :see_below=>"(siehe unten)", :unique_transaction_id=>"(eindeutige Transaktions-ID)", :if_set=>"(sofern gesetzt)", :if_set_on_creation=>"(sofern beim Zahlungsvorgang gesetzt)", :example=>{:heading=>"Beispiel einer Benachrichtigung", :paragraph1=>"Wenn im %{url1} z. B. die Benachrichtigungs-URL %{url2} hinterlegt ist, dann könnte die Benachrichtigung die folgende Form haben (Reihenfolge der Parameter kann abweichen):"}, :paid=>{:heading=>"Transaktion bezahlt", :paragraph1=>"Nach der Bezahlung beim stationären Einzelhandelspartner erfolgt eine Benachrichtigung an den Online-Shop. Neben den oben angegebenen Parametern ist state auf \"paid\" gesetzt.", :paragraph2=>"Die erfolgreiche Bezahlung kann damit automatisiert im System des Online-Shops verarbeitet werden."}, :expired=>{:heading=>"Transaktion abgelaufen", :paragraph1=>"Nach einer bestimmten Zeit läuft die Transaktion ab und eine Bezahlung der Transaktion ist nicht mehr möglich. Neben den oben angegebenen Parametern ist state auf \"expired\" gesetzt."}, :verification=>{:heading=>"Verifizierung der Benachrichtigung", :paragraph1=>"Benachrichtigungen liefern ebenfalls einen Hashwert mit. So kann die Integrität vom Online-Shop überprüft werden.", :parameter_order=>"Die Reihenfolge der Parameter für Benachrichtigungen von Zahlungs-Transaktionen lautet:", :paragraph2=>"Wichtig ist auch hier, dass nicht übergebene Parameter beachtet werden müssen. Diese Parameter werden dann leer gelassen. Eine mögliche Zeichenkette sieht z. B. folgendermaßen aus:"}}, :refund_transactions=>{:heading=>"Benachrichtigungen bei Rückgaben", :img_alt=>"Benachrichtigung bei Rückgabe", :paragraph1=>"Rückgaben erhalten bei Benachrichtigungen die folgenden Parameter:", :paragraph2=>"Hier ist zu beachten, dass die benutzerdefinierten Variablen der ursprünglichen Transaktion zurückgeliefert werden, sofern sie beim Zahlungsvorgang gesetzt wurden.", :unique_transaction_id=>"(ID der Transaktion, die zurückgegeben wird)", :unique_refund_transaction_id=>"(eindeutige ID der Rückgabe-Transaktion)", :if_set=>"(Order-ID der Transaktion, die zurückgegeben wird (sofern gesetzt))", :if_set_on_creation=>"(sofern beim Zahlungsvorgang der ursprünglichen Transaktion gesetzt)", :example=>{:heading=>"Beispiel einer Benachrichtigung", :paragraph1=>"Wenn im %{url1} z. B. die Benachrichtigungs-URL %{url2} hinterlegt ist, dann könnte die Benachrichtigung die folgende Form haben (Reihenfolge der Parameter kann abweichen):"}, :expired=>{:heading=>"Rückgabe abgelaufen", :paragraph1=>"Nach einer bestimmten Zeit läuft die Rückgabe ab und ist nicht mehr möglich. Der Shop erhält dazu eine Benachrichtigung. Neben den oben angegebenen Parametern ist state auf \"refund_expired\" gesetzt."}, :completed=>{:heading=>"Rückgabe abgeschlossen", :paragraph1=>"Nachdem der Kunde erfolgreich sein Geld zurückbekommen hat, erhält der Shop eine Benachrichtigung. Neben den oben angegebenen Parametern ist state auf \"refund_completed\" gesetzt."}, :verification=>{:heading=>"Verifizierung der Benachrichtigung", :paragraph1=>"Details zur Verifizerung finden Sie %{url}.", :parameter_order=>"Die Reihenfolge der Parameter für Benachrichtigungen von Rückgabe-Transaktionen lautet:"}}}$

Die Zerebro Internet GmbH wurde im Zeitraum vom 01.11.2011 bis 30.10.2012 gefördert durch:

Gefördert durch Bundesministerium für Wirtschaft und Technologie aufgrund eines Beschlusses des Deutschen Bundestages