iDEAL Wero für Webservices

  Zuletzt aktualisiert: 

iDEAL

iDEAL zu Wero

Ab dem ersten Quartal 2026 iDEAL auf Wero, das neue europäische Zahlungssystem, umgestellt.

  Mehr erfahren

iDEAL Wero ist eine niederländische Echtzeit-Überweisungsmethode. Bei Auswahl iDEAL Wero werden Kunden aufgefordert, ihre Bank auszuwählen und sich dann bei ihrem Online-Banking-Konto anzumelden. Nach Überprüfung der vorausgefüllten Zahlungsdetails können sie der Zahlung zustimmen, bevor sie zurück zu Ihrer Website weitergeleitet werden. Nach Abschluss des Vorgangs erhalten Sie eine Bestätigung über eine URL-Benachrichtigung.

Unterstützte Kundenländer NL
Unterstützte Währungen EUR
Rückerstattungen Vollständige und teilweise Rückerstattung bis zu 365 Tagen.
Rückbuchungen Zahlungen sind von Rückbuchungen ausgeschlossen.
Zero-authorisation Nicht unterstützt.
Wiederkehrende Zahlungen Nicht unterstützt.

 

Konfiguration

Um iDEAL Wero für Ihr Konto zu aktivieren, wenden Sie sich bitte an Ihren Kundenbetreuer.
Sie erhalten ein Test-Sandbox-Konto, das Sie zum Testen Ihrer Implementierung benötigen.

 

Überblick über den Prozess

  1. Initiieren Sie den Kunden

    • Der Kunde stimmt einer Zahlung über iDEAL Wero auf der Website des Händlers zu.
    • Der Händler sendet eine AUTH Anfrage, um die Sitzung zu initiieren, einschließlich der successfulurlredirect und errorurlredirect.
    • Der Händler erhält die Antwort AUTH, einschließlich redirecturl.

  2. Weiterleitung zu iDEAL Wero 

    • Der Händler leitet den Browser des Kunden auf die redirecturl.
    • Der Kunde folgt den Anweisungen auf den von iDEAL Wero gehosteten Seiten, um die Zahlung zu autorisieren.
    • Bei Erfolg wird der Browser auf die Seite successfulurlredirect, eine vom Händler bereitgestellte Seite, die die Zahlungsbestätigung anzeigt.
    • Wenn ein Problem mit der Zahlung aufgetreten ist, wird der Browser auf die Seite errorurlredirect, eine vom Händler gehostete Seite, die dem Kunden einen Fehler anzeigt.

  3. Abschluss der Zahlung
    • Zu einem späteren Zeitpunkt wird iDEAL Wero Trust Payments kontaktieren, Trust Payments die Abwicklung der Zahlung Trust Payments bestätigen.
    • Trust Payments sendet eine URL-Benachrichtigung an das System des Händlers, um zu bestätigen, dass der Betrag beglichen wurde.
    • Der Händler erhält die Meldung und antwortet, um Trust Payments zu informieren, dass die Meldung erfolgreich empfangen wurde.

 

1. Initiieren Sie den Kunden

Wenn der Kunde sich für die Zahlung mit iDEAL Wero entscheidet, muss Ihr System eine AUTH stellen und, falls diese erfolgreich ist, den Browser des Kunden zu der in der Antwort zurückgegebenen URL weiterleiten.

  Anzeige von iDEAL Wero an Ihrer Kasse

 

AUTH Anfrage

Die folgende Beispielanfrage bezieht sich auf eine iDEAL Wero AUTH :

Python PHP cURL Rohes JSON Rohes XML
#!/usr/bin/python
import securetrading

stconfig = securetrading.Config()
stconfig.username = "webservices@example.com"
stconfig.password = "Password1^"
st = securetrading.Api(stconfig)

