1. Configuration

Go to "Electronic reporting" in your ePDQ Account:

  • On account (PSPID) level: Select "Operations" and choose "Electronic reporting" in the sub-menu.
  • On user (USERID) level:
    1. Select "Advanced" and choose "Users" in the sub-menu.
    2. Click "Edit" for the specific user.
    3. Select "Electronic Reporting for this User" at the bottom of the page in the User's Data overview.

You can select your preferred file structure and file format for the reports.

You can define the file structure and format for each user. When you configure the electronic reporting parameters for a user, this configuration will be applied to all reports set up by this user.

Specific fields will be returned in your report, depending on the file structure.

You can choose one of the following file structures:

  • Standard
  • Extended
  • Dynamic
  • File Management

You can also choose between the following return formats:

  • XML
  • Fixed-length
  • Delimited

2. Steps

Execute the following steps to download formatted files with transaction information:

  1. Define the file format and structure on the Electronic reporting page.
  2. Use the Financial history, View transactions and View files options to select the required information.
  3. Click on the "Download" button.

Customise the output of your downloaded files with the following criteria:

  • The structure defines the data and the position of the various selected payments.
  • The format defines the output data format.
  • The "Sort by" specifications allow you to group your data according to certain values.
  • The Additional options help you to adapt the payment records' display.

3. Structure

Obtain the data by using one of the following structures:

  • Standard
  • Extended
  • Dynamic
  • File Management

Each structure has a different number (and position) of fields in the selected payments.
These fields are described in the data dictionary which includes the XML tag name, size, format and description.

3.1 Common Fields

XML Tags Description
ID Payment reference
REF Merchant's reference
ORDER Order date
STATUS Status
LIB Status description
ACCEPT Authorisation code from acquirer

3.2 Standard

Financial history, View transactions:

XML Tags Description
See Common Fields ...
PAYDATE Payment date
CIE Company
NAME Invoicing name
COUNTRY Buyer's invoicing country (optional)
TOTAL Amount
CUR Currency
SHIP Delivery costs (optional)
TAX Taxes (optional)
METHOD Payment methods
BRAND Card type
CARD Card number
STRUCT Structured communication (optional) (e.g. for Net banking payments)

Financial history (Download Summary):

XML Tags Description
CLIENTID ClientID
METHOD Payment methods
BRAND Card type
OWNER Cardholder's name
CARD Card number
PAYDATE Payment date
STATUS Status
LIB Status description
TOTAL Amount
CUR Currency
NBPAY Number of transactions
BATCHREF Batch Reference

View files (selection page):

XML Tags Description
MERCHREF Merchant's reference
DATE File date
STATUS Status
OPERATION File Operation
NBPAY Number of transactions
TRANSACTION Transaction code

3.3 Extended

For the View files (selection page) and the Financial history (summary), please refer to the Standard structure.

Financial history, View transactions:

XML Tags Description
See Common Fields ...
NCID Transaction code (NCID)
NCSTER Transaction state
PAYDATE Payment date
CIE Company
FACNAME1 Invoicing name, line 1
FACNAME2 Invoicing name, line 2 (optional)
FACSTREET1 Invoicing address, line 1 (optional)
FACSTREET2 Invoicing address, line 2 (optional)
FACZIP Invoicing postcode/ZIP (optional)
FACTOWN Invoicing city (optional)
COUNTRY Buyer's invoicing country (optional)
DELNAME1 Delivery name, line 1 (optional)
DELNAME2 Delivery name, line 2 (optional)
DELSTREET1 Delivery address, line 1 (optional)
DELSTREET2 Delivery address, line 2 (optional)
DELZIP Delivery postcode/ZIP (optional)
DELTOWN Delivery city (optional)
DELCOUNTRY Delivery country (optional)
TOTAL Amount
CUR Currency
SHIP Delivery costs (optional)
TAX Taxes (optional)
METHOD Payment methods
BRAND Card type
CARD Card number
UID UID
STRUCT

