iDEAL AcquirerErrorRes (X')


Function

To report an error that has occurred from the Acquirer to the Merchant

Root

AcquirerErrorRes

Data elements

 

createDateTimestamp

Error

Signature

Sub-element

errorCode
errorMessage
errorDetail
suggestedAction
consumerMessage

SignedInfo
SignatureValue
KeyInfo

Request

DirectoryReq (A), AcquirerTrxReq (B), or AcquirerStatusReq (F)

Communication

HTTP response with an XML message.

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

(Sub-)element

Description

createDateTimestamp

Date and time at which this message was created

 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.
Error

errorCode

Unique identification of the error occurring within the iDEAL system. Error codes overview for the code list.

errorMessage

Descriptive text accompanying Error.errorCode

errorDetail

(Optional)

Details of the error. The message/generating party is free to determine this information.

suggestedAction

(Optional)

Suggestions aimed at resolving the problem

consumerMessage

(Optional)

An Acquirer can use this field to include a (standardised) message that the Merchant should show to the Consumer.

 More info

Note: the language should be determined based on the value of the Transaction.language field in AcquirerTrxReq (B).

Example Message

<?xml version="1.0" encoding="UTF-8"?>
<AcquirerErrorRes xmlns="http://www.idealdesk.com/ideal/messages/mer-acq/3.3.1" version="3.3.1">
  <createDateTimestamp>2008-11-14T09:30:47.0Z</createDateTimestamp>
  <Error>
    <errorCode>SO1100</errorCode>
    <errorMessage>Issuer not available</errorMessage>
    <errorDetail>System generating error: Rabobank</errorDetail>
    <consumerMessage>
      De geselecteerde iDEAL bank is momenteel niet beschikbaar i.v.m. onderhoud tot naar verwachting 31-12-2010 03:30. Probeer het later nogmaals of betaal op een andere manier.
    </consumerMessage>
  </Error>
  <Signature xmlns="http://www.w3.org/2000/09/xmldsig#">
      <!-- Signature is placed here. See Signature section for specification-->
  </Signature>
</AcquirerErrorRes>