Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


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


Section


Column
width675px


(Sub-)element

Description

createDateTimestamp

Date and time at which this message was created

Expand
titleMore 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.

Expand
titleMore info

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




Column
width100%

Example Message


Excerpt


Code Block
languagexml
<?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>