~~NOCACHE~~
====== UATP Integration ======

Über die GiroCheckout API kann giropay, iDEAL und EPS mit UATP Unterstützung integriert werden. Die Integration unterscheidet sich nur geringfügig von einer //Standard// Integration.

**[[girocheckout:giropay:start|Zur Dokumentation der giropay Integration]]**\\
**[[girocheckout:eps:start|Zur Dokumentation der eps Integration]]**\\
**[[girocheckout:ideal:start|Zur Dokumentation der iDEAL Integration]]**

===== Erweiterungen =====

==== Benachrichtigung über den Ausgang der Zahlung ====
Beim Webservice [[girocheckout:giropay:start#benachrichtigung_ueber_den_zahlungsausgang|Benachrichtigung über den Zahlungsausgang]] werden die UATP Informationen mitgegeben. \\
Die Parameter sehen in diesem Fall wie folgt aus.

== GET Parameter ==
^Name           ^Pflicht  ^Type        ^Beschreibung   ^
|gcReference      |Ja       |String      |GiroCheckout Transaktions-ID |
|gcMerchantTxId   |Ja       |String      |Händler Transaktions-ID |
|gcBackendTxId    |Ja       |String      |Zahlungsabwickler Transaktions-ID |
|gcAmount         |Ja       |Integer     |bei Dezimalwährungen den Betrag in der kleinsten Währungseinheit angeben, z.B. Cent |
|gcCurrency       |Ja       |String      |Währung |
|gcResultPayment  |Optional |Integer     |[[girocheckout:resultcodes#zahlungsausgang|Ergebniscodes der giropay Zahlung]] |
|gcResultAVS      |Optional |Integer     |[[girocheckout:resultcodes#altersverifikation|Ergebniscodes der giropay Altersverifikation]] |
|gcUatpcard       |Optional |String      |UATP Kartennummer |
|gcUatpexpdate    |Optional |String      |Ablaufdatum der UATP Karte (Format: MMYY) |
|gcUatpstatus     |Optional |Integer     |1 = Karte angelegt, 0 = Fehler beim Anlegen der Karte  |

==== Transaktionsinformationen abrufen ====
Mit dieser Schnittstelle können Informationen zu einer Transaktion mit UATP Daten abgefragt werden. 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/statusUATP \\
**Bereitzustellen von:** GiroCheckout \\
**Aufzurufen von:** Händler

== POST Parameter ==
^Name           ^Pflicht  ^Type      ^Beschreibung   ^
|merchantId     |Ja       |Integer   |Händler-ID |
|projectId      |Ja       |Integer   |Projekt-ID |
|reference      |Ja       |String    |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 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   |[[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 Zahlungsabwicklers (z.B. giropay) |
|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]]  |
|obvName        |Optional |String    |Optional zuschaltbares Feld, welches den Namen der zu verifizierenden Person beinhaltet (giropay-ID) |
|uatpCard       |Optional |String    |UATP Kartennummer |
|uatpExpdate    |Optional |String    |Ablaufdatum der UATP Karte (Format: MMYY) |
|uatpStatus     |Optional |Integer   |1 = Karte angelegt, 0 = Fehler beim Anlegen der Karte |

===== UATP Autorisierungs System =====
Für jede **erfolgreiche** giropay, iDEAL und EPS Transaktion wird eine UATP Karte ausgestellt und das Limit auf den Transaktionsbetrag gesetzt.