auth = {
  "currencyiso3a": "EUR",
  "requesttypedescription": "AUTH",
  "accounttypedescription": "ECOM",
  "sitereference": "test_site12345",
  "baseamount": "1050",
  "paymenttypedescription": "IDEAL",
  "successfulurlredirect": "https://yourwebsite.com",
  "errorurlredirect": "https://yourwebsite.com",
  "billingfirstname": "Joe",
  "billinglastname": "Bloggs",
  "billingcountryiso2a": "NL"
}

strequest = securetrading.Request()
strequest.update(auth)
stresponse = st.process(strequest) #stresponse contains the transaction response

Ersetzen Sie <DOMAIN> mit einer unterstützten Domäne. Vollständige Domainliste anzeigen.

 

Feldspezifikation

  Feld Format Beschreibung
Erforderlich accounttypedescription
XPath: /operation/accounttypedescription
Alpha (20) Nur "ECOM" (E-Commerce) wird unterstützt.
Erforderlich baseamount
XPath: /billing/amount
Numerisch (13) Der Betrag der Transaktion in Basiseinheiten, ohne Kommas oder Dezimalpunkte, d. h. €10 werden als €1000 übermittelt. Dieser Wert muss größer als Null sein. (Die maximale Länge kann je nach Bank variieren - weitere Informationen erhalten Sie von Ihrer Bank)
Erforderlich billingcountryiso2a
XPath: /billing/country
Alpha (2)

Das Land, in dem die Rechnungsadresse des Kunden liegt. Diese muss im ISO2A-Format angegeben werden.

Eine Liste der von iDEAL Wero unterstützten Ländercodes finden Sie oben auf dieser Seite.

Erforderlich currencyiso3a
XPath: /billing/amount/@currencycode
Alpha (3)

Die Währung , in der die Transaktion verarbeitet werden soll (im ISO3A-Format).

Eine Liste der von iDEAL Wero unterstützten Währung finden Sie oben auf dieser Seite.

Erforderlich errorurlredirect
XPath: /merchant/errorurlredirect
URL (2048) Die URL, zu der der Kunde nach einem Fehler auf den von iDEAL Wero gehosteten Seiten zurückgeleitet wird.
Erforderlich paymenttypedescription
XPath: /billing/payment/@type
Alpha (20) Dieser Wert muss als "IDEAL" angegeben werden.
Erforderlich requesttypedescription
XPath: /@type
Alpha (20) Der Wert in der Anfrage muss "AUTH" lauten.
Erforderlich sitereference
XPath: /operation/sitereference
Alphanumerisch
& Unterstrich (50)
Die Website-Referenz auf Ihr individuelles Konto, das Sie bei der Einrichtung erhalten haben. Wenn Sie Ihre Website-Referenz nicht kennen, wenden Sie sich bitte wenden Sie sich an unser Support-Team.
Erforderlich successfulurlredirect
XPath: /merchant/successfulurlredirect
URL (2048) Die URL, zu der der Kunde nach einer erfolgreichen Autorisierung iDEAL Wero zurückgeleitet wird.
Bedingt billingprefixname
XPath: /billing/name/prefix
Alphanumerisch einschließlich
Symbole (25)

Das Präfix des Rechnungsnamens des Kunden (z. B. Herr, Frau, Dr.).

Mindestens eines der Felder für den Rechnungsnamen ist erforderlich.

Bedingt billingfirstname
XPath: /billing/name/first
Alphanumerisch einschließlich
Symbole (127)

Der Kunde ist Rechnungsvorname.

Mindestens eines der Felder für den Rechnungsnamen ist erforderlich.

Bedingt billingmiddlename
XPath: /billing/name/middle
Alphanumerisch einschließlich
Symbole (127)

Der/die mittlere(n) Rechnungsname(n) des Kunden.

Mindestens eines der Felder für den Rechnungsnamen ist erforderlich.

Bedingt billinglastname
XPath: /billing/name/last
Alphanumerisch einschließlich
Symbole (127)

Der Kunde ist Rechnungsnachname.

Mindestens eines der Felder für den Rechnungsnamen ist erforderlich.

Bedingt billingsuffixname
XPath: /billing/name/suffix
Alphanumerisch einschließlich
Symbole (25)

