Evento fee.plan.updated

Este evento só existe para contas com o produto Chargefy for Platforms habilitado. Nesse produto, uma plataforma opera pagamentos para suas organizações filhas.

Entregue somente aos endpoints com events_from: "platform". O campo top-level organization é a organização da sua plataforma, e data.object traz o plano completo já atualizado. O catálogo é compartilhado entre os modos: cada modo recebe o próprio evento, com o livemode correspondente. data.previous_attributes traz só os campos que mudaram, com o valor anterior. Taxas e tabela de juros são fixas e não mudam nesses eventos.

O que mudou	Campos em `previous_attributes`
Nome ou descrição	`name`, `description`
Plano padrão	`is_default`, nos dois planos envolvidos

Trocar o padrão não altera organizações existentes. O novo padrão é atribuído às próximas organizações criadas sem escolha explícita. Os exemplos abaixo são resumidos: rates mostra 5 das 62 condições do plano.

Nome ou descrição mudou

{
  "id": "evt_ATcoQzUpqQR1NhxP",
  "object": "event",
  "created_at": "2026-09-27T09:15:00Z",
  "data": {
    "object": {
      "id": "plan_k6F3mqMZ",
      "object": "fee_plan",
      "created_at": "2026-09-26T11:00:00Z",
      "description": "Condição para organizações com volume acima de R$ 50 mil por mês.",
      "fee_calculation_base": "chargeable",
      "installment_plan": "00349",
      "is_default": false,
      "livemode": true,
      "metadata": {},
      "name": "Parceiros",
      "prepaid": true,
      "rates": [
        {
          "id": "rate_c37t9vKz",
          "card_brand": null,
          "currency": "brl",
          "fee_rate": 0,
          "fixed_fee_amount": 299,
          "installments": 1,
          "payment_method_type": "boleto",
          "settlement_days": 6
        },
        {
          "id": "rate_rdGA7A7t",
          "card_brand": null,
          "currency": "brl",
          "fee_rate": 349,
          "fixed_fee_amount": 0,
          "installments": 1,
          "payment_method_type": "credit_card",
          "settlement_days": 30
        },
        {
          "id": "rate_NFt14sZ1",
          "card_brand": "visa",
          "currency": "brl",
          "fee_rate": 349,
          "fixed_fee_amount": 0,
          "installments": 1,
          "payment_method_type": "credit_card",
          "settlement_days": 30
        },
        {
          "id": "rate_hS1YBRdc",
          "card_brand": "visa",
          "currency": "brl",
          "fee_rate": 899,
          "fixed_fee_amount": 0,
          "installments": 12,
          "payment_method_type": "credit_card",
          "settlement_days": 30
        },
        {
          "id": "rate_Esu89U3d",
          "card_brand": null,
          "currency": "brl",
          "fee_rate": 0,
          "fixed_fee_amount": 79,
          "installments": 1,
          "payment_method_type": "pix",
          "settlement_days": 1
        }
      ],
      "updated_at": "2026-09-27T09:15:00Z"
    },
    "previous_attributes": {
      "description": null,
      "name": "Parceiros 2026"
    }
  },
  "livemode": true,
  "organization": "org_8JxLXKvSTSnHz7s8",
  "request": {
    "id": null
  },
  "type": "fee.plan.updated"
}

Plano padrão mudou

Ao escolher outro plano como padrão, você recebe dois eventos: um para o plano que passou a ser o padrão, com previous_attributes.is_default: false, e outro para o plano que deixou de ser, com previous_attributes.is_default: true. O exemplo mostra o primeiro.

{
  "id": "evt_rh8u4Vn5LM5GbQVn",
  "object": "event",
  "created_at": "2026-09-27T14:00:00Z",
  "data": {
    "object": {
      "id": "plan_k6F3mqMZ",
      "object": "fee_plan",
      "created_at": "2026-09-26T11:00:00Z",
      "description": "Condição para organizações com volume acima de R$ 50 mil por mês.",
      "fee_calculation_base": "chargeable",
      "installment_plan": "00349",
      "is_default": true,
      "livemode": true,
      "metadata": {},
      "name": "Parceiros",
      "prepaid": true,
      "rates": [
        {
          "id": "rate_c37t9vKz",
          "card_brand": null,
          "currency": "brl",
          "fee_rate": 0,
          "fixed_fee_amount": 299,
          "installments": 1,
          "payment_method_type": "boleto",
          "settlement_days": 6
        },
        {
          "id": "rate_rdGA7A7t",
          "card_brand": null,
          "currency": "brl",
          "fee_rate": 349,
          "fixed_fee_amount": 0,
          "installments": 1,
          "payment_method_type": "credit_card",
          "settlement_days": 30
        },
        {
          "id": "rate_4WHWa477",
          "card_brand": "visa",
          "currency": "brl",
          "fee_rate": 379,
          "fixed_fee_amount": 0,
          "installments": 1,
          "payment_method_type": "credit_card",
          "settlement_days": 30
        },
        {
          "id": "rate_hS1YBRdc",
          "card_brand": "visa",
          "currency": "brl",
          "fee_rate": 899,
          "fixed_fee_amount": 0,
          "installments": 12,
          "payment_method_type": "credit_card",
          "settlement_days": 30
        },
        {
          "id": "rate_Esu89U3d",
          "card_brand": null,
          "currency": "brl",
          "fee_rate": 0,
          "fixed_fee_amount": 79,
          "installments": 1,
          "payment_method_type": "pix",
          "settlement_days": 1
        }
      ],
      "updated_at": "2026-09-27T14:00:00Z"
    },
    "previous_attributes": {
      "installment_plan": "00349",
      "is_default": false
    }
  },
  "livemode": true,
  "organization": "org_8JxLXKvSTSnHz7s8",
  "request": {
    "id": null
  },
  "type": "fee.plan.updated"
}

Visão geral

Ativação de organizações

Planos de taxas

Marca e domínio próprio

Modelo de negócio

Evento fee.plan.updated

Nome ou descrição mudou

Plano padrão mudou

​Nome ou descrição mudou

​Plano padrão mudou

Nome ou descrição mudou

Plano padrão mudou