Secutix

Retrieve ticket URLs from Secutix file ID

get

https://app.neostore.cloudhttps://app-qa.neostore.cloud

/api/{tenantId}/external/secutix/orders/getTicketsUrl/{fileId}

Fetches ticket download URLs and metadata from Secutix system using a file identifier. Used for order fulfillment, ticket distribution, and mobile pass generation.

Use Cases

• Generate direct ticket download links for customers

• Create mobile wallet passes with ticket data

• Debug order fulfillment issues

• Support ticket resale and transfers

Authorization

Requires valid Secutix API credentials in tenant configuration

Required scopes

This endpoint requires the following scopes:

Authorizations

admin-bearerapiKey

OAuth2implicitRequired

Authorization URL:

Path parameters

fileIdinteger · int64Required

Secutix file identifier from order system

tenantIdstringRequired

Responses

200

Ticket URL resolved.

401

Unauthorized order access.

text/plainapplication/jsontext/json

404

Order not found for the provided file identifier.

text/plainapplication/jsontext/json

500

Unexpected server error.

get

/api/{tenantId}/external/secutix/orders/getTicketsUrl/{fileId}

HTTPcURLJavaScriptPython

GET /api/{tenantId}/external/secutix/orders/getTicketsUrl/{fileId} HTTP/1.1
Host: app.neostore.cloud
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

No content

Handle Secutix order state changes

post

https://app.neostore.cloudhttps://app-qa.neostore.cloud

/api/{tenantId}/webhooks/listeners/secutix/orders

Webhook endpoint called by Secutix when ticket orders change state (purchased, validated, refunded, etc.).

Order States

• PAID: Order completed, tickets ready

• CANCELLED: Order cancelled, refund processed

• VALIDATED: Ticket scanned/used at venue

• MODIFIED: Order details changed

Processing Flow

1. Secutix sends webhook immediately when order state changes

2. Endpoint validates request and schedules background task

3. Background task retrieves full order details from Secutix API

4. System creates/updates passes for tickets

5. Push notifications sent to customer devices

Background Processing

Tasks are queued with correlation IDs for:

• Retry handling on failures

• Deduplication of rapid-fire updates

• Performance monitoring

Use Cases

• Generate event tickets as wallet passes

• Update pass when ticket validated at gate

• Cancel passes for refunded orders

• Multi-ticket orders (family packages)

Path parameters

tenantIdstringRequired

Body

application/jsontext/jsonapplication/*+json

ticketIdinteger · nullableOptional

Ticket identifier from Secutix, when available.

saleMovementIdinteger · nullableOptional

Sale movement identifier from Secutix, when available.

orderSecretTokenstring · nullableRequired

Secret token identifying the order.

statestring · nullableRequired

Current state reported by Secutix (PAID, CANCELLED, VALIDATED, etc.).

lastUpdatestring · nullableRequired

Last update timestamp provided by Secutix.

Responses

200

Order change queued for processing.

400

Missing or invalid order token.

text/plainapplication/jsontext/json

500

Unexpected server error.

post

/api/{tenantId}/webhooks/listeners/secutix/orders

HTTPcURLJavaScriptPython

POST /api/{tenantId}/webhooks/listeners/secutix/orders HTTP/1.1
Host: app.neostore.cloud
Content-Type: application/json
Accept: */*
Content-Length: 94

{
  "ticketId": null,
  "saleMovementId": null,
  "orderSecretToken": null,
  "state": null,
  "lastUpdate": null
}

application/jsontext/jsonapplication/*+json

No content