In diesem Abschnitt wird davon ausgegangen, dass Sie die Dokumentation "Erste Schritte" für die von Ihnen gewählte Integrationsmethode bereits gelesen haben und wissen, wie Sie eine einfache Anfrage an uns stellen.
Wenn Sie unsere Antwort erhalten, muss Ihr System die folgenden Überprüfungen der zurückgegebenen Werte (sofern zutreffend) durchführen, um sicherzustellen, dass die Anfrage erfolgreich bearbeitet wurde.
Fehlercode
Die Seite Fehlercode (errorcode) ist ein grundlegend wichtiges Feld, da es das Ergebnis der übermittelten Anfrage anzeigt. Es wird in jeder Antwort von Trust Payments zurückgegeben.
Wenn die errorcode "0" ist, bedeutet dies, dass die Anfrage erfolgreich bearbeitet wurde.
Es ist unbedingt erforderlich, dass Sie über ein Verfahren verfügen, um den endgültigen Status der bearbeiteten Anfrage anhand der Werte der anderen zurückgegebenen Felder zu überprüfen.
Wenn die errorcode "30000" lautet, deutet dies auf einen Feldfehler hin.
Wenn Sie sich das errordata zurückgegebenen Feldes sehen, enthält dieses in der Regel den Namen des Feldes, das als ungültig erachtet wurde. Sie müssen die Anfrage wiederholen und sicherstellen, dass alle erforderlichen Felder übermittelt wurden und dass alle übermittelten Feldwerte unserer Spezifikation entsprechen.
Wenn die errorcode "70000" lautet, bedeutet dies, dass eine Zahlung von Ihrer Bank abgelehnt wurde.
Wir empfehlen, dass Sie dem Kunden eine Fehlermeldung anzeigen und ihm die Möglichkeit geben, eine andere Zahlungsmethode zu wählen.
Wenn errorcode "71000" lautet, bedeutet dies, dass weiche Ablehnung vom Kartenaussteller zurückgegeben wurde.
Dies ist aufgetreten, weil der Kartenaussteller die Anfrage wegen des Fehlens von Starke Kundenauthentifizierung (SCA) abgelehnt hat. Sie müssen die Transaktion mit der erforderlichen EMV 3DS-Authentifizierung erneut einreichen. Klicken Sie hier für eine vollständige Anleitung.
Wenn die errorcode "60010", "60034" oder "99999" lautet, gab es ein Problem bei der Bearbeitung des Antrags und der endgültige Status ist nicht bekannt.
Dies kann auf ein Kommunikationsproblem mit einer Bank oder einer dritten Partei zurückzuführen sein. In solchen Fällen empfehlen wir, den Kunden über das Problem zu informieren und ihn zu bitten, sich mit Ihnen in Verbindung zu setzen, um die Angelegenheit zu klären. Sie müssen sich mit unserem Support-Team in Verbindung setzen und eine Kopie der gesamten Anfrage und der zurückgesandten Antwort vorlegen. Wir werden uns dann mit den betreffenden Parteien in Verbindung setzen, um den Status der Anfrage zu ermitteln. Stellen Sie im Interesse der Sicherheit sicher, dass Sie sensible Feldwerte, wie z. B. Kartendaten, auslassen oder maskieren.
Wenn der Fehlercode (errorcode) nicht oben aufgeführt ist, finden Sie Hilfe in unserer vollständigen Liste der Fehlercodes. Wenn Sie weitere Hilfe benötigen, wenden Sie sich bitte an unser Support-Team.
Abrechnungsstatus (settlestatus)
Es ist wichtig, den Wert des Parameters Abrechnungsstatus (settlestatus) zu überprüfen, wenn eine AUTH oder REFUND Anfrage bearbeitet wird, da dies anzeigt, ob eine Abrechnung durchgeführt wird. Hier sind die Grundlagen:
Wenn settlestatus auf "0", "1" oder "10" steht, müssen Sie keine weiteren Schritte unternehmen.
Die Abwicklung der Transaktion ist derzeit geplant.
Steht auf settlestatus "100", ist die Transaktion abgewickelt.
Sie können keine weiteren Aktualisierungen an der Transaktion vornehmen.
Steht auf settlestatus eine "2", wurde die Transaktion ausgesetzt.
Die Gelder werden nicht ohne Ihr Zutun abgewickelt. Weitere Informationen finden Sie in unserer DokumentationAbrechnung .
Steht auf settlestatus die Zahl "3", wurde der Vorgang abgebrochen.
Die Mittel werden nicht abgerechnet und Sie müssen das Problem untersuchen und es erneut versuchen. In diesem Fall ist es sinnvoll, sich die Begleitdokumente anzusehen. Fehlercode (errorcode) zu sehen, da diese oft Aufschluss über den Grund für das Scheitern der Transaktion gibt.
Falls Sie es noch nicht getan haben, empfehlen wir Ihnen, unsere DokumentationAbrechnung zu lesen, um weitere Einzelheiten über die Durchführung von Abrechnung zu erfahren.
Sicherheitsantwort
Wenn die AVS und Security Code Checks als Teil der Anfrage durchgeführt werden (wie es bei den meisten AUTH und ACCOUNTCHECKs der Fall ist), müssen Sie die drei zurückgegebenen Sicherheitsantwortfelder überprüfen, die wie folgt definiert sind:
- securityresponseaddress - Stimmt die erste Zeile der vom Kunden eingegebenen Rechnungsadresse mit der in seinem Bankkonto angegebenen überein?
- securityresponsepostcode - Stimmt die vom Kunden eingegebene Rechnungspostleitzahl mit der auf seinem Bankkonto gefundenen überein?
- securityresponsesecuritycode - Stimmt der vom Kunden eingegebene Sicherheitscode mit dem auf der Rückseite der Karte angegebenen Wert überein?
Wenn der Wert "2" ist, hat der Kunde die richtigen Daten eingegeben.
Wenn alle Werte "2" sind, gibt es hier keinen Grund, die Abwicklung der Transaktion zu verhindern.
Ist der Wert "1", konnte die Bank die Angaben des Kunden nicht überprüfen.
Dies kann daran liegen, dass der Kunde eine Karte besitzt, die von einem anderen Land ausgestellt wurde, und Ihre Bank daher nicht in der Lage war, die Adresse des Kunden zu überprüfen. In diesem Fall sollten Sie in Erwägung ziehen, Transaktionen, die in diese Kategorie fallen, auszusetzen, damit Sie Nachforschungen anstellen können, bevor Sie mit der Zahlung fortfahren.
Wenn der Wert "0" ist, wurden die Daten des Kunden nicht an die Bank übermittelt.
Dies liegt daran, dass der Kunde überhaupt keine Angaben gemacht hat oder dass diese Angaben in Ihrer Anfrage nicht übermittelt wurden. Möglicherweise sollten Sie Transaktionen, die in diese Kategorie fallen, aussetzen, damit Sie Nachforschungen anstellen können, bevor Sie mit der Zahlung fortfahren.
Wenn der Wert "4" ist, hat der Kunde falsche Angaben gemacht.
Standardmäßig werden Transaktionen ausgesetzt, wenn der vom Kunden eingegebene Sicherheitscode nicht mit dem Wert auf der Karte übereinstimmt. Je nach Ihren Präferenzen können Sie es auch vorziehen, Transaktionen auszusetzen, bei denen die Adressdaten nicht übereinstimmen (standardmäßig deaktiviert).
Sie können beantragen, dass Trust Payments Transaktionen automatisch storniert, wenn die Sicherheitsantwortfelder einen bestimmten Wert aufweisen. Wie bereits erwähnt, unterbrechen wir alle Transaktionen, bei denen der vom Kunden eingegebene Sicherheitscode nicht mit dem Wert auf seiner Karte übereinstimmt. Sie können die Umstände, unter denen Transaktionen ausgesetzt werden, nach Ihren eigenen Vorstellungen festlegen (Sie können solche Überprüfungen sogar ganz deaktivieren). Dazu müssen Sie Ihre Sicherheitsrichtlinien ändern. Wenn Sie Änderungen an den Sicherheitsrichtlinien Ihres Kontos besprechen möchten, wenden Sie sich bitte an unser Support-Team.
Anforderungstyp
Jede Antwort enthält eine requesttypedescription. Der Wert dieses Feldes, der in der Antwort zurückgegeben wird, sollte immer mit dem in der Anfrage angegebenen Wert übereinstimmen.
Wenn Sie z. B. eine "AUTH" Anfrage senden, stellen Sie sicher, dass die requesttypedescription zurückgegeben wird: "AUTH".
Wenn Sie requesttypedescription mit dem Wert "ERROR" erhalten, wurde die Anfrage möglicherweise nicht erfolgreich bearbeitet und Sie müssen der Sache nachgehen.
Live-Status
Prüfen Sie, ob der zurückgegebene Wert Live-Status beim Testen "0" und bei der Verarbeitung von Live-Zahlungen "1" ist.
Betrag & Währung
Überprüfen Sie bei der Übermittlung eines Betrags und von Währung, ob in der Antwort die gleichen Werte zurückgegeben werden.
Sicherheit der Antwortseite
Wenn Sie Transaktionen über unsere Payment Pages Schnittstelle verarbeiten und konfiguriert haben URL-Benachrichtigungen oder Weiterleitungen für den Abschluss von Transaktionen konfiguriert haben, müssen Sie den Sicherheits-Hash für die Website anhand der zurückgegebenen Felder neu berechnen und prüfen, ob er mit dem entsprechenden Hash von Trust Payments übereinstimmt. So stellen Sie sicher, dass der zurückgegebene Inhalt nicht von Unbefugten geändert wurde. Klicken Sie hier, um mehr zu erfahren.
