Ticket authorization - DIBS Technical Documentation

Description

Ticket authorize can be executed on all tickets.

File names

File type	File name syntax	File name example
Request file	ticket_authDDMMYY_NN.txt	ticket_auth311213_01.txt
Request run file	ticket_authDDMMYY_NN.run	ticket_auth311213_01.run
Response file	response_ticket_authDDMMYY_NN.txt	response_ticket_auth311213_01.txt
Response run file	response_ticket_authDDMMYY_NN.run	response_ticket_auth311213_01.run

The .txt file is in the csv file format.

Content fields

Header	Type	Mandatory
ticket	Integer	Yes
orderid	String	Yes
amount	Integer	Yes
currency	Integer	Yes
ticketorderid	String	No
test	String (“true” or ”false”)	No
addfee	String (“true” or ”false”)	No

Please note that the optional parameters are only available if the DIBS Header is used (see below).

Simple example

An example of simple file content:

123456789,"myOrderId1",100,208
123456790,"myOrderId2",200,978

Important: The end of each line must never contain any other whitespace characters than a linebreak.

In the simple response, the following fields will be returned:
ticket,status,transaction,orderid

Example:

967492995,0,1119080927,"myOrderId1"
967492995,0,1119080931,"myOrderId2"

Extended example

A more advanced example of a file, including a CSV header, may look like the following:

  
CsvHeader: true
NumberOfCsvRecords: 2
ReturnReason: true
ReturnActionCode: true
ReturnTotalAmount: true
ReturnFee: true
ReturnAcquirer: true
ReturnAuthorizationTime: true

“ticket”,”orderid”,”amount”,”currency”,”ticketorderid”,”test”,”addfee”
123456789,”myOrderId1”,100,208,”OriginalTicketOrderId”,”true”,”true”
123456790,”myOrderId2”,200,978,”OriginalTicketOrderId”,”true”,”false”

Response:

  
CsvHeader: true
NumberOfCsvRecords: 2
 
"ticket","resultcode","transact","orderid","acquirer","actioncode","authorizationtime","fee","reason","totalamount"
967492995,0,1119142857,myOrderId1,4,d100,2015-07-23T12:40:54,3,,103
967492995,0,1119142860,myOrderId2,4,d100,2015-07-23T12:40:55,6,,200

Header fields

The CSV header contains general information of the CSV table and information about the desired return information. Aside from below fields, the standard header fields are also available.

The following return information is available for ticket authorizations:

CSV header	Description
ReturnReason: true	If this header is set, then the response parameters will include the "reason".
ReturnActionCode: true	If this header is set, then the response parameters will include "actioncode".
ReturnTotalAmount: true	If this header is set, then the response parameters will include "totalamount", which includes the fee.
ReturnFee: true	If this header is set, then the response parameters will include "fee".
ReturnAcquirer: true	If this header is set, then the response parameters will include "acquirer", which contains an ID for the acquirer.
ReturnAuthorizationTime: true	If this header is set, then the response parameters will include "authorizationtime", which contains the authorization time stamp as registered at DIBS.