Das Suffix des Rechnungsnamens des Kunden (z. B. Bsc).

Mindestens eines der Felder für den Rechnungsnamen ist erforderlich.

Optional orderreference
XPath: /merchant/orderreference

Alphanumerisch einschließlich Symbole (25)

 

Empfohlene Länge 25 Zeichen oder weniger (genaue Länge abhängig von der erwerbenden Bank). Die Nichteinhaltung dieser Anforderung kann dazu führen, dass der Text in der Transaktion abgeschnitten wird.

Ihre eindeutige Auftragsnummer, die im System Trust Payments gespeichert werden kann.

 

AUTH Antwort

Python PHP Rohes JSON Rohes XML
{
'requestreference': 'An3ug1kap',
'version': '1.00',
'responses': [{
'transactionreference': '23-86-113',
'merchantname': 'Test Merchant',
'paymenttypedescription': 'IDEAL',
'settleduedate': '2017-03-16',
'baseamount': '1050',
'transactionstartedtimestamp': '2017-03-16 16:25:08',
'errormessage': 'Ok',
'settlestatus': '10',
'accounttypedescription': 'ECOM',
'errorcode': '0',
'redirecturl': 'https://example.com',
'acquirertransactionreference': '12',
'acquirersecret': 'q9gy5ppgdyd5fh60kfe2j0f26peu2xww',
'requesttypedescription': 'AUTH',
'acquirerresponsemessage': 'PENDING',
'operatorname': 'webservices@example.com',
'livestatus': '0',
'currencyiso3a': 'EUR'
}]
}

 

Feldspezifikation

  Feld Format Beschreibung
Zurückgeschickt accounttypedescription
XPath: /operation/accounttypedescription
Alpha (20) Der zurückgegebene Wert ist "ECOM".
Zurückgeschickt acquirersecret
XPath: /acquirersecret
Alphanumerisch (64) Wird von Trust Payments verwendet, um die Antwort des Acquirers zu überprüfen. (Ihr System braucht dies nicht zu überprüfen)
Zurückgeschickt acquirertransactionreference
XPath: /acquirertransactionreference
Alphanumerisch einschließlich Symbole (127) Eindeutige Transaktionsnummer von iDEAL Wero.
Zurückgeschickt baseamount
XPath: /billing/amount
Numerisch (13) Der Betrag der Transaktion in Basiseinheiten, ohne Kommas oder Dezimalpunkte, so dass €10 als 1000 zurückgegeben werden.
Zurückgeschickt currencyiso3a
XPath: /billing/amount/@currencycode
Alpha (3)

Die Währung, in der die Transaktion verarbeitet wurde (im ISO3A-Format).

Eine Liste der von iDEAL Wero unterstützten Währung finden Sie oben auf dieser Seite.

Zurückgeschickt errorcode
XPath: /error/code
Numerisch (1-5)

Die Fehlercode (errorcode) sollte verwendet werden, um festzustellen, ob die Anfrage erfolgreich war oder nicht.

  • Wenn die Fehlercode "0" ist, war die Transaktion erfolgreich.
  • Wenn die Fehlercode nicht "0" ist, war die Transaktion nicht erfolgreich.

Vollständige Liste der errorcode und Nachrichtenwerte.

Zurückgeschickt errormessage
XPath: /error/message
Alphanumerisch (255)

Dies ist die entsprechende Meldung zum obigen Code.

Vollständige Liste der errorcode und Nachrichtenwerte.

Zurückgeschickt livestatus
XPath: /live
Numerisch (1)
  • 0 - Die Transaktion wurde über ein Testkonto abgewickelt.
  • 1 - Transaktion wird über ein Live-Konto abgewickelt.
