Maintenance Work Notice!
Due to updates, this documentation may not be available between 13:00 and 13:30 CET on 12/11/2024. Thank you for your understanding.
PostFinance hat seine Online-Zahlungsmethoden für die PostFinance Card erneuert und dabei die "PostFinance Card" und "PostFinance E-Finance" in einem System zusammengeführt. Bisher konnten Sie bei diesen Methoden Ihr bevorzugtes Zahlungsverfahren auswählen und die Online-Zahlungsbestätigung über die PostFinance App, ein Kartenlesegerät oder Mobile ID bestätigen.
Mit der Einführung von PostFinance Pay werden beide Verfahren zusammengeführt und erweitert. Das neue System macht Kartennummer und Kartenlesegerät beim Bezahlvorgang überflüssig. Mit PostFinance Pay können Sie Online-Transaktionen und Zahlungsmittelregistrierungen jetzt bequem direkt über die PostFinance-App bestätigen.
Weitere Informationen finden Sie auf der Webseite von PostFinance (https://www.postfinance.ch/de/privat/zahlen-sparen/mobiles-bezahlen/pay.html#/).
Prozessablauf Postfinance Pay
a alphabetisch as alphabetisch mit Sonderzeichen n numerisch an alphanumerisch ans alphanumerisch mit Sonderzeichen ns numerisch mit Sonderzeichen bool Bool’scher Ausdruck (true oder false) 3 feste Länge mit 3 Stellen/Zeichen ..3 variable Länge mit maximal 3 Stellen/Zeichen enum Aufzählung erlaubter Werte dttm ISODateTime (JJJJ-MM-TTThh:mm:ss) CND Bedingung (condition) M Pflicht (mandatory) O optional C bedingt (conditional) Hinweis: Bitte beachten Sie, dass die Bezeichnungen der Parameter in Groß- oder Kleinbuchstaben zurückgegeben werden können.Definitionen
Datenformate
Format Beschreibung Abkürzungen
Abkürzung Beschreibung Kommentar Wenn ein Parameter Pflicht ist, dann muss er vorhanden sein Wenn ein Parameter optional ist, dann kann er vorhanden sein, ist aber nicht erforderlich Wenn ein Parameter bedingt ist, dann gibt es eine Bedingungsregel, die angibt, ob er Pflicht oder optional ist
Um eine Autorisierung mittels PostFinance Pay anzulegen, verwenden Sie bitte folgende URL:
https://www.computop-paygate.com/PostFinPay.aspx |
Hinweis: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp. Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:
Beachten Sie bitte, dass eine begonnene Transaktion noch nicht abgeschlossen ist, wenn PostFinance einen Kunden auf die Callback-Seite weiterleitet. Informieren Sie den Kunden daher auf der Callback-Seite, dass die Zahlung noch verarbeitet wird und er die Seite nicht schließen soll.
Wenn die Transaktion später teilweise gebucht werden soll, müssen Sie dies beim Auslösen der Autorisierungsanfrage mithilfe des Parameters „captureInfo“ wie unten beschrieben definieren.
Parameter für Zahlungen mit PostFinance Pay
Die folgende Tabelle beschreibt die Ergebnis-Parameter, die das Paygate an Ihre URLSuccess, URLFailure und URLNotify übergibt. Wenn Sie den Parameter Response=encrypt angegeben haben, werden die folgenden Parameter mit Blowfish verschlüsselt an Ihr System übergeben: es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden
Ergebnis-Parameter für URLSuccess, URLFailure und URLNotify mit PostFinance Pay
Bezüglich der Fristen für Buchungen und Gutschriften beachten Sie bitte auch die Informationen auf der FAQ-Seite von PostFinance.
Buchungen sind über eine Server-zu-Server-Verbindung möglich. Um eine Buchung über eine Server-zu-Server-Verbindung durchzuführen, verwenden Sie bitte folgende URL:
https://www.computop-paygate.com/capture.aspx |
Hinweis: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp. Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:
Parameter für Buchungen mit PostFinance Pay
Die folgende Tabelle beschreibt die Parameter, die das Paygate als Antwort zurückgibt: es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden
Antwort-Parameter für Buchungen mit PostFinance Pay
Gutschriften sind über eine Server-zu-Server-Kommunikation möglich. Bei einer Gutschrift mit Bezug auf eine Buchung ist die Höhe der Gutschrift auf die Höhe der vorangegangen Buchung beschränkt. Um eine Gutschrift (Credit) mit Referenztransaktion auszuführen, verwenden Sie bitte folgende URL:
https://www.computop-paygate.com/credit.aspx |
Hinweis: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp. Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:
Parameter für Gutschrift von Zahlungen mit PostFinance Pay
Die folgende Tabelle beschreibt die Parameter, die das Paygate als Antwort zurückgibt: es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden
Antwort-Parameter für Gutschrift von Zahlungen mit PostFinance Pay
Autorisierungsstornierungen können ausgelöst werden, wenn der Händler während der Autorisierung eine Fehlermeldung erhält oder nach einer bestimmten Zeit keine Antwort erhalten hat, so dass unklar ist, ob die Autorisierung erfolgreich war. Autorisierungsstornierungen können nur gesendet werden, wenn die betroffene Transaktion noch nicht zur Verbuchung übermittelt wurde. Bitte beachten Sie, dass Teilstornierungen nicht zulässig sind. Es kann nur der volle Betrag der Transaktion storniert werden.
Stornierungen sind über eine Server-zu-Server-Verbindung möglich. Um eine Zahlung über eine Server-zu-Server-Verbindung zu stornieren, verwenden Sie bitte folgende URL:
https://www.computop-paygate.com/reverse.aspx |
Hinweis: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp. Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:
Parameter für Stornierungen mit PostFinance Pay
Die folgende Tabelle beschreibt die Parameter, die das Paygate als Antwort zurückgibt: es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden
Antwort-Parameter für Stornierungen mit PostFinance Pay