====== Hilfsfunktionen ======

Mit den Hilfsfunktion können unter anderem Informationen zu einer Transaktion abgerufen werden. Solle z.B. wegen technischer Problemen keine Meldung (Redirect / Notification) zu einer Transaktion übermittelt worden sein, besteht die Möglichkeit aktiv nach einer Transaktion zu fragen.

===== Transaktionsinformationen abrufen =====
Mit dieser Funktion können Informationen zu einer Transaktion abgefragt werden.

=== Anfrage ===
**URL:** https://payment.girosolution.de/girocheckout/api/v2/transaction/status \\
**Bereitzustellen von:** GiroSolution AG \\
**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 |
|hash           |Ja       |String(32)|HMAC MD5 hash über alle Werte des Aufrufs. Siehe  [[girocheckout:general:start#hash_generieren|hash generieren]]|

=== Antwort ===
Die Antwort ist ein JSON Objekt. 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   |[[girocheckout:errorcodes|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 Backend Systems (z.B. giropay Transaktions-ID) |
|Amount         |Optional |Integer   |Betrag in Cent |
|Currency       |Optional |Integer   |Währung der Transaktion als Währungscode gemäß [[http://de.wikipedia.org/wiki/ISO_4217#Aktuell_g.C3.BCltige_W.C3.A4hrungen|ISO 4217]] |
|ResultPayment  |Optional |Integer   |[[girocheckout:resultcodes#zahlungsausgang|Ergebnis der Bezahltransaktion]]  |
|ResultAVS      |Optional |Integer   |[[girocheckout:resultcodes#altersverifikation|Ergebnis der giropay Altersverifikation]]  |
|hash           |Ja       |String(32)|HMAC MD5 hash über alle Werte des Aufrufs. Siehe  [[girocheckout:general:start#hash_generieren|hash generieren]]|