Ziel des Szenarios
Dieses Szenario beschreibt, wie eine Karte für spätere Merchant-Initiated Transactions (MIT) vorbereitet wird, ohne dass initial ein echter Kauf stattfindet.
Die Karte wird dabei über eine Initial-CIT (card holder initiated) mit Autorisierung und 3D Secure registriert. Anschließend können wiederkehrende MITs ohne Cardholder-Präsenz durchgeführt werden.
Eine reine 3DS-Authentifizierung ohne Autorisierung ist hierfür nicht ausreichend.
1. Standalone-Registrierung (Initial UNSCHEDULED CIT mit 0-EUR-PA)
Zweck
Karte hinterlegen
Starke Kundenauthentifizierung durchführen
Technische Basis für spätere MIT schaffen
Endpoint
POST /v1/checkouts
Erforderliche Parameter
amount=0.00
currency=EUR
paymentType=PA
standingInstruction.type=UNSCHEDULED
standingInstruction.mode=INITIAL
standingInstruction.source=CIT
createRegistration=true //siehe BesonderheitenBesonderheiten
Für die Speicherung der Kreditkartendaten muss die Bestätigung des Karteninhabers eingeholt werden. Sofern dies noch nicht erfolgt ist, sollte die Bestätigung im Checkout über das Widget eingeholt werden. Hierbei wird der Parameter createRegistration durch das Widget gesetzt und entfällt bei den erforderlichen Parametern.
Ergebnis
{
"id": "8acda4a39c03fcxxx19c1exxxcc57xxx",
"registrationId": "8acda4a79c03fcxxxxxc1e6bxxxe6cfx",
"paymentType": "PA",
"paymentBrand": "MASTER",
"amount": "0.00",
"currency": "EUR",
"descriptor": "3583.4267.0000",
"recurringType": "INITIAL",
"result": {
"code": "000.000.000",
"description": "Transaction succeeded"
},
...In der Rückmeldung findet sich die Registrierungs-Id ("Token", registrationId) für wiederkehrende Zahlungen.
2. Wiederkehrende Merchant-Initiated Transaction (MIT)
Zweck
Belastung der gespeicherten Karte ohne Cardholder-Präsenz
Nutzung der zuvor registrierten Karte
Endpoint
POST /v1/registrations/{registrationId}/payments
Erforderliche Parameter
amount=XX.XX
currency=EUR
paymentType=DB //(DB = buchend, möglich wäre auch der PA > CP Workflow)
standingInstruction.type=UNSCHEDULED
standingInstruction.mode=REPEATED
standingInstruction.source=MITBesonderheiten
Keine Cardholder-Interaktion
Keine CVV-Angabe
Keine 3DS-Daten
Die Transaktion referenziert die initiale CIT technisch über das Gateway
Wichtige Hinweise
Eine reine Standalone-Authentifizierung (3DS NPA) ohne Autorisierung ist für dieses Szenario nicht geeignet
Jede MIT muss eindeutig auf eine vorherige autorisierte CIT referenzieren
3. Wiederkehrende Customer-Initiated Transaction (CIT) durch One-Click Zahlung
Zweck
Belastung der gespeicherten Karte über One-Click mit Cardholder-Präsenz
Nutzung der zuvor registrierten Karte
Anzeige der registrieren Karten im Widget
Endpoint
POST /v1/checkouts
Erforderliche Parameter
amount=XX.XX
currency=EUR
paymentType=DB //(DB = buchend, möglich wäre auch der PA > CP Workflow)
registrations[0].id={registrationId}
standingInstruction.type=UNSCHEDULED
standingInstruction.mode=REPEATED
standingInstruction.source=CITBesonderheiten
Cardholder-Interaktion nur Auswahl einer hinterlegten Karte