Maintenance Work Notice!
Due to updates, this documentation may not be available between 13:00 and 13:30 CET on 12/11/2024. Thank you for your understanding.
Analog zu giropay in Deutschland haben die niederländischen Banken dort den iDEAL-Standard etabliert. Circa 50% aller E-Commerce-Zahlungen werden in den Niederlanden mit iDEAL ausgeführt. Deshalb ist iDEAL ein Erfolgsfaktor für den E-Commerce in Holland. Dafür nutzt der Kunde das ihm bekannte und vertrauenswürdige Online-Banking seines eigenen Kreditinstitutes – genau wie beim Online-Banking.
Wie beim Online-Banking üblich, sind auch bei der Online-Überweisung die übermittelten Daten mit SSL (Secure Sockets Layer) verschlüsselt und so gegen Manipulation gesichert.
Weitere Informationen finden Sie auch auf dem iDEAL-Portal auf Holländisch und Englisch (www.ideal.nl).
Der Händler muss den Redirect zum Issuer vom Browserfenster oder der Händler-App bereitstellen, wo der Kunde die ausstellende Bank wählt. Wenn es nicht möglich ist, den Kunden im gleichen Browserfenster zu halten, dann sollte das dem Kunden mitgeteilt werden (z.B. ‘Sie werden jetzt zur App oder mobilen Webseite Ihrer Bank weitergeleitet).
Falls eine Zahlung in der Händler-App ausgelöst wird, ist es nicht erlaubt, die Bestätigungsdialoge des Issuers in einer Webansichtskomponente innerhalb der Händler-App (In-App-Browser) darzustellen. Der vollständige Zahlungsablauf bis bis zur Rückleitung zur Händler-App muss in einer App erfolgen, der der Kunde vertraut, entweder im gewählten Browser des Kunden oder in der mobilen App des Issuers. Daher muss die issuerAuthentionURL zur Ausführung jederzeit dem Betriebssystem bereitgestellt werden. Während des Zahlungsablaufes darf es dem Kunden nicht möglich sein, eine andere Zahlung durch die ursprüngliche App des Händlers auszulösen.
Relevante Details über den Redirect vom Händler zum Mobilkanal des Issuers:
iDEAL Prozessablauf
a alphabetisch as alphabetisch mit Sonderzeichen n numerisch an alphanumerisch ans alphanumerisch mit Sonderzeichen ns numerisch mit Sonderzeichen bool Bool’scher Ausdruck (true oder false) 3 feste Länge mit 3 Stellen/Zeichen ..3 variable Länge mit maximal 3 Stellen/Zeichen enum Aufzählung erlaubter Werte dttm ISODateTime (JJJJ-MM-TTThh:mm:ss) CND Bedingung (condition) M Pflicht (mandatory) O optional C bedingt (conditional) Hinweis: Bitte beachten Sie, dass die Bezeichnungen der Parameter in Groß- oder Kleinbuchstaben zurückgegeben werden können.Definitionen
Datenformate
Format Beschreibung Abkürzungen
Abkürzung Beschreibung Kommentar Wenn ein Parameter Pflicht ist, dann muss er vorhanden sein Wenn ein Parameter optional ist, dann kann er vorhanden sein, ist aber nicht erforderlich Wenn ein Parameter bedingt ist, dann gibt es eine Bedingungsregel, die angibt, ob er Pflicht oder optional ist
Um eine Zahlung per Online-Überweisung mit iDEAL abzuwickeln, verwenden Sie bitte folgende URL:
https://www.computop-paygate.com/ideal.aspx |
Hinweis: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp. Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:
Parameter für Online-Überweisungen mit iDEAL
Bei Verwendung der REST-API Bei Verwendung der REST-API erhalten Sie immer einen Link, über den der Händler den Verbraucher umleiten muss, um die Zahlung abzuschließen. "paymentId": "..." Kann "00000000000000000000000000000000" lauten, wenn dies noch nicht vom Paygate festgelegt wurde "application/json" Der Händler kann inquire.aspx verwendenREST Format CND Beschreibung an32 M "_Links.self.type": "..." an..20 M "_Links.redirect.href": "..." an..1024 M Der Händler muss den Kunden zu dieser URL weiterleiten, um die Zahlung abzuschließen "_Links.redirect.type": "..." an..20 M "text/html"
Bei Verwendung der Key-Value-Pair-API Die folgende Tabelle beschreibt die Ergebnis-Parameter, die das Paygate an Ihre URLSuccess, URLFailure und URLNotify übergibt. Wenn Sie den Parameter Response=encrypt angegeben haben, werden die folgenden Parameter mit Blowfish verschlüsselt an Ihr System übergeben: es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden
Ergebnis-Parameter für URLSuccess, URLFailure und URLNotify bei iDEAL
Hinweis: Bitte beachten Sie, dass es bei IDEAL-Transaktionen, welche über PPRO abgewickelt werden, in seltenen Fällen noch bis zu 5 Tage nach abgeschlossener Zahlung zu zeitverzögerten Notifys kommen kann. Dadurch ändert sich der Zahlungsstatus. Beachten Sie dies bitte, damit Ihr Shop solche Notifys verarbeiten kann.
Außerbetriebnahme der Abfrage hinterlegter iDEAL-Banken
Im Rahmen der Migration zu iDEAL 2.0 hat Currence die Auswahl der iDeal-Banken von der Händlerseite auf die iDeal-Zahlungsseite verschoben. Ab Januar 2025 ist die Abfrage der hinterlegten iDeal-Banken nicht mehr möglich. Wenn Sie an Ihrer Kasse die Auswahl des iDeal-Emittenten anzeigen, muss diese entfernt werden und iDeal sollte als normale Zahlungsmethode angezeigt werden. Der Benutzer kann die entsprechenden Banken nach der Weiterleitung zu Computop auf der neuen iDeal-Zahlungsseite auswählen.
Das Paygate bietet Händlern die Möglichkeit, vor dem eigentlichen Zahlungsablauf abzufragen, welche Banken für den Händler hinterlegt sind. Da sich die konfigurierte Bankenliste selten ändert, muss diese nicht bei jeder Überweisung abgefragt werden. Für diese Prüfung verwenden Sie bitte folgende URL:
https://www.computop-paygate.com/idealIssuerList.aspx |
Folgende Tabelle beschreibt die verschlüsselten Übergabeparameter. Bitte beachten Sie, dass wie bei allen Paygate-Aufrufen immer die Merchant-ID sowie Len und Data übergeben werden müssen:
Parameter zur Prüfung der hinterlegten iDEAL-Banken
Bitte übergeben Sie die Merchant-ID sowohl im unverschlüsselten als auch im verschlüsselten String.
Die folgende Tabelle beschreibt die Ergebnis-Parameter, die das Paygate als Antwort sendet:
Ergebnis-Parameter zur Abfrage der hinterlegten iDEAL-Banken
Gutschriften sind über eine Server-zu-Server-Kommunikation möglich. Das Paygate erlaubt für iDEAL nur Gutschriften, die sich auf eine vorher über das Paygate getätigte Buchung beziehen. Die Höhe der Gutschrift ist auf die Höhe der vorangegangen Buchung beschränkt.
Bitte beachten Sie, dass im Fall von EMS nur eine Gutschrift-Anfrage verarbeitet werden kann. Dass Einreichen von mehreren Gutschriften ist nicht zulässig.
Um eine Gutschrift (Credit) für iDEAL auszuführen, verwenden Sie bitte folgende URL:
https://www.computop-paygate.com/credit.aspx |
Hinweis: Bitte beachten Sie, dass iDEAL-Gutschriften nur dann ausgeführt werden können, wenn Sie als Processing Partner EMS, PPRO, Rabobank Ominkassa bzw. das EVO Payments Debitorenmanagement nutzen. Über eine Direktanbindung der jeweiligen Niederländischen Hausbank sind keine Gutschriften via Paygate möglich.
Hinweis: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp. Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:
Parameter für Gutschrift von iDEAL-Zahlungen
Die folgende Tabelle beschreibt die Parameter, die das Paygate als Antwort zurückgibt: es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden
Ergebnis-Parameter für Gutschrift von iDEAL-Zahlungen
Grundsätzliche Informationen zur Arbeit mit Batch-Dateien sowie zu deren Aufbau erfahren Sie im separaten Handbuch zum Batchmanager. Im Batch-Verfahren sind nicht alle Funktionen verfügbar, die für die Online-Schnittstelle verfügbar sind.
Dieses Kapitel beschreibt die Parameter, die Sie im Datensatz (Record) für die Ausführung einer iDEAL-Gutschrift übergeben müssen und welche Informationen Sie der Antwort-Datei über den Status des Zahlungsvorgangs entnehmen können.
Hinweis: Beachten Sie bitte, dass eine Batch-Nutzung für iDEAL nur über die Anbindungen EMS, EVO und PPRO möglich ist.
Folgende Tabelle gibt eine Übersicht der pro Aktion jeweils möglichen Batch-Versionen und ihrer Besonderheiten:
Beschreibung der möglichen Batch-Versionen
Der Aufbau für eine iDEAL-Zahlung in einer einzureichenden Batch-Datei sieht folgendermaßen aus:
HEAD,<MerchantID>,<Date>,<Version> IDEAL,Credit,<Amount>,<Currency>,<TransID>(<RefNr>),<PayID> FOOT,<CountRecords>,<SumAmount>
Beispiel für Master-MID-Funktion:
HEAD,[Master]MerchantID,Date,2.x Type,Action,[Slave]MID,Amount,Currency,TransID,Data (depends on Action) FOOT,CountRecords,SumAmount
Die folgende Tabelle beschreibt die einzelnen Felder und Werte, die im Datensatz (Record) innerhalb der Batch-Datei verwendet werden:
Beschreibung der Felder im Datensatz von Batch-Dateien
Der Record-Bereich in der Antwort-Datei zu Batch-Transaktionen sieht folgendermaßen aus:
HEAD,<MerchantID>,<Date>,<Version> IDEAL,Credit,<Amount>,<Currency>,<TransID>(<RefNr>),<PayID>,<Status>,<Code> FOOT,<CountRecords>,<SumAmount>
Die folgende Tabelle beschreibt die Antwort-Parameter, die der Batch-Manager im Record-Bereich zu jeder Transaktion speichert (hier nicht erklärte Standardparameter wie etwa <TransID> oder <RefNR> und Aufrufparameter werden unverändert zum Aufruf wieder zurückgegeben und sind vorstehend beschrieben):
Beschreibung der Ergebnis-Parameter im Datensatz von Batch-Dateien