CSV Injection

Yes

string

Unique identifier of this ticket in the organizer's ticketing system (typically technical ID)

PLAY-12345678901234

Yes

string

Unique identifier of the event

PLAY-123456789012

Yes

string

Business, human readable, unique identifier of the ticket

12345678901

Yes

string

Code for access control that will rendered as a QRcode

123456789012345678901234

No

string

Name of the activation rule to use for this ticket. If not provided or not matching a rule associated with the event, will use the one named 'DEFAULT'.

DEFAULT

No

string

Name of the data collection rule to use for this ticket. If not provided or not matching a rule associated with the event, will use the one named 'DEFAULT'.

DEFAULT

No

string

Name of the design rule to use for this ticket. If not provided or not matching a rule associated with the event, will use the one named 'DEFAULT'.

DEFAULT

No

string

Name of the email rule to use for this ticket. If not provided or not matching a rule associated with the event, will use the one named 'DEFAULT'.

DEFAULT

No

string

Name of the usage rule to use for this ticket. If not provided or not matching a rule associated with the event, will use the one named 'DEFAULT'.

DEFAULT

Yes

string

Purchase reference number in the ticketing system.

1122

Yes

date time

Date follows RFC 3339 standard

Purchase date and time

2025-11-22T11:22:33.000Z

Yes

number

Price of the ticket

500

Yes

string

Currency following the ISO 4217 format

CHF

No

string

Unique identifier of the seat category corresponding to this ticket.

1234567890

No

string

Unique identifier of the contingent from which this ticket is coming.

1234567890

No

string

Unique identifier of the tariff applied to this purchase.

ADULT, CHILD

No

List

If it’s not empty, the key, and it’s value are required

Not recommend to use this setting key
please using V4 properties:

• seatingDetails.area

• seatingDetails.level

• seatingDetails.externalEntrance

• seatingDetails.gate

• seatingDetails.block

• seatingDetails.row

• seatingDetails.seat

to have better look & feel on Back-office

Open

No

List

If it’s not empty, the key, and it’s value are required

No

List

If it’s not empty, the key, and it’s value are required

Yes

Boolean

Set to true if the seating details below are available and can be displayed to the spectator on the ticket.

true

Yes

Boolean

True when the ticket gives access to a numbered seat.

true

With condition

Area to which the ticket gives access.

Condition: This field is required if value of seatingDetails.seated is true

Area 1

No

Level to which the ticket gives access.

1

No

Name of the external entrance the spectator should use to access the venue.

West

No

Name of the gate the spectator should use to access the venue.

A

No

Block to which the ticket gives access.

AA

No

When seated, row in which the seat is located.

2

With condition

Seat number

Condition: This field is required if value of seatingDetails.seated is true and seatingDetails.numbered is true

24Spectator's email

Yes

Spectator's first name

Jo

Yes

Spectator's last name

Doe

Yes

Spectator's email

jd@tixngo.io

Yes

Spectator's preferred language. In ISO 639-1 format.

en

No

Ticket holder data, optionnally submitted. If present, must provide at least firstName and lastName. All other values are saved as is and NOT validated against data collection rules

activationParameters.groupId

No

string

50 char

The activation group to which the ticket belongs to. Tickets sharing the same activation id will have the same activation method & decryption code.

activation-id

activationParameters.method

Yes

string

"online"/"offline"/"beacon"

The method using to activate the ticket. online : when activationTime is reached (backend clock), the backend activates the tickets and sends push notifications to trigger a GET /spectator/tickets on the app. offline: the mobile application activates the tickets when time is reaches (mobile clock).
Online requires the user to be online, Offline does not.
More on Ticket activation: 8- Understanding TIXNGO Activation flow

offline

activationParameters.time

No

string

Date follows RFC 3339 standard

If online is chosen, define the time at which the tickets are activated (decrypted).

2020-10-05T11:19:24+01:00 

activationParameters.instanceId

No

string

128 char

If offline is chosen, define the bluetooth instance id that the mobile app should listen to to get the decryption key.

