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).
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 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. |