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.
URL: https://payment.girosolution.de/girocheckout/api/v2/transaction/status
Bereitzustellen von: GiroCheckout
Aufzurufen von: Händler
| 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 |
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.
| 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) |