Ü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
Beim Webservice Benachrichtigung über den Zahlungsausgang werden die UATP Informationen mitgegeben.
Die Parameter sehen in diesem Fall wie folgt aus.
| 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 |
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.
URL: https://payment.girosolution.de/girocheckout/api/v2/transaction/statusUATP
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 | GiroCheckout Transaktions-ID |
| 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) |
| 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 |
Für jede erfolgreiche giropay, iDEAL und EPS Transaktion wird eine UATP Karte ausgestellt und das Limit auf den Transaktionsbetrag gesetzt.