Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The TIXNGO Backoffice is a management console for every organizer. It allows to inject, monitor , monitor and edit tickets, events, transactions, spectators and custom app settings. It is accessible at https://consolebackoffice.tixngo.io where  where organizers can sign in with their account, or create a new one.
This documentation is here to help support teams get a hold of this console.

...

  • Update the event's information

    Variable NameVariable TypeValue lengthVariable usage/description
    Event Namestring128 charName of the match
    Website URLstring128 charIf specified then clickable URL displayed at the Ticket Detailed View
    Event Group Image URLstring256 charDisplay image as per URL on following ticket views: My Tickets - "Group Image"
    string128 charDisplay name on following view: My Tickets - Event Group Name
    Ribbon Display Timestringmust follow RFC 3339 date formatTime at which a ribbon is displayed on the mobile app to notify spectator to turn on Bluetooth. This Ribbon Display Time is not converted in local browser time as we must set here the Time Zone
    Start Timestringmust follow RFC 3339 date formatDisplays Match date and kick-off time at the Ticket View and Ticket Detailed View. This Start Time is not converted in local browser time as we must set here the Time Zone
    Expiration datestringmust follow RFC 3339 date formatNot displayed, this is the Time at which the Event Expires. This Expiration Time is not converted in local browser time as we must set here the Time Zone
    Time Zoneoffsetmust follow RFC 3339 date formatTime Zone offset for Start Time, Expiration Time & Activation Time of the Event
    Sitestring200 charSite name displayed at the Ticket View and Ticket Detailed View under Address title
    Citycity200 charCity where the event takes place
    Line 1string200 charline 1 of the address
    Line 2string200 charline 2 of the address
    Line 3string200 charline 3 of the address
    Country Codestring200 charcountry code for the address
    Regionstring200 charregion of the event
    Zipstring200 charzip code for the address
    Longitudenumberfloatlongitude of the event's location
    Latitudenumberfloatlatitude of the event's location
    Mobile App Idstring256 charUsed as a key to display tickets only for the particular Event
    Ticket Image URLstring256 charDisplay image as per URL on following ticket views: Ticket View, Ticket Detailed View
    Remove Ticket Image URLBooleanBooleanEnable the deletion of all tickets image URLs in that event.
    Transfer Group Idstring256 charTransfer rules can technically be different for every ticket. Organizer might want to chose to have different transfer rules for different types of ticket (ex: Adult, child, VIP, etc…). This GroupID is the Transfer rules group ID representing a group of transfer rules applied to certain tickets. If Organizers want to apply the same rules to every tickets, by default this groupID is set to the EventID and every ticket will be in this group.
    Max number of Ticket per receiver's PhoneintegerintegerMaximum amount of tickets per phone for this Transfer rules group id
    Max Resell Price increase (in %)integersmallint

    Maximum profit (price increase in %) of the original ticket price for a resell between spectator.

    It is editable or used only if organizer resale setting is enabled

    Max number transfer per PhoneintegerintegerTotal amount of transfers per Phone (-1 feature is disabled). Counter is increased for every new transfer, but decrease on a Return.
    Max number transfer per TicketintegerintegerTotal amount of transfers per Ticket (-1 feature is disabled). Counter is increased for every new transfer, but decrease on a Return.
    Assign LimitintegerintegerUpper bound amount of transfer before the Assign function is disable (-1 means unlimited)
    Allow TransferBooleanBooleanEnables or Disables transfer functionality for given match (Send menu item in the ticket view hidden or displayed)
    Allow Transfer after ActivationBooleanBooleanEnables or Disables transfer functionality for given match for Activated Tickets (Send menu item in the ticket view hidden or displayed)
    Allow Transfer after ControlBooleanBooleanEnables or Disables transfer functionality for given match for Controlled Tickets (Send menu item in the ticket view hidden or displayed)
    Allow Return To OrganizerBooleanBooleanEnables or Disable allow everyone to release ticket to resale. (More Details)
    Allow Return To Organizer For Initial SpectatorBooleanBooleanEnables or Disable only Initial Spectator can release ticket to resale.
    Resale Group Idstring256 char

    Resale rules can technically be different for every ticket. Organizer might want to chose to have different resale rules for different types of ticket (ex: Adult, child, VIP, etc…). This GroupID is the Resale rules group ID representing a group of resale rules applied to certain tickets. If Organizers want to apply the same rules to every tickets, by default this groupID is set to the EventID and every ticket will be in this group.

    It is editable or used only if organizer resale setting is enabled

    Allow ResellBooleanBoolean

    Enables or Disables resale functionality for given match for all Tickets (Send menu item in the ticket view hidden or displayed)

    It is editable or used only if organizer resale setting is enabled

    Allow Resell after ActivationBooleanBoolean

    Enables or Disables resale functionality for given match for ActivatedTickets (Send menu item in the ticket view hidden or displayed)

    It is editable or used only if organizer resale setting is enabled

    Keep one Ticket OverallBooleanBooleanForce ALL ticket wallet holders to keep at least 1 ticket per given Match
    Keep one Ticket at InjectionBooleanBooleanForce ticket wallet holder to whom tickets were originally injected to keep at least 1 ticket per given Match. E.g. all his transfer guests will be able to forward all the tickets they received
    The Resale & Purchase Agreement URLstring512 char

    The Resale & Purchase Agreement URL in P2P resale

    It is editable or used only if organizer resale setting is enabled

    Ticket Terms & Conditions URLstring512 charTicket Terms & Conditions URL in P2P resale
    Resale Optionsstring100 char

    Support organizer define the resale price with three options A, B and C per Transfer Group Id:

    • "Option A: Price range" [the resale price of this ticket is allowed by the event organizer to be resold between a minimum and a maximum]
    • "Option B: Fixed price" [the resale price of this ticket is set by the event organizer]
    • "Option C: Unlimited price" [the resale price of this ticket is allowed by the event organizer to be resold at any price]

    It is editable or used only if organizer resale setting is enabled

    Min resale price decrease numberfloat

    Enable when Resale option A is selected. Min resale price decrease (in % of the initial price) of the ticket to be resold

    It is editable or used only if organizer resale setting is enabled

    Max resale price increasenumberfloat

    Enable when Resale option A is selected. Max resale price Increase (in % of the initial price) of the ticket to be resold

    It is editable or used only if organizer resale setting is enabled

    Specific resale price decrease/increase numberfloat

    Enable when Resale option B is selected. Specific resale price decrease/increase (in % of the initial price) of the ticket to be resold:

    • Value > 0: Increase
    • Value < 0: Decrease

    It is editable or used only if organizer resale setting is enabled

    Activation Idstring50 charActivation group ID. Different tickets could have different activation method, this group ID make the distinction between them.
    Activation Timestringmust follow RFC 3339 date formatTimestamp at which the tickets in the activation ID will be activated (following the given Activation Method). This Start Time is not converted in local browser time as we must set here the Time Zone
    Activation Methodstringonline/offlineDefine ticket activation method for this activation ID, can be online or offline. (Used only if a timestamp is given in Activation Time
    Barcode Sizestringkey = 128 char; value = 128 charUsed to adjust QR code size in mm. Reflects both width and height. The value must between 10 and 32 (10 <= barcode size <= 32).
    Barcode Positionstringkey = 128 char; value = 128 charUsed to adjust QR code position in case if QR code size smaller that smartphone screen width (center, left, right)
    Event Numbernumber0 <= number <= 99Display Event Number on mobile ticket if required
    Enable Covid CheckBooleanBooleanEnables or Disable COVID check functionality for given event
    TicketShop Resale URLstringkey = 128 char; value = 128 char

    The URL of TicketShop resale


    Prohibited Items Image URLstringkey = 128 char; value = 128 charDisplay Prohibited items image from this URL
    Prohibited Items Linkstringkey = 128 char; value = 128 charMakes Prohibited Items Image clickable when redirecting to this link (must provide Image URL)
    Sponsors Image URLstringkey = 128 char; value = 128 charDisplay Sponsor image from this URL
    Sponsors Linkstringkey = 128 char; value = 128 char

    Makes Sponsors Image clickable redirecting to this link (must provide Image URL)

    Seat Map Image URLstringkey = 128 char; value = 128 charDisplay Seat Map image from this URL
    Seat Map Linkstringkey = 128 char; value = 128 charMake Seat Map Image clickable redirecting to this link (must provide Image URL)
    Design Idstring256 charThis Design Id representing a design applied to certain tickets in an Event
    Background Colorstring7 char hexadecimal color

    The background color of the corresponding Design Id (Example: #bbccdd). If the background color is updated, all the tickets with the corresponding Design Id will be affected

    Ticket Resale Fixed Feenumberfloat

    For organizer could set amount fee for ticket of P2P resale

    It is editable or used only if organizer resale setting is enabled

    Ticket Resale Percent Feenumberfloat

    For organizer could set fee percent for ticket (calculating on resale price) of P2P resale

    It is editable or used only if organizer resale setting is enabled

    Fee Currencystring3 char

    For organizer could set currency of fee for ticket of P2P resale

    It is editable or used only if organizer resale setting is enabled


  • See the security information (manual activation pin & Bluetooth instance ID for all activation groups)
  • Create/Delete/Edit Questionnaires that can be send to every spectator attending the event.

...

Variable NameVariable DescriptionBackend Key
Burger Menu: Item 1 VisibilityValues: ACTIVE, INACTIVE; control whether the link to external website is shown in the menu. Order of the link in the burger menu is fixed.promo.external.menu.displayed
Burger Menu: Item 2 VisibilityValues: ACTIVE, INACTIVE; control whether the link to another app is shown in the menu. Order of the link in the burger menu is fixed.promo.otherapp.menu.displayed
Event List: Promo 1 PositionValues: INACTIVE, TOP, AFTER_FIRST, BOTTOM; controls where the External Portal/Website link box is shown in the event list view of the app.promo.external.event.position
Event List: Promo 2 PositionValues: INACTIVE, TOP, AFTER_FIRST, BOTTOM; controls where the other app link box is shown in the event list view of the app.promo.otherapp.event.position
Event List: Promo 1 Image URLLink of the image that will be displayed in the box related to the external websitepromo.external.image
Event List: Promo 2 Image URLLink of the image that will be displayed in the box related to the otherapppromo.otherapp.image
Relative position between Events List Promo 1 and Promo 2Values: OTHERAPP_FIRST, WEBSITE_FIRST; controls the order when both are put in the same locationpromo.external.other.prioritized.position
Ticket detail key that displayed on activation screenValues: ticket details main or extra key  which define by organizer (eg. Gate, Block, Row, Seat,...) which is used to display on activation screendesign.activation.ticket-details-key
Number of minutes before sending a non-transferred reminder in the app

Values: Integer > 0 ,
Pop-up message in app for transferring ticket reminder (RBL). Value indicates the interval between 2 pop-ups. 

ticket.non-transferred.reminder
Number of minutes before sending a non-assigned reminder in the appValues: Integer > 0
Pop-up message in app for assigning ticket reminder (FIFA). Value indicates the interval between 2 pop-ups.
ticket.non-assigned.reminder
Ticket Owner Transfer Alert Keys

Values: List of ticket details main or extra key  which define by organizer (eg. Gate, Block, Row, Seat,...) which is used to notify ticket owner transfer tickets

(Dependent with ticket.owner.transfer.alerts feature and ticket.owner.transfer.alert.hour )

ticket.owner.transfer.alerts-keys
Enable max amount of active devices securityValues: FALSE, TRUE; disable or enable the max active phones security.security.session.use-max-active-phone
Max number of active devices at once (only if security is enabled)Values: Integer >0
(For login restriction security purpose)
security.session.max-active-phone
Only one active wallet session is allowed

Values: FALSE, TRUE; disable or enable the allowing only one session. 

(For login restriction security purpose)

There are no differences between “Only one active wallet session is allowed” and “Max number of active devices at once (only if security is enabled)” = 1.
It would implies the same behavior. The first one was the first to be implemented. The second one at a later stage.

security.session.only-allow-one
Disable online/offline check if device reached max active sessions

Values: FALSE, TRUE; disable or enable the online check if device readed max active sesssions.

(For login restriction security purpose)

security.session.disable-online-check
Minimal supported version of mobile application

Values: (with X, Y, Z are Integers and X is required)

Oldest version of the app that requires user to install. 

Using for force update purpose: the organizer can decide to request to have a minimal version of the TIXnGO wallet to be used. So the app will show you a informative screen to ask you to update the app (cannot do anything else in the app).

mobile.version.minimal
Latest version of mobile application

Values: (with X, Y, Z are Integers and X is required)

Latest version of the app that requires user to install. (Should always same or later than minimal one)

There are no features implemented yet related to this one. An example of a potential feature, you might be interested and asked us to develop, would be a new feature to display a pop-up in the app informing a new version is available

mobile.version.latest
Number of hours before event start time sending different-gates/blocks first message in the app

Values: Integer > 0

Pop-up message in app for transferring ticket reminder. 
Value indicates the number of hours between 1st pop-up and event start time. 

(Dependent with  ticket.owner.transfer.alerts and ticket.owner.transfer.alerts-keys )

In case you have tickets for different block/gates. This is for pop-up message. Organizer need to enable and define these keys to be able to use this feature:

      • ticket.owner.transfer.alerts (enable the feature on mobile)
      • ticket.owner.transfer.alerts-keys (Define the key to compare)
ticket.owner.transfer.alert.hour
Number of minutes before sending different-gates/blocks reminder in the app

Values: Integer > 0

Pop-up message in app for different-gates/blocks reminder , value indicates the interval between 2 pop-ups. Number of minutes before sending different-gates/blocks reminder in the app

    • In case you have tickets for different block/gates. This is pop-up message. Indicates the interval between 2 pop-ups.
    • Same as above, organizer need to enable and define these keys to be able to use the feature:
      • ticket.owner.transfer.alerts (enable the feature on mobile)
      • ticket.owner.transfer.alerts-keys (Define the key to compare)
      • ticket.owner.transfer.alert.hour (Define the first pop-up time)
ticket.owner.transfer.alert.interval
Amount of days after which the unregistered personal information got anonymized (Set 0 to disable)

Values: Integer > 0

Unregistered emails will be anonymized after this amount of day since the ticket's event expired.

personal.information.anonymize.delay

...

Variable NameVariable DescriptionBackend Key
Assign Holder FeatureEnable / Disable assign-holder feature, allowing spectator to assign a ticket to a Holderassign-holder
Bluetooth FeatureEnable / Disable Bluetooth feature, allowing preparation beacon behavior (Only allow ribbon (what is ribbon? How to see colored information ribbons) and reminder "activate Bluetooth" to be showed, Bluetooth Scanner always enable to scan tickets even this feature is enable or not, even on match day or not)use-bluetooth
Display Ticket Owner FeatureEnable / Disable display-owner feature, allowing Owner name to be displayed on the ticketdesign.display-owner
Assign Reason FeatureEnable / Disable assign-reason feature, allowing spectator to give a reason when assigning a ticket to a Holderuse-assign-reason
Transfer Reason FeatureEnable / Disable trasnfer-reason feature, forcing spectator to give a reason when transferring a tickettransfer-reason
Mandatory Assign ReasonEnable / Disable assign-reason feature, forcing spectator to give a reason when assigning a ticket to a Holdermandatory-assign-reason
Select language when transferring ticketEnable / Disable transfer-language feature, allowing spectator to select language of email template when transferring tickettransfer-language
Deleted Tickets VisibilityEnable / Disable deleted-tickets-visibility feature, displaying deleted tickets on mobile applicationdeleted-tickets-visibility
Wristband Activation FeatureEnable / Disable wristband-activation feature, allowing organizer to activate tickets have wristband option (e.g. hospitability room)wristband-activation
Transfer alert for ticket owner has multiple tickets in different locations

Enable / Disable ticket.owner.transfer.alerts feature, allowing organizer to notify for ticket owner has multiple tickets in different locations to transfer tickets. 

(Dependent with ticket.owner.transfer.alerts-keys and ticket.owner.transfer.alert.hour)

ticket.owner.transfer.alerts

...

Variable NameVariable DescriptionBackend Key
Max number of reminder emails that can be sent

Values: Integer [0, 5] (maximum of 5 reminders per person

Type: email

email.reminder.limit.max-number
Minimum interval between two reminder in hours

Values: Integer >= 12 (limits to a maximum of 1 email every 12h, hence 2 per day max)

Type: email

email.remidner.limit.min-interval
Time of the day to send the first reminder

Values: Integer [0, 23] representing hours of the day

Type: email

email.reminder.limit.time-first
Number of days before the Event, to start sending reminders

Values: Integer >= 0

Type: email

email.reminder.limit.days-first
Amount of time (hour) after which the pending transfers will be canceled (Set 0 to not auto-cancel pending transfers)

Values: Integer >= 0

Value indicates the number of hours before auto-cancel is triggered (Value = 0 : no auto-cancel)

ticket.approval.cancel.delay
Consolidate tickets purchased in one single email - timeframe (X hour)
  • Value: Integer (hour) Default value = 0, which mean this feature is not Enable.
  • The user should only receive one email for his first injected purchased ticket.
  • The system shall block any purchase emails for X hours after the first sending of email for each ticket holder (counting separately for each ticket holder).
  • If the X (hours) time is past, those emails that are generated in X time will never be sent.
email.ticket.invitation.nextreceiveperiodtime
Amount of days after which the unregistered personal information got anonymized (Set 0 to disable)
  • Automatic anonymization processing X days after the event ended
  • Set 0 to not auto anonymize unregistered users
  • Automatic anonymization processing X days after the event ended, X get from the configuration
    • run every night (ex: 1:00 am server time)
  • Value: interger >= 0
personal.information.anonymize.delay

...