Integration
Grundlagen
FAQ
eps
giropay
iDEAL
Kreditkarte
Lastschrift
Bluecode
Maestro
Payment Page
PayPal
Tools
Fehlernummern
Ergebniscode
Testdaten
Seitenleiste
de
enuatp:start
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.
uatp/start.txt · Zuletzt geändert: 2021/04/12 14:29