Ticket authorization

When a ticket has been created, this service can be used to authorize new transactions using that ticket

Description

Ticket authorize can be executed on all tickets.

File names
File typeFile 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).

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"
 

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 headerDescription

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.

 

 

Do you have a question or need help?
Follow us
DIBS Payment Services
Stockholm +46 (0)8-527 525 00
Göteborg +46 031-600 800
København +45 7020 3077
Oslo +47 21 55 44 00