Transaktionsinformationen abrufen

Mit dieser API wird das automatisierte Abrufen von Informationen zu einer Transaktion bereitgestellt. Solle z.B. wegen technischer Probleme, keine Meldung zu einer Transaktion im Händlersystem eingegangen sein, kann somit aktiv nach dem aktuellen Stand bei GiroCheckout gefragt werden.

Anfrage

URL: https://payment.girosolution.de/girocheckout/api/v2/transaction/status
Bereitzustellen von: GiroCheckout
Aufzurufen von: Händler

Parameter
Name Pflicht Type Beschreibung
merchantId Ja Integer Händler-ID
projectId Ja Integer Projekt-ID
reference Ja String Eindeutige GiroCheckout Transaktions-ID. Bei Transaktionen, die über die Payment Page durchgeführt wurden, hier bitte die Reference angeben, die bei der Payment Page Initialisierung zurückgeliefert wurde.
txreference Optional String Eindeutige GiroCheckout Transaktions-ID. falls es sich um eine Payment-Page-Transaktion handelt und über diese Payment Page mehrere Transaktionen durchgeführt wurden. In diesem Fall präzisiert dieser Parameter, um welche Transaktion es sich genau handelt. In allen anderen Fällen, diesen Parameter nicht verwenden.
hash Ja String(32)HMAC MD5 hash über alle Werte des Aufrufs. Siehe hash generieren

Antwort

Die Antwort enthält einen JSON encodeten String. Wenn rc = 0 zurückgeliefert wird, wurde die Transaktion gefunden und die Informationen sind in den entsprechenden Feldern gesetzt.

Parameter
Name Pflicht Type Beschreibung
rc Ja Integer Fehlernummer
msg Ja String Zusätzliche Informationen im Fehlerfall
reference Optional Integer Eindeutige GiroCheckout Transaktions-ID
merchantTxId Optional String Transaktions-ID des Händlers
backendTxId Optional String Transaktions-ID des Zahlungsabwicklers (z.B. giropay)
amount Optional Integer Betrag in Cent
currency Optional Integer Währung der Transaktion als Währungscode gemäß ISO 4217
resultPayment Optional Integer Ergebnis der Bezahltransaktion
resultAVS Optional Integer Ergebnis der giropay Altersverifikation
obvName Optional String Optional zuschaltbares Feld, welches den Namen der zu verifizierenden Person beinhaltet (giropay-ID)