channel.updated

Fire emits this event when a channel’s configuration changes — name, status, authentication type, or base URL. Your system should update its local channel mapping and re-fetch the channel list if it caches it.

Payload

{
  "event": {
    "id": "evt_abc200",
    "type": "channel.updated",
    "createdAt": "2025-01-20T15:30:00Z",
    "timezone": "America/Guayaquil"
  },
  "data": {
    "account": "1",
    "country": "6",
    "vendorId": 16,
    "channel": {
      "channelId": "CH-IFOOD-001",
      "code": "IFOOD",
      "name": "iFood",
      "description": "Orders received via iFood marketplace",
      "active": "ACTIVE",
      "authType": "API_KEY",
      "baseUrl": "https://api.ifood.com.br",
      "services": [
        {
          "code": "DELIVERY",
          "serviceId": "3",
          "referenceName": "Domicilios iFood"
        },
        {
          "code": "TAKEAWAY",
          "serviceId": "1",
          "referenceName": "Retiro en tienda"
        }
      ],
      "createdAt": "2025-01-15T10:00:00.000Z",
      "updatedAt": "2025-01-20T15:30:00.000Z"
    }
  }
}

Fields

`data`

Field	Type	Description
`account`	string	Account identifier — required by downstream systems
`country`	string	Country identifier — required by downstream systems
`vendorId`	integer	Brand identifier
`channel`	object	Updated channel object — see below

`data.channel`

Field	Type	Description
`channelId`	string	Unique channel identifier
`code`	string	Short code for the channel (e.g. `IFOOD`, `RAPPI`, `KIOSK`)
`name`	string	Display name
`description`	string \| null	Optional description
`active`	string	Channel status: `ACTIVE` or `INACTIVE`
`authType`	string	Authentication mechanism: `API_KEY`, `OAUTH2`, `BASIC_AUTH`, `XMART_LOGIN`, or `NONE`
`baseUrl`	string \| null	Base URL for the channel’s integration endpoint
`services`	object[]	Services available through this channel
`createdAt`	string	ISO 8601 creation timestamp
`updatedAt`	string	ISO 8601 last-updated timestamp

`data.channel.services[n]`

Field	Type	Description
`code`	string	Service type code (e.g. `DELIVERY`, `TAKEAWAY`)
`serviceId`	string	Unique service identifier
`referenceName`	string	Human-readable service name for this channel

Usage

Verify the signature

Validate X-Fire-Signature. See Authentication.

Acknowledge immediately

Return 200 OK before processing.

Update your channel mapping

Upsert the channel in your local store using channelId as the key. If the channel transitions to INACTIVE, stop routing events or orders to it.

Overview

Channel

Store

Menu

Product

Order

Payment methods

Payload

Fields

`data`

`data.channel`

`data.channel.services[n]`

Usage

​Payload

​Fields

​data

​data.channel

​data.channel.services[n]

​Usage

Payload

Fields

`data`

`data.channel`

`data.channel.services[n]`

Usage