Zurückgeschickt operatorname
XPath: /merchant/operatorname
Alphanumerisch (255) Der Wert dieses Feldes enthält den Namen des Benutzers, der die Anfrage bearbeitet hat.
Zurückgeschickt paymenttypedescription
XPath: /billing/payment/@type
Alpha (20) Der zurückgegebene Wert ist "IDEAL".
Zurückgeschickt redirecturl
XPath: /other/redirecturl
URL (255) Leiten Sie den Browser des Kunden zu dieser URL weiter, damit er die Zahlung über iDEAL Wero's gehostete Seiten abschließen kann.
Zurückgeschickt requesttypedescription
XPath: /@type
Alpha (20) Der zurückgegebene Wert ist "AUTH".
Zurückgeschickt settleduedate
XPath: /settlement/settleduedate
Datum JJJJ-MM-TT Das Datum, an dem die Transaktion abgewickelt wird.
Zurückgeschickt settlestatus
XPath: /settlement/settlestatus
Numerisch (3) Damit können Sie den Status der Zahlung ermitteln. Wie dieses Feld am besten zu interpretieren ist, erfahren Sie im Abschnitt Handhabung der Antwort weiter unten.
Zurückgeschickt transactionreference
XPath: /transactionreference
Alphanumerisch einschließlich
Bindestriche (25)
Eine eindeutige Referenz für die Transaktion, die von Trust Payments zugewiesen wird.
Zurückgeschickt transactionstartedtimestamp
XPath: /timestamp
Datum Uhrzeit JJJJ-MM-TT hh:mm:ss Der Zeitpunkt, zu dem die Transaktion bearbeitet wurde.
Bedingt acquirerresponsemessage
XPath: /acquirerresponsemessage
Alphanumerisch (255)

Wird von Ihrem Acquirer verwendet, um das Ergebnis der Anfrage anzuzeigen.

Dies hängt von Ihrer Bank ab. Bitte kontaktieren Sie Ihre Bank für weitere Informationen.

Bedingt errordata
XPath: /error/data
Alphanumerisch (255)

Zusätzliche Informationen zur Behebung des Fehlers.

Wird nur zurückgegeben, wenn ein Fehler aufgetreten ist.

Bedingt merchantname
XPath: /merchant/merchantname
Alphanumerisch (255)

Es handelt sich dabei um Angaben zu dem Konto, über das die Transaktion abgewickelt wird.

Um diese Felder zu ändern, wenden Sie sich bitte wenden Sie sich an unser Support-Team.

Hängt von der Konfiguration Ihres Kontos ab.

 

Umgang mit der Antwort

Die settlestatus Die in der AUTH zurückgegebene Nummer wird verwendet, um den Status der iDEAL Wero-Zahlung zu bestimmen:

  Wenn die settlestatus 10" ist, ist die Zahlung ausstehend Abrechnung

  • Das Geld ist noch nicht auf Ihrem Bankkonto eingegangen.
  • Der nächste Schritt ist die Umleitung des Kundenbrowsers auf die redirecturl um die Zahlung abzuschließen.

Die Gelder werden erst dann auf Ihr Konto überwiesen, wenn der Kunde zur Zahlung auf die Seiten iDEAL Wero weitergeleitet wurde. Weitere Informationen finden Sie weiter unten.

  • Wenn es eine Aktualisierung der Abrechnungsstatus der AUTH gibt, erhalten Sie eine URL-Benachrichtigung , um Sie darüber zu informieren, dass die settlestatus wurde entweder auf "3" oder "100" aktualisiert.
  • Weitere Informationen zu den Notifizierungen finden Sie weiter unten.

  Wenn die settlestatus ist "3", wurde die Zahlung storniert

  • Die Zahlung wurde abgelehnt, oder es ist ein Fehler aufgetreten.
  • Um mehr darüber zu erfahren, warum die Zahlung fehlgeschlagen ist, müssen Sie sich die errorcode. z.B. "70000" bedeutet, dass die Zahlung abgelehnt wurde. Vollständige Liste der Fehlercodes anzeigen.

Zusätzlich zu den oben genannten Punkten empfehlen wir auch zusätzliche Kontrollen nach der Zahlung durchzuführen.

 

2. Weiterleitung zu iDEAL Wero

