Benachrichtigungen für Zahlungen

Laufende Transaktionen erhalten bei Benachrichtigungen die folgenden Parameter:

  • state (siehe unten)
  • transaction_id (eindeutige Transaktions-ID)
  • shop_id
  • customer_email
  • amount
  • currency
  • order_id (sofern gesetzt)
  • custom_var_0 (sofern beim Zahlungsvorgang gesetzt)
  • custom_var_1 (sofern beim Zahlungsvorgang gesetzt)
  • custom_var_2 (sofern beim Zahlungsvorgang gesetzt)
  • hash

Beispiel einer Benachrichtigung

Wenn im Händlerbereich z. B. die Benachrichtigungs-URL http://www.example.com/callback/barzahlen/callback.php hinterlegt ist, dann könnte die Benachrichtigung die folgende Form haben (Reihenfolge der Parameter kann abweichen):

http://www.example.com/callback/barzahlen/callback.php?state=paid&transaction_id=123&shop_id=456&customer_email=mustermann%40barzahlen.de&amount=29.9&currency=EUR&order_id=789&custom_var_0=shoes

Transaktion bezahlt

Nach der Bezahlung beim stationären Einzelhandelspartner erfolgt eine Benachrichtigung an den Online-Shop. Neben den oben angegebenen Parametern ist state auf "paid" gesetzt.

  
    state = "paid"
  

Die erfolgreiche Bezahlung kann damit automatisiert im System des Online-Shops verarbeitet werden.

Transaktion abgelaufen

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.

  
    state = "expired"
  

Verifizierung der Benachrichtigung

Benachrichtigungen liefern ebenfalls einen Hashwert mit. So kann die Integrität vom Online-Shop überprüft werden.

Die Reihenfolge der Parameter für Benachrichtigungen von Zahlungs-Transaktionen lautet:

  
    state;transaction_id;shop_id;customer_email;amount;currency;order_id;
    custom_var_0;custom_var_1;custom_var_2;notification_key
  

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:

  
    paid;94274;123;mail@domain.tld;21.99;EUR;52847194;
    23;;;3a25aea969b8768b034e81a64c4812136deab059