Structured communication
(e.g. for net banking payments)

FILEID Transaction uploaded via file
ACTION Last action (Financial history)
TICKET Virtual Ticket (Financial history)
PSPID PSPID (for Merchant group users)
DESC Description

3.4 Dynamic (new extended format)

This structure contains optional fields. A detailed level is available for Purchasing, Merchant Assistant or Travel.

XML Tags Description
See Common Fields ...
NCID Transaction code (NCID)
NCSTER Transaction state
PAYDATE Payment date
CIE Company
FACNAME1 Invoicing name, line 1
COUNTRY Buyer's invoicing country (optional)
TOTAL Amount
CUR Currency
METHOD Payment methods
BRAND Card type
CARD Card number
EXPDATE Exp. date
UID UID
STRUCT Structured communication (e.g. for Net banking payments)
FILEID Transaction uploaded via file
ACTION Last action (Financial history)
TICKET Virtual Ticket (Financial history)
DESC Description
SHIP Delivery costs (optional)
TAX Taxes (optional)
USERID User
PSPID PSPID (for Merchant group users)
REFID Entity
REFKIND Entity type
ECI Electronic Commerce Indicator (Origin of the transaction (ECI)).
CCCTY Card-issuing country
IPCTY IP address country
CVCCHECK Card Validity Code Check
AAVCHECK Automatic Address validity Check
VC Virtual Card type
BATCHREF Batch Reference

For the "Dynamic" structure, these fields can be added at the end of the structure.

List of available fields on the "Electronic reporting" page:

XML Tags
FACNAME2 Invoicing name, line 2
FACSTREET1 Invoicing address, line 1
FACSTREET2 Invoicing address, line 2
FACZIP Invoicing postcode (ZIP)
FACTOWN Invoicing city
DELNAME1 Delivery name, line 1
DELNAME2 Delivery name, line 2
DELSTREET1 Delivery address, line 1
DELSTREET2 Delivery address, line 2
DELZIP Delivery postcode (ZIP)
DELTOWN Delivery city
DELCOUNTRY Delivery country
DELDOB Delivery date of birth
TELNO Phone number
REF1 Customer reference (Ref.1)
REF2 Customer reference (Ref.2)
REF3 Customer reference (Ref.3)
REF4 Customer reference (Ref.4)
OWNER Cardholder's name
EMAIL E-mail address
ALIAS Alias
SCORING Scoring
SCO_CATEGORY Scoring category
FDMA_SCORING_CATEGORY FDMA Scoring category
EXPERT_SCORING_CATEGORY Fraud Expert Scoring Category
IPADDR Request's IP address
REC_IPADDR Received IP address
OPEDESC Reason for the operation
BINCARD Card BIN number
CARDUNIQUEID Card unique identifier
ORDERDATETIME Payment dd/mm/yyy hh:mm:ss
PAYDATETIME Payment dd/mm/yyy hh:mm:ss
CREDITDEBIT Show credit/debit split information
DEVICE Device
TO_MOBILEMODE Mobile mode
XF_BIC BIC/Sort code
XF_MANDATEID Mandate ID
XF_SIGNDATE Sign date (yyyymmdd)
XF_SEQUENCETYPE Sequence type
EXPERT_DEVICEID Device ID
DFP_DEVICEID Displays the fingerprint of the device (computer, mobile,…) used in the transaction
DFP_RISK_LEVEL_CATEGORY The risk level associated with the device fingerprint. Format: 1=Low risk
2=Medium risk, suspicious
3=High risk
AS_FRAUD_TYPE Transactions that are classified as "dispute" by a merchant or an acquirer

The "WithDetail" flag can be selected on the "Electronic reporting" page.

3.4.1 Travel details

