Each message described in this section is an XML message conforming to the XML Schema in Appendix: Message XML Schema. A list of the fields used and the format can be found in 'Appendix: Data dictionary'.  The IDs used in the messages are explained in 'Appendix: IDs' in the 'iDEAL_010 Standards' document.

In the message overviews, indicated fields are mandatory unless otherwise is indicated (as followed):

The message tables include the parent elements in bold, which contain sub-elements. Some sub-elements are also parent elements.

HTTP

The following HTTP header must be used for all messages:

Data element

Mandatory

Explanation

Content-Type

Yes

Defines how the remainder of the content is to be interpreted. Contains the value: text/xml; charset=utf-8.

XML header

The following XML header must be used for all messages:

<?xml version="1.0" encoding="UTF-8"?>

Character set

Conventions for empty fields

In iDEAL an XML tag for an optional or conditional field is either:

Message validation

All messages must be validated against the iDEAL XML Schema. The schema also references the XML Digital Signature Schema which must be used to validate the Signature element. The XML Digital Signature Schema is available from W3C at the following URL: http://www.w3.org/2000/09/xmldsig#. If additional validation of specific fields is required, it is indicated in the field specification.

Message version

The namespace of all messages described in this document holds the version of the messages. 
For backward compatibility all XML message content (requests and [error] responses) must contain a version attribute in the root element, as shown in the table below.

Attribute

Mandatory

Explanation

version

Yes

Value must be: 3.3.1