Ihr System muss den Browser des Kunden auf die redirecturl, eine von iDEAL Wero gehostete Seite, um die Zahlung abzuwickeln.

  Zeigen Sie nicht die redirecturl innerhalb einer iframe. Dies verhindert die korrekte Darstellung des Inhalts und kann letztlich dazu führen, dass die Zahlung nicht erfolgreich abgeschlossen werden kann.

Zu einem späteren Zeitpunkt wird der Kunde dann entweder auf die successfulurlredirect oder die errorurlredirect in der Anfrage AUTH angegeben.

  Wird der Kunde auf die Seite successfulurlredirect:

Der Kunde hat die erforderlichen Schritte auf den Seiten von iDEAL Wero erfolgreich abgeschlossen.
Empfohlene Maßnahmen: Zeigen Sie eine Bestätigung an, dass die Zahlung erfolgreich war.

  Wird der Kunde auf die Seite errorurlredirect:

Der Kunde ist auf ein Problem gestoßen, das ihn daran gehindert hat, die Zahlung abzuschließen.
Empfohlene Maßnahmen: Informieren Sie den Kunden darüber, dass ein Problem bei der Zahlung aufgetreten ist, und zeigen Sie ausreichende Transaktionsdetails an, damit der Kunde den Zahlungsversuch abfragen kann.

  Beim Testen wird Ihnen die von iDEAL Wero bereitgestellte Sandbox angezeigt. Um eine Testtransaktion durchzuführen, müssen Sie die Anweisungen auf dem Bildschirm befolgen. Bitte wenden Sie sich an Ihren Kundenbetreuer, um die Zugangsdaten für die Sandbox zu erhalten.

 

3. Abschluss der Zahlung

Sobald der Kunde von der von iDEAL Wero gehosteten Seite entweder zur successfulurlredirect oder errorurlredirect auf Ihrer Website gehostet wird, müssen Sie entweder eine Bestätigungs- oder eine Fehlermeldung anzeigen.

  Überprüfen Sie bitte alle URL-Weiterleitungsregeln, die in Regel-Manager auf Ihren Website-Referenz(s) aktiviert sind, da diese möglicherweise im Konflikt stehen und Vorrang vor den successfulurlredirect und errorurlredirect Felder, die in der Anfrage AUTH übermittelt wurden.

Sobald eine Zahlung autorisiert wurde, wird der Betrag zu einem späteren Zeitpunkt, wie von iDEAL Wero festgelegt, abgerechnet.

  Der Abrechnung für iDEAL Wero unterscheidet sich vom Standardprozess, der bei kartengestützten Zahlungsmethoden angewendet wird.

  Die Meldung Abrechnung darf nicht unmittelbar nach der Bearbeitung der Anfrage gesendet werden. AUTH

Für den unwahrscheinlichen Fall, dass die Zahlung nach 7 Tagen immer noch aussteht Abrechnung (settlestatus "10"), wird dies zur Untersuchung eingeplant und wir werden Sie mit weiteren Informationen kontaktieren.

Bevor Sie mit dem Testen beginnen, empfehlen wir Ihnen, sich mit unserem Support-Team in Verbindung zu setzen und zu beantragen, dass in Ihrem Konto Regeln aktiviert werden, die URL-Benachrichtigungen in den folgenden Szenarien an Ihr System übermittelt:

  • Wenn eine Zahlung genehmigt wird.
  • Wenn die Gelder abgewickelt sind.

 

Konfigurieren der Benachrichtigung Autorisierung

Wir empfehlen, mindestens die folgenden Felder in Ihre Autorisierung Meldung aufzunehmen:

  • Antwortnachricht des Käufers (acquirerresponsemessage)
  • Basisbetrag (baseamount) (z.B. £10.50 ist "1050")*
  • Hauptbetrag (mainamount) (z.B. £10.50 ist "10.50")*
  • Rechnungsland (billingcountryiso2a)
  • Währung (currencyiso3a)
  • Fehlercode (errorcode)
  • Live-Status (livestatus)
  • Bestellnummer (orderreference)
  • Zahlungsart (paymenttypedescription)
  • Anforderungstyp (requesttypedescription)
  • Abrechnungsstatus (settlestatus)
  • Website-Referenz (sitereference)
  • Transaktionsnummer (transactionreference)
  • Zeitstempel Transaktionsstart (transactionstartedtimestamp)

