Page Comparison

Function	To deliver the Acquirer's most recent list of Issuers to the Merchant
Root	DirectoryRes
Data elements	`createDateTimestamp`
	`Acquirer`	`Directory`	`Country`		`Signature`
			`countryNames`	`Issuer`
Sub-elements	`acquirerID`	`directoryDateTimestamp`		`issuerID` `issuerName`	`SignedInfo` `SignatureValue` `KeyInfo`
Request	DirectoryReq (A)
Communication	HTTP POST request with an XML message to the AcquirerDirectoryURL
Security / authentication	Unilateral TLS connection (Acquirer holds SSL server certificate) Authentication of Acquirer based on Acquirer's SSL server certificate Merchant validates the Acquirer's electronic signature to determine the authenticity of the message

Section

Column

width	675px

(Sub-)element

Description

createDateTimestamp

Date and time at which this message was created

Expand

title	More info

Note: Because the field is included in the digital signature, the value of this field must be determined prior to generating the signature.

Acquirer

acquirerID

Unique four-digit identifier of the Acquirer within iDEAL, assigned by iDEAL when registering the Acquirer. The Acquirer.acquirerID must be known to all Issuers with which the Acquirer makes agreements.

Directory

directoryDateTimestamp The date on which the list of Issuers was updated by the Acquirer

Country

(1..∞)

Contains all CountryName and Issuer sub-elements (see below)

Expand

title	Note

Note
Note: The Acquirer must place the Country elements in such a way that they are ordered alphabetically according to the field Country.countryNames.

Country

countryNames Contains the country names in the official languages of the country, separated by a '/' symbol (e.g. 'België/Belgique')

Issuer

(1..∞)

Contains an issuerID, issuerName pair (see below)

Expand

title	Note

Note
Note: An Acquirer must place the Issuer elements in each Country element in such a way that they are ordered alphabetically according to the field Issuer.issuerName.

Issuer

issuerID Unique identifier of the Issuer that consists of the international Bank Identifier Code (BIC). The Issuer.issuerID must be known to all Acquirers with which the Issuer makes agreements.

issuerName The name of the Issuer (as this should be displayed to the Consumer on the Merchant's Issuer list).

Column

width	100%

Example Message

Excerpt

Code Block

language	xml

<?xml version="1.0" encoding="UTF-8"?>
<DirectoryRes
    xmlns="http://www.idealdesk.com/ideal/messages/mer-acq/3.3.1" version="3.3.1">
    <createDateTimestamp>2008-11-14T09:30:47.0Z</createDateTimestamp>
    <Acquirer>
        <acquirerID>0001</acquirerID>
    </Acquirer>
    <Directory>
        <directoryDateTimestamp>2004-11-10T10:15:12.145Z</directoryDateTimestamp>
        <Country>
            <countryNames>Nederland</countryNames>
            <Issuer>
                <issuerID>ABNANL2AXXX</issuerID>
                <issuerName>ABN AMRO Bank</issuerName>
            </Issuer>
            <Issuer>
                <issuerID>INGBNL2AXXX</issuerID>
                <issuerName>ING</issuerName>
            </Issuer>
            <Issuer>
                <issuerID>RABONL2UXXX</issuerID>
                <issuerName>Rabobank</issuerName>
            </Issuer>
        </Country>
    </Directory>
    <Signature xmlns="http://www.w3.org/2000/09/xmldsig#">
 <!-- Signature is placed here. See Signature section for specification-->
    </Signature>
</DirectoryRes>

Schematic representation

Versions Compared

Old Version 4

New Version Current

Key