A report contains information of the bunch and detailed information about each
transaction in it. You can make an agreement with DIBS so that you will be able to get the
request parameters which you provide to DIBS, printed out in the reports as well.
Downloading payment reports
The ftp payment reports are stored on DIBS’s FTP server, paymentreport.debitech.com,
at an account for each customer. We support all standard d FTP remote commands for
send/receive and delete.
To download the files you use an ftp client and connect to paymentreport.debitech.com and supply
your username and password given by DIBS. Be sure the encryption is set to
"Require explicit FTP over TLS" and use port 21443. DIBS uses passive port range 50000 to 51000.
After the files are downloaded you decrypt the files using a GPG program installed on
Using payment reports
The bunchreport.dtd file specifies what a payment report file, in XML format, looks like.
The dtd file is also stored at the ftp site in the publicfiles folder.
The file names for the payment reports are on Bxxxxxxxxyyyyyyyy.xml form where xxxxxxxx is
the shop id that you obtain from DIBS and yyyyyyyy is a serial number specific to each customer.
In the xml-file the dates are on yyyy-mm-dd form. Floating point number are on x.y form.
To verify that your system has not already read a report file you are advised to check that
there are no reports with the same id (the id field in the header) already in your system.
You should also check that the file is complete before you process it.
The number of transactions and the total amount in the header should be verified against the transactions.
File Format Specification
The file is in a straight-forward XML format. There are just a few node-levels in it.
The file format is described in detail below.
A file is built in the following structural way:
- 1 bunchreport root node
- 1 header node
- 1 or several transaction nodes
- 0, 1 or several parameter nodes
- The header node contains information common to all the transactions.
- A transaction node contains information about the transaction.
- A parameter node can provide extra information about the transaction.
An example of a file with only one transaction in it can be found below.
If there are no transactions to report about, then no file will be created and the
sequence number in the file name will remain just as it was.
|id||20||Integer||The id of the bunch.||Mandatory|
The day the file was
The total sum of all
The currency of all
transaction in this
The name of the
acquirer used. In
the case of the
Cekab is used, the
commission for the
Currently only used
for the acquirer
Currently only used
for the acquirernode
data in this field
about what kind of
cards was used for
the transactions. If
all the transactions
are made with
Diners cards, then
the text will be
way with Resurs
cards transactions –
“RESURS”. For all
field will not be
The number of
transactions in this
The type of the
number of the
number of the
The bankdate, i.e.
the date that the
bank made the
The date when
DIBS received the
request from you to
The amount of the
in minour units.
E.g. 1 SEK should
be given as 100.
The end-user's first
The end-user's last
Where the endusers
There are no fixed element
names to use. It is
completely optional to use
any parameters. The
merchant makes an
agreement with DIBS if they
want any parameters to show
up in this file and in that case
which. All the request
parameters that DIBS has
received from the merchant
can be used and some
systems parameters to.
Example could be invoiceNo.
<!--?xml version="1.0" encoding="ISO-8859-1" ?--> <bunchreport><header> <id> 1234 </id> <filecreationdate> 2016-01-02 </filecreationdate> <paymentdate> 2016-01-01 </paymentdate> <totalamount> 25900 </totalamount> <batchcurrency> SEK </batchcurrency> <acquirer> CEKAB </acquirer> <numberoftransactions> 1 </numberoftransactions></header> <transaction> <type> settlement </type> <referencenumber> 9992866 </referencenumber> <merchantreferencenumber> ButikensReferensnummer </merchantreferencenumber> </transaction> </bunchreport>