*Bitte wählen Sie Ihr bevorzugtes Format.

 

Konfigurieren der Benachrichtigung Abrechnung

Wir empfehlen, die folgenden Felder in Ihre Abrechnung Meldung aufzunehmen:

  • Abrechnungsstatus (settlestatus)
  • Website-Referenz (sitereference)
  • Transaktionsnummer (transactionreference)

 

Prüfen Sie die Benachrichtigung

Sie müssen den Inhalt jeder eingegangenen Meldung prüfen und entsprechend reagieren, indem Sie die in unserer Website beschriebenen Verfahren befolgen. URL-Benachrichtigungen Dokumentation. Insbesondere müssen Sie sich die aktualisierte settlestatus Wert:

  • Auf Autorisierung: Wenn die settlestatus 0", "1" oder "10" ist, wurde die Zahlung autorisiert und Sie müssen zu diesem Zeitpunkt keine weiteren Maßnahmen ergreifen. Werte von "2" oder "3" bedeuten jedoch, dass die Mittel nicht geplant für Abrechnung (ausgesetzt und storniert, bzw.).
  • Auf Abrechnung: Wenn die settlestatus auf "100" aktualisiert wurde, bedeutet dies, dass der Betrag beglichen wurde. Wurde der Wert auf "3" aktualisiert, bedeutet dies, dass ein Problem aufgetreten ist und die Zahlung daraufhin storniert wurde.

  Stornierte Transaktionen (settlestatus "3") kann zu einem späteren Zeitpunkt beglichen werden. In Fällen, in denen der Kunde die zur Erfüllung der Zahlung erforderlichen Schritte abgeschlossen hat, ist die settlestatus wird auf "100" aktualisiert, um anzuzeigen, dass das Geld auf Ihr Konto überwiesen wurde.

Wenn Sie das Support-Team kontaktiert haben, um Abrechnung Benachrichtigungen zu konfigurieren (wie oben beschrieben), werden Sie benachrichtigt, wenn dies geschieht.

 

Prüfung

Sie müssen Ihre Lösung testen, bevor Sie mit der Verarbeitung von Live-Zahlungen beginnen können. Testtransaktionen werden über Ihr Testsystem Website-Referenz verarbeitet.

  Voraussetzungen

Bitte wenden Sie sich an unser Support-Team und geben Sie dabei die Daten Ihres iDEAL Wero-Testkontos an. Wir konfigurieren dann Ihre Website-Referenz sie direkt mit der iDEAL Wero-Testumgebung verbunden ist.

Bei der Durchführung von Testtransaktionen leitet die in der AUTH zurückgegebene Weiterleitungs-URL Ihren Browser zur iDEAL Wero-Testumgebung weiter, um eine Zahlung zu simulieren. Ansonsten entspricht der Ablauf genau dem der Verarbeitung von Live-Zahlungen.

 

Rückerstattungen

Nach der Verarbeitung einer Zahlung mit iDEAL Wero ist es möglich, dem Kunden das Geld zurückzuerstatten, indem eine REFUND gestellt wird.

Rückerstattungen für iDEAL Wero werden sofort abgewickelt (settlestatus "100").

 

Voraussetzungen

  • Sie können eine Zahlung erst dann erstatten, wenn die AUTH abgewickelt wurde (settlestatus ist "100").
  • Sie können keinen höheren Betrag erstatten, als ursprünglich abgerechnet wurde.

Die REFUND und -antwort für iDEAL Wero-Zahlungen folgen denselben Feldspezifikationen, wie sie in unserer REFUND beschrieben sind. Erfahren Sie mehr über Rückerstattungen.

War dieser Artikel hilfreich?
0 von 0 Personen fanden dies hilfreich