image

No

string

256 char

The uri to the image that will be displayed to the user with its ticket. It must have a width:length ratio of X:Y (to be defined). (displayed on the "Ticket" view).

https://r.tixngo.io/tng/Concert%20Asset%20300x240.png

event.id

Yes

string

256 char

ID representing the event (unique).

event-id-101

event.address.site

Yes

string

200 char

Name of the site the Event will take place.

TIXNGO Stadium

event.address.line1

No

string

200 char

Address line 1

event.address.line2

No

string

200 char

Address line 2

event.address.line3

No

string

200 char

Address line 3

event.address.city

Yes

string

200 char

City where the event takes place

Lausanne

event.address.countryCode

No

string

200 char

Country code for the Address

CH, FR, DE, etc

event.address.region

No

string

200 char

Region where the Event takes place

Bavaria

event.address.zip

Yes

string

50 char

Zip code where the Event takes place

event.address.longitude

No

double

double

Longitude where the Event takes place

event.address.latitude

No

double

double

Latitude where the Event takes place

event.name

Yes

string

128 char

Name of the Event

“Team A vs Team B”

event.startTime

Yes

string

Date follows RFC 3339 standard

Time at which the event starts. Used for app logic such as reminders etc...

Date Format: 2022-12-12T16:11:00Z

2023-10-05T11:19:24+01:00 

event.expirationDate

No

string

Date follows RFC 3339 standard

Time at which the event expire. Expired event cannot be used anymore.

2023-10-06T11:19:24+01:00 

event.bluetoothPreparationRibbonDisplayTime

No

string

Date follows RFC 3339 standard

Time at which a ribbon displays on the mobile app to notify spectator turn on Bluetooth on the phone

2023-10-05T11:21:24+01:00

event.bluetoothPreparationRibbonEndTime

No

string

Date follows RFC 3339 standard

Time at which a ribbon disappear on the mobile app

2023-10-05T13:21:24+01:00

event.metadata

No

list

list of key-value metadata

Specific "key-value" fields provided to Organizer for special information about the event.
For now we handle the reserved keys below. You can override all those keys if you put them (same name, case sensitive) in the ticket details hidden section of the ticket.

 Reserved Keys :

• ^{BARCODE_SIZE: value = Size of the barcode display on the Ticket (16 < x < 32) [mm]}
  
  

• ^{BARCODE_POSITION: value = Position of the barcode on the Ticket (LEFT, CENTER, RIGHT)}

• ^{RESALE_TICKETSHOP_URL: value = URL of ticket shop that use to resale a ticket (must include http or https)}

• ^{CANCEL_RESALE_TICKETSHOP_URL: value = URL of ticket shop that use to cancel a ticket (must include http or https)}
  
  

• ^{prohibited_items_image: value = URL of the prohibited items image}

• ^{prohibited_items_link: value = URL of the prohibited items link}

• ^{sponsorImage: value = URL of the sponsors image}

• ^{sponsorLink: value = URL of the sponsors link}

• ^{seat_map_image: value = URL of the seat map image}

• seat_map_link: value = URL of the seat map link

• enable_covid_check: value = Enable or Disable COVID check functionality for given event

• ^{EVENT_NUMBER: value = number of the event}

[{"key": "BARCODE_POSITION", "value": "CENTER"},{"key": "CANCEL_RESALE_TICKETSHOP_URL", "value": "https://ticketshop.secutix.com/account/tickets?cancelResaleTicketId="}, {"key": "RESALE_TICKETSHOP_URL", "value": "https://ticketshop.secutix.com/account/resale/resellTickets?ticketIds="}]

event.group.id

No

string

256 char

Id of the Group. Every Event with this Group ID will be part of that Group.

GROUP-ID-101

event.group.name

No

string

128 char

Name of the Group.

CHAMPION LEAGUE

event.group.image

Yes

string

256 char

The Image of the Group (displayed on the "My Events" view).

https://r.tixngo.io/tng/Concert%20Asset%20300x240.png

purchaseDetails.price