This function retrieves information from TIXnGO about the ticket (status, holder) and stores it inside SecuTix.
With the lifecycle implementation, we aligned the statuses and the screens between TIXNGO and S-360 and synchronize the tickets from a "business" perspective
How does it work?
The "Retrieve ticket status from TIXnGO", also known as "Feedback interface" retrieves information from TIXnGO about the ticket holder and stores it inside S-360.
Only the batch size not already handled tickets are retrieved from TIXnGO.
Only one function "retrieve ticket status from TIXnGO" must run for a given organizer, regardless if tickets are injected from multiple organizations.
Recommended frequency
Every 5 minutes.
Pagination key
Do not touch this value if you do not know what you are doing.
Skip ticket
A non-mandatory parameter in which you can add all the ticket IDs that you want to skip.
Batch size
Recommended value: 1000
Ticket statuses
History mode (legacy behaviour)
- Possible Statuses (tixngo.legacyStatus) : INJECTED, RECEIVED, ACTIVATED, TRANSFER_PENDING, TRANSFERRED, CONTROLLED, DELETION_PENDING, DELETED
- Possible Actions : INJECT, TRANSFER, DELETE, BURN
- Possible States : PENDING, CONFIRMED, KO, DELETION_PENDING, DELETED, REGISTRATION_PENDING, CANCELLED, FAILED
Lifecycle mode (new behaviour)
- Possible Statuses : INJECTED, DOWNLOADED, ASSIGNED, CONTROLLED, PENDING_TRANSFER, FAILURE_TRANSFER, TRANSFERRED, BT_ACTIVATED, MANUAL_ACTIVATED, OFFLINE_ACTIVATED, ONLINE_ACTIVATED, DELETION_PENDING, DELETED, ACTIVATED, DEACTIVATED, DEFAULT, INVALID, PENDING, FAILURE
- Possible Actions & States : Does not exist anymore. Replaced by Business Statuses
S360 Ticket Status | S360 Blockchain Status (lifecycle) |
---|---|
Not printed | NA |
Printed | (after injection) INJECTED |
(after download) DOWNLOADED | |
(after assignment) ASSIGNED | |
(after transfer initiated) PENDING_TRANFER | |
(after transfer cancelled by sender) FAILURE_TRANSFER (after transfer rejected by receiver) FAILURE_TRANSFER | |
(after transfer accepted) TRANSFERRED | |
(after ticket activation) XXX_ACTIVATED (OFFLINE_ACTIVATED, ONLINE_ACTIVATED, MANUAL_ACTIVATED, BT_ACTIVATED) | |
Controlled → ACS control | (after control before feedback from TIXNGO) XYZ_ACTIVATED where XYZ is the activation method used (after control and feedback from TIXNGO) CONTROLLED |
Invalidated → Reprint ticket → Post ticket on resale | If the ticket was already existing in TIXNGO ...
If the ticket was never sent to TIXNGO → NA |
Cancelled → Cancel ticket (manually or by batch) | If the ticket was already existing in TIXNGO ...
If the ticket was never sent to TIXNGO → NA |
What and how we synchronize ticket details ?
Each mode has a specific mapping.
Last update | Mapping Document | Change log |
---|---|---|
03 Apr 2023 | FIFASTX-2770_S360-TNG_Mapping_WIP.xlsx | |
07 Feb 2023 | ||
07 Oct 2022 | Lifecycle implementation |
How to configure the interface ?
In the custom parameters, to enable the lifecycle mode, you can use TIXNGO_LIFECYCLE_MODE=lifecycle.
By default, if not specified, the history mode will be used.
DEPRECATED
With the history mode (legacy behaviour), we synchronize the tickets from a "blockchain transaction" perspective
History mode (legacy behaviour)
- Possible Statuses (tixngo.legacyStatus) : INJECTED, RECEIVED, ACTIVATED, TRANSFER_PENDING, TRANSFERRED, CONTROLLED, DELETION_PENDING, DELETED
- Possible Actions : INJECT, TRANSFER, DELETE, BURN
- Possible States : PENDING, CONFIRMED, KO, DELETION_PENDING, DELETED, REGISTRATION_PENDING, CANCELLED, FAILED
S360 Ticket Status | S360 Blockchain Status (history) |
---|---|
Not printed | NA |
Printed | (after injection) INJECTED |
(after download) RECEIVED | |
(after assignment) RECEIVED Holder/Assignee fields are set | |
(after transfer initiated) TRANSFER_PENDING | |
(after transfer cancelled by sender) RECEIVED ... or ... (after transfer rejected by receiver) RECEIVED | |
(after transfer accepted) TRANSFERRED Action/Status : Transfer/Confirmed | |
(after ticket activation) ACTIVATED | |
Controlled → ACS control | (after control BUT before feedback from TIXNGO) ACTIVATED |
Invalidated → Reprint ticket → Post ticket on resale | If the ticket was already existing in TIXNGO ...
If the ticket was never sent to TIXNGO → NA |
Cancelled → Cancel ticket (manually or by batch) | If the ticket was already existing in TIXNGO ...
If the ticket was never sent to TIXNGO → NA |