Inhaltsverzeichnis

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.

Zur Dokumentation der giropay Integration
Zur Dokumentation der eps Integration
Zur Dokumentation der iDEAL Integration

Erweiterungen

Benachrichtigung über den Ausgang der Zahlung

Beim Webservice 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 Ergebniscodes der giropay Zahlung
gcResultAVS Optional Integer 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 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)
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.