iDEAL AcquirerStatusRes (F')


Function

To transfer the status of a specific transaction (payment confirmation) from the Acquirer to the Merchant

Root

AcquirerStatusRes

Data elements

 

createDateTimestamp

Acquirer

Transaction

Signature

Sub-element

acquirerID

transactionID 
status 
statusDateTimestamp 
consumerName (conditional) 
consumerIBAN (conditional) 
consumerBIC (conditional) 
amount (conditional) 
currency (conditional)

SignedInfo
SignatureValue
KeyInfo

Request

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

Transaction

transactionID

Unique 16-digit number within iDEAL, assigned by an Acquirer. The number consists of a section from the Acquirer (Acquirer.acquirerID, first four positions) and a unique number generated by the Acquirer (12 positions). Ultimately appears on payment confirmation (statement and confirmation screen).

status

Indicates the status of the transaction. 

 Statusses
Success: Positive result; the payment is guaranteed. 
Cancelled: Negative result due to cancellation by Consumer; no payment has been made. 
Expired: Negative result due to expiration of the transaction; no payment has been made. 
Failure: Negative result due to other reasons; no payment has been made. 
Open: Final result not yet known.
statusDateTimestamp

Conditional

Processing date and time of transaction by the Issuer. If Transaction.status is 'Open', this field shall not be included. For all other values of Transaction.status, this field must be included. 

 More info
This is the date and time at which the Issuer establishes the Transaction.status for this transaction and records it as part of the transaction details.
consumerName

Conditional

Name of the Consumer according to the name of the account used for payment. This could deviate from the account details held by the Merchant. 

Only included if Transaction.status is 'Success'.

 More info

This information enables the Merchant to make a refund, if necessary (together with Transaction.consumerIBAN and Transaction.consumerBIC). In the exceptional case of a succesful transaction during a period in which an Issuer is not able to determine the Consumer name the Issuer must fill the field consumerName with "N/A" which stands for Not Available. When the field is filled with N/A, the sign "/" eliminates the theoretical possiblity that the content will be seen as an actual and correct Consumer name. In these cases the Merchant cannot initiate a refund based on the contents of this field. 

If governing laws prevent Issuers from providing Transaction.consumerName those Issuers are allowed to not include the field.

consumerIBAN

Conditional

The IBAN of the account the Consumer used for payment. 

Only included if Transaction.status is 'Success'.

 More info
If governing laws prevent Issuers from providing Transaction.consumerIBAN those Issuers are allowed to not include the fields.
consumerBIC

Conditional

BIC of the bank where the Consumer's account is held. 

Only included if Transaction.status is 'Success'.

 More info
If governing laws prevent Issuers from providing Transaction.consumerBIC those Issuers are allowed to not include the fields.
amount

Conditional

The amount guaranteed by the Issuer to the Acquirer (with period (.) as a decimal separator, if required) 

Only included if Transaction.status is 'Success'.

 More info
The Acquirer should verify that this value is equal to the value of the Transaction.amount in the IssuerTrxReq (C).
currency

Conditional

The currency in which the guaranteed amount is expressed.

Only included if Transaction.status is 'Success'.

 More info
The Acquirer should verify that this value is equal to the value of the Transaction.currency in the IssuerTrxReq (C).

Example Message

<?xml version="1.0" encoding="UTF-8"?>
<AcquirerStatusRes
	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>
	<Transaction>
		<transactionID>0001000000000001</transactionID>
		<status>Success</status>
		<statusDateTimestamp>2008-11-14T09:32:47.0Z</statusDateTimestamp>
		<consumerName>Onderheuvel</consumerName>
		<consumerIBAN>NL44RABO0123456789</consumerIBAN>
		<consumerBIC>RABONL2U</consumerBIC>
		<amount>59.99</amount>
		<currency>EUR</currency>
	</Transaction>
    <Signature xmlns="http://www.w3.org/2000/09/xmldsig#">
       <!-- Signature is placed here. See Signature section for specification-->
    </Signature>
</AcquirerStatusRes>

Copyright © Currence iDEAL B.V. All rights reserved.