XML Tags Description
ID Payment reference (Details)
TINUM Ticket number
TIDATE Ticket Date
CONJTI Conjunction Ticket
PASNAME Passenger Name
ORCITY Departure Airport (Cod.)
DESTCITY Arrival Airport (Cod.)
ORCITYL Departure Airport
DESTCITYL Arrival Airport
CARRIER Carrier Code
BOOKIND Booking Indicator
FLNUM Flight Number
FLDATE Flight Date
CLASS Airline Class
STOPOV Stopover
VATAPPL VAT applicability
TYPCH Type of Charge
AIRTAX Airport Taxes
EYCD Destination area code
IRST Destination area code (Typ.)
CHDETL Charge Details

3.4.2 Merchant Assistant details

XML Tags Description
ID Payment reference (Details)
ITEMNO Item ID
ITEMNAME Item name
QUANTITY Quantity
UNITNETPRICE Item price (excl. VAT)
CUR Currency
LIDREF1 Item Reference (1)
LIDREF2 Item Reference (2)
LIDDISCOUNTRATE Discount
LIDNETAMT Price (excl. VAT)
LIDTAXRATE VAT rate (%)
LIDGROSSAMT Price (incl. VAT)

3.5 File Management

For the View files (selection page) and the Financial history (summary), please refer to the Standard structure.

Financial history, View transactions:

XML Tags Description
TOTAL Amount
CUR Currency
BRAND Card type
CARD Card number
EXPDATE Exp. date
REF Your file reference
NCID Transaction code (NCID)
ID Payment reference
STATUS File status
LIB Status description
ACCEPT Authorisation code from acquirer
PAYDATE Payment date
ACTION Last action (Financial history)
TICKET Virtual Ticket (Financial history)
PSPID PSPID (Only when connected as a Merchant Group user)
DESC Description

3.6 Format

Each record corresponds to a payment. The output formats are:

  • XML: Each field describing the payment is available as a property of the <PAYMENT> tag;
  • Fixed Length: each field has a fixed size as described in the various structures above.
  • Delimited along with a separator: Each field of a payment record is separated by the specified separator (T for tab-delimited). If a value contains the separator, it will be replaced with a space in the download field, in order to avoid mismatches.

3.7 Sort by

After selecting the structure and format, you can also group your payments according to the value of the selected fields. You can choose up to 3 fields to create groups and sub-groups on 3 levels.

3.8 Name and Format of Downloaded File

