Evento product.created

Evento `product.created`

Disparado quando um produto é criado via POST /v1/products. Use este evento para sincronizar o seu catálogo com a Chargefy assim que uma nova oferta nasce. O produto guarda o nome, descrição, imagem e recursos de marketing; os valores e regras de cobrança ficam nos objetos price associados. data.object carrega o product completo no mesmo formato de GET /v1/products/:id. Quando o produto é criado com prices[] inline, o payload inclui esses preços em data.object.prices. Quando nasce sem preço, default_price vem null e prices vem [].

Se o produto foi criado com preços inline, cada preço também pode gerar o seu próprio evento price.created. Processe os eventos de forma idempotente e trate product.created como a criação do container de catálogo.

Quando acontece

Situação	Como aparece no payload
Produto criado sem preço	`default_price: null` e `prices: []`.
Produto criado com preços inline	`prices[]` contém objetos `price` completos e `default_price` aponta para um deles.
Produto criado com recursos comerciais	`marketing_features`, `description`, `image_url` e `is_tax_applicable` refletem o estado inicial.
Produto criado com metadados	`metadata` ecoa o objeto enviado na criação.

Como processar

Registre o id do evento (evt_*) para processar o webhook de forma idempotente.
Use data.object.id (prod_*) como chave do produto no seu sistema.
Atualize o catálogo local usando o data.object completo, não apenas campos individuais.
Use default_price para saber qual preço deve ser selecionado por padrão em novas ofertas.
Use prices[] para popular cache inicial de preços, mas acompanhe o ciclo de vida dos preços pelos eventos price.*.
Use metadata para correlacionar o produto com SKUs ou referências internas do seu sistema.

Campos importantes

Campo	O que observar
`data.object.id`	ID do produto criado.
`default_price`	Preço padrão do produto, ou `null` quando ainda não existe preço padrão.
`prices`	Lista de preços criados junto com o produto. Pode vir vazia.
`is_active`	Produtos novos normalmente nascem ativos para novos fluxos de compra.
`is_tax_applicable`	Indica se o produto é tributável.
`marketing_features`	Recursos exibidos em superfícies de venda para o comprador.
`metadata`	Ecoa os metadados enviados na criação para correlação.
`organization`	Organização que originou o evento.

Variações de catálogo

Variação	O que muda
Sem preço inicial	O produto já existe, mas ainda não pode ser usado por fluxos que exigem um `price`. Crie preços depois via `POST /v1/prices`.
Com preço inicial	`prices[]` traz o preço completo, e `default_price` aponta para o preço escolhido.
Com vários preços	`prices[]` pode ter mais de um item; use `default_price` para identificar o principal.

Exemplo de payload

{
  "id": "evt_boXsjFBSPJW2MTMn",
  "object": "event",
  "created_at": "2026-05-16T14:09:27Z",
  "data": {
    "object": {
      "id": "prod_6MqLMx9aYWDJLY9r",
      "object": "product",
      "created_at": "2026-05-16T14:09:27Z",
      "default_price": "price_bXAuwFwRDGJXgutP",
      "description": "Acesso completo",
      "image_url": null,
      "is_active": true,
      "is_tax_applicable": true,
      "livemode": true,
      "marketing_features": [
        {
          "name": "Acesso ilimitado"
        }
      ],
      "metadata": {},
      "name": "Plano Pro",
      "prices": [
        {
          "id": "price_bXAuwFwRDGJXgutP",
          "object": "price",
          "created_at": "2026-05-16T14:09:27Z",
          "currency": "brl",
          "is_active": true,
          "livemode": true,
          "metadata": {},
          "name": "Mensal",
          "product": "prod_6MqLMx9aYWDJLY9r",
          "recurring": {
            "interval": "month",
            "interval_count": 1,
            "trial_period_days": null,
            "usage_type": "licensed"
          },
          "tax_behavior": "unspecified",
          "type": "recurring",
          "unit_amount": 9990,
          "updated_at": null
        }
      ],
      "updated_at": null
    }
  },
  "livemode": true,
  "organization": "org_V9vmB44LLDFUtQxR",
  "request": {
    "id": null
  },
  "type": "product.created"
}

Fundamentos da API

Objetos de sistema

Webhooks e eventos

SDKs

MCP

Evento product.created