Receiving a PCN update

This page describes the Deprecated PCN system. It remains maintained for now but is scheduled removal. For all new implementations, please use the new PCN, documented here: [New] Product Change Notifications API

The payload that will be sent to your servers when products are modified or their sales are stopped/resumed.

ProductChangeNotification

Payload

application/json

product_idintegerRequiredExample: 313373

change_typesstring[]RequiredExample: checkout

reasonstring,null · enumOptionalExample: temporary_closurePossible values:

reopening_datestring,null · enumOptionalExample: within_7_daysPossible values:

alternative_product_idinteger | nullOptionalExample: 555789

Responses

200

Webhook successfully received and processed by the distributor.

No content

default

All non-200 responses (e.g., 4xx, 5xx) indicate failure and will trigger a retry using an exponential backoff mechanism.

Payload

{
  "product_id": 313373,
  "change_types": [
    "checkout"
  ],
  "reason": "temporary_closure",
  "reopening_date": "within_7_days",
  "alternative_product_id": 555789
}

Acknowledge the notification Return an HTTP 200 response to confirm successful delivery. If your server does not respond with a 200 status code, Tiqets will retry the notification using exponential backoff: after 20, 40, 80, 160, and 320 seconds.

Note: the response body is ignored; only the HTTP status code matters.