You can specify the name and the extension of the downloaded file. In the file name, you cannot use specials characters like [/ . \ : * ? | < > "]

You can include dynamic parameters in the filename:

  • [DATE] for the previous date of the processed file
  • [FILEDATE] for the date of the processed file
  • [TIME] for the time of the processed file

Example: File[DATE]_[TIME] will be converted to File20111025_16134.

In the extension field, you can use any file extension with 3 characters. Specifying * in this field means that the extension will be derived from the file format:

  • '.xml' for XML
  • '.csv' for semicolon delimited values
  • '.txt' for Fixed-length or tab-delimited

3.9 Additional options

  • Header box: to make your data more readable or 'no headers' to keep only the relevant data.
  • Decimal Separator: to use in the download format [, or .].
  • With column header: to have the name (i.e. the XML Tag name) of each field on the line before the first payment (only applicable for FIX and DEL formats).
  • With Details: for merchants with Travel, Merchant Assistant or Purchasing details (only applicable for DYN format).

4. Data dictionary

Fields are sorted in ascending XML tags; for the field position; refer to Structure.

XML Tags
AAVCHECK Automatic Address Validity Check
ACCEPT Authorisation code from acquirer
ACTION Last action
AIRTAX Airport taxes
ALIAS Alias
BATCHREF Batch reference
BOOKIND Booking indicator
BRAND Card type
CARD Card number
CARRIER Carrier code
CCCTY Card-issuing country
CHDETL Charge details
CIE Company
CLASS Airline class
CLIENTID ClientID
CONJTI Conjunction ticket
COUNTRY Buyer's invoicing country
CUR Currency
CVCCHECK Card Validity Code Check
DATE File date
DELCOUNTRY Delivery country
DELNAME1 Delivery name, line 1
DELNAME2 Delivery name, line 2
DELSTREET1 Delivery address, line 1
DELSTREET2 Delivery address, line 2
DELTOWN Delivery city
DELZIP Delivery postcode (ZIP)
DESC Description
DESTCITY Arrival Airport (Cod.)
DESTCITYL Arrival Airport
ECI Electronic Commerce Indicator (Origin of the transaction (ECI)).
EMAIL Email address
EXP Exp. date
EXPDATE Expiry date (mm/yyyy)
EYCD Destination area code
FACNAME1 Invoicing name, line 1
FACNAME2 Invoicing name, line 2
FACSTREET1 Invoicing address, line 1
FACSTREET2 Invoicing address, line 2
FACTOWN Invoicing city
FACZIP Invoicing postcode (ZIP)
FILEID Transaction uploaded via file
FLDATE Flight date
FLNUM Flight number
ID Payment reference (detail)
ID Payment reference
IPCTY IP address country
IRST Destination area code (Typ.)
ITEMNAME Item name
ITEMNO Item ID
LIB Status description
LIDDISCOUNTRATE Discount
LIDGROSSAMT Price (incl. VAT)
LIDNETAMT Price (excl. VAT)
LIDREF1 Item reference (1)
LIDREF2 Item reference (2)
LIDTAXRATE VAT rate (%)
MERCHREF Merchant's reference
METHOD Payment methods
NBPAY Number of transactions
NCID Transaction code (NCID)
NCSTER Transaction state
OPERATION File Operation
ORCITY Departure Airport (Cod.)
ORCITYL Departure Airport
ORDER Order date
OWNER Cardholder name
PASNAME Passenger name
PAYDATE Payment date
PSPID PSPID
QUANTITY Quantity
REF Merchant's reference
REF Your file reference
REF1 Customer reference (Ref.1)
REF2 Customer reference (Ref.2)
REF3 Customer reference (Ref.3)
REF4 Customer reference (Ref.4)
REFID Entity
REFKIND Entity type
SCORING Scoring
SCO_CATEGORY Scoring category
SHIP Delivery costs
STATUS File status
STATUS Status
STOPOV Stopover
STRUCT Structured communication
TAX Taxes
TICKET Virtual Ticket
TIDATE Ticket date
TINUM Ticket number
TOTAL Amount
TRANSACTION Transaction code
TYPCH Type of charge
UID UID
UNITNETPRICE Item price (excl. VAT)
USERID User
VATAPPL VAT applicability
VC Virtual Card type

FAQs

In your ePDQ account menu, you can easily lookup your transactions by choosing "Operations" and then clicking either "View transactions" or "Financial history", depending on the type of transaction results you're looking for.

Go to Consult your transactions for more information.

By default you can send goods or deliver your service once a transaction has reached the status "9 - Payment requested". However, although status 5 is a successful status, it's only a temporary reservation of an amount of money on the customer's card. A transaction in status 5 still needs to be confirmed (manually or automatically) to proceed to the status 9, which is the final successful status for most payment methods.

Go to Transaction statuses for more information.

You can easily refund a payment with the "Refund" button in the order overview of a transaction (via View transactions). If your account supports it, you can also make refunds with a DirectLink request or with a Batch file upload (for multiple transactions).

Please note that the Refunds option has to be enabled in your account.

Go to Maintain your transactions for more information.

A full green thumbs-up icon means that the transaction was completed with a 3-D Secure authentication method, such as Digipass or a card reader. However, it doesn't necessarily mean the payment itself was processed successfully. Therefore, you should always check the transaction status to know whether you'll receive your money.

Go to Transaction statuses for more information.

If you want to check specific details of an order/transaction or perform maintenance on transactions, you should use View transactions. "Financial history" is the most convenient to periodically check incoming and outgoing funds.

For more information, go to View transactions vs Financial history.

You can only perform refunds on transactions for which the funds have already been transferred to your bank account. A cancellation or deletion can be done before a payment has been fully processed, i.e. before the daily cut-off time at the acquirer, at which point all transactions of the previous day are processed.