iDEAL AcquirerStatusReq (F)


Function

To retrieve the status of a specific transaction (payment confirmation) from the Acquirer by the Merchant

Root

AcquirerStatusReq

Data elements

createDateTimestamp 

 

Merchant

Transaction

Signature

Sub-elements

merchantID
subID

transactionID

SignedInfo
SignatureValue
KeyInfo

Response

AcquirerStatusRes (F').

Communication

HTTP POST request with an XML message to the AcquirerStatusURL

Security / authentication

  • Unilateral TLS connection (Acquirer holds SSL server certificate)
  • Authentication of Acquirer based on Acquirer's SSL server certificate
  • Authentication of Merchant based on Merchant.merchantIDMerchant.subID in the message
Comment

A Merchant may send an AcquirerStatusReq to an Acquirer for transactions only in the following cases:

  • when triggered by a an Redirect to Merchant (E) as part of the Payment protocol, or
  • one time, 3 minutes after the AcquirerTrxRes (B') was received, or
  • when triggered by the elapsing of the expirationPeriod, or
  • at a later time after the expirationPeriod has elapsed.

The Merchant should submit a 'batch processing' of open transactions serially (one by one) to the Acquirer. See 'iDEAL_010 Standards' for further details.



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

merchantID

Made up of Acquirer.acquirerID (first four positions) and a unique number of five positions (together nine positions)

subIDA number from 0 to and including 999999 in which each value is related to a trade name registered with the Acquirer. The default value is '0'.
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).

Example Message

<?xml version="1.0" encoding="UTF-8"?>
<AcquirerStatusReq
    xmlns="http://www.idealdesk.com/ideal/messages/mer-acq/3.3.1" version="3.3.1">
    <createDateTimestamp>2008-11-14T09:30:47.0Z</createDateTimestamp>
    <Merchant>
        <merchantID>100000001</merchantID>
        <subID>1</subID>
    </Merchant>
    <Transaction>
        <transactionID>0001000000000001</transactionID>
    </Transaction>
    <Signature xmlns="http://www.w3.org/2000/09/xmldsig#">
        <!-- Signature is placed here. See Signature section for specification-->
    </Signature>
</AcquirerStatusReq>