> ## Documentation Index > Fetch the complete documentation index at: https://docs.chargefy.io/llms.txt > Use this file to discover all available pages before exploring further. # Objeto fee_plan > Planos de taxas reutilizáveis da sua plataforma. Um `fee_plan` reúne as condições que sua plataforma cobra das organizações conectadas. Crie e edite os planos no painel; use a API para consultar as condições e atribuir um plano à organização. O catálogo comercial é compartilhado entre os modos teste e produção. `livemode` identifica o contexto da consulta ou do evento. Alterações feitas no painel valem para ambos os modos. ## Atribuição e padrão | Valor de `organization.fee_plan` | Comportamento | Exemplo | | -------------------------------- | ------------------------------------------- | ----------------------------------------------------------------------------------------- | | `"default"` | Segue continuamente o padrão da plataforma. | Ao trocar o padrão de Básico para Pro, a organização passa a usar Pro em novas cobranças. | | `"plan_Q7M4K9X2"` | Usa o plano escolhido explicitamente. | Trocar o padrão não altera essa organização. | Na criação de uma organização, omitir `fee_plan` equivale a `"default"`. Na atualização, omitir preserva a atribuição atual; enviar `"default"` restaura a herança. `null` é recusado. Enviar o ID do plano que hoje é padrão fixa esse plano, sem acompanhar futuras trocas do padrão. O ID do plano permanece igual quando suas taxas são editadas. As alterações valem para novas cobranças de todas as organizações atribuídas ao plano. Cobranças já criadas preservam as condições registradas. ## Taxas e recebimento `rates` contém 62 condições: 12 parcelas de crédito para cada uma das cinco curvas de bandeira, Pix e boleto. As taxas podem variar entre bandeiras. Em cartão, `card_brand: null` identifica as demais bandeiras aceitas; não substitui uma condição ausente de Visa, Mastercard, American Express ou Elo. `fee_rate` usa pontos-base: `399` significa **3,99%**. `fixed_fee_amount` usa centavos: `99` significa **R\$ 0,99**. `fee_calculation_base` indica se o percentual incide sobre a venda (`chargeable`) ou o total cobrado (`total`). `prepaid` e os `settlement_days` de cada condição são definidos pelo recebimento contratado e não podem ser editados no plano. No crédito, `prepaid: false` mantém o recebimento no fluxo das parcelas; `true` indica recebimento antecipado. Consulte ambos os campos: o prazo sozinho não define o fluxo de recebimento. ## Eventos `fee.plan.created` e `fee.plan.updated` são entregues aos endpoints de plataforma. Em uma troca de padrão, os planos anterior e atual recebem `fee.plan.updated` pela mudança de `is_default`. Organizações que seguem `"default"` continuam com a mesma atribuição e não recebem um `organization.updated` apenas por essa troca. A atribuição explícita de outro plano a uma organização gera `organization.updated`, com `previous_attributes.fee_plan`. ## Data Object ```json theme={"theme":"css-variables"} { "id": "plan_Q7M4K9X2", "object": "fee_plan", "created_at": "2026-09-26T10:00:00Z", "description": "Condições comerciais para organizações conectadas.", "fee_calculation_base": "chargeable", "is_active": true, "is_default": true, "livemode": true, "metadata": {}, "name": "Plano padrão", "prepaid": true, "rates": [ { "card_brand": null, "currency": "brl", "fee_rate": 0, "fixed_fee_amount": 349, "installments": 1, "payment_method_type": "boleto", "settlement_days": 6 }, { "card_brand": null, "currency": "brl", "fee_rate": 399, "fixed_fee_amount": 0, "installments": 1, "payment_method_type": "credit_card", "settlement_days": 30 }, { "card_brand": null, "currency": "brl", "fee_rate": 449, "fixed_fee_amount": 0, "installments": 2, "payment_method_type": "credit_card", "settlement_days": 30 }, { "card_brand": null, "currency": "brl", "fee_rate": 499, "fixed_fee_amount": 0, "installments": 3, "payment_method_type": "credit_card", "settlement_days": 30 }, { "card_brand": null, "currency": "brl", "fee_rate": 549, "fixed_fee_amount": 0, "installments": 4, "payment_method_type": "credit_card", "settlement_days": 30 }, { "card_brand": null, "currency": "brl", "fee_rate": 599, "fixed_fee_amount": 0, "installments": 5, "payment_method_type": "credit_card", "settlement_days": 30 }, { "card_brand": null, "currency": "brl", "fee_rate": 649, "fixed_fee_amount": 0, "installments": 6, "payment_method_type": "credit_card", "settlement_days": 30 }, { "card_brand": null, "currency": "brl", "fee_rate": 699, "fixed_fee_amount": 0, "installments": 7, "payment_method_type": "credit_card", "settlement_days": 30 }, { "card_brand": null, "currency": "brl", "fee_rate": 749, "fixed_fee_amount": 0, "installments": 8, "payment_method_type": "credit_card", "settlement_days": 30 }, { "card_brand": null, "currency": "brl", "fee_rate": 799, "fixed_fee_amount": 0, "installments": 9, "payment_method_type": "credit_card", "settlement_days": 30 }, { "card_brand": null, "currency": "brl", "fee_rate": 849, "fixed_fee_amount": 0, "installments": 10, "payment_method_type": "credit_card", "settlement_days": 30 }, { "card_brand": null, "currency": "brl", "fee_rate": 899, "fixed_fee_amount": 0, "installments": 11, "payment_method_type": "credit_card", "settlement_days": 30 }, { "card_brand": null, "currency": "brl", "fee_rate": 949, "fixed_fee_amount": 0, "installments": 12, "payment_method_type": "credit_card", "settlement_days": 30 }, { "card_brand": "amex", "currency": "brl", "fee_rate": 449, "fixed_fee_amount": 0, "installments": 1, "payment_method_type": "credit_card", "settlement_days": 30 }, { "card_brand": "amex", "currency": "brl", "fee_rate": 499, "fixed_fee_amount": 0, "installments": 2, "payment_method_type": "credit_card", "settlement_days": 30 }, { "card_brand": "amex", "currency": "brl", "fee_rate": 549, "fixed_fee_amount": 0, "installments": 3, "payment_method_type": "credit_card", "settlement_days": 30 }, { "card_brand": "amex", "currency": "brl", "fee_rate": 599, "fixed_fee_amount": 0, "installments": 4, "payment_method_type": "credit_card", "settlement_days": 30 }, { "card_brand": "amex", "currency": "brl", "fee_rate": 649, "fixed_fee_amount": 0, "installments": 5, "payment_method_type": "credit_card", "settlement_days": 30 }, { "card_brand": "amex", "currency": "brl", "fee_rate": 699, "fixed_fee_amount": 0, "installments": 6, "payment_method_type": "credit_card", "settlement_days": 30 }, { "card_brand": "amex", "currency": "brl", "fee_rate": 749, "fixed_fee_amount": 0, "installments": 7, "payment_method_type": "credit_card", "settlement_days": 30 }, { "card_brand": "amex", "currency": "brl", "fee_rate": 799, "fixed_fee_amount": 0, "installments": 8, "payment_method_type": "credit_card", "settlement_days": 30 }, { "card_brand": "amex", "currency": "brl", "fee_rate": 849, "fixed_fee_amount": 0, "installments": 9, "payment_method_type": "credit_card", "settlement_days": 30 }, { "card_brand": "amex", "currency": "brl", "fee_rate": 899, "fixed_fee_amount": 0, "installments": 10, "payment_method_type": "credit_card", "settlement_days": 30 }, { "card_brand": "amex", "currency": "brl", "fee_rate": 949, "fixed_fee_amount": 0, "installments": 11, "payment_method_type": "credit_card", "settlement_days": 30 }, { "card_brand": "amex", "currency": "brl", "fee_rate": 999, "fixed_fee_amount": 0, "installments": 12, "payment_method_type": "credit_card", "settlement_days": 30 }, { "card_brand": "elo", "currency": "brl", "fee_rate": 449, "fixed_fee_amount": 0, "installments": 1, "payment_method_type": "credit_card", "settlement_days": 30 }, { "card_brand": "elo", "currency": "brl", "fee_rate": 499, "fixed_fee_amount": 0, "installments": 2, "payment_method_type": "credit_card", "settlement_days": 30 }, { "card_brand": "elo", "currency": "brl", "fee_rate": 549, "fixed_fee_amount": 0, "installments": 3, "payment_method_type": "credit_card", "settlement_days": 30 }, { "card_brand": "elo", "currency": "brl", "fee_rate": 599, "fixed_fee_amount": 0, "installments": 4, "payment_method_type": "credit_card", "settlement_days": 30 }, { "card_brand": "elo", "currency": "brl", "fee_rate": 649, "fixed_fee_amount": 0, "installments": 5, "payment_method_type": "credit_card", "settlement_days": 30 }, { "card_brand": "elo", "currency": "brl", "fee_rate": 699, "fixed_fee_amount": 0, "installments": 6, "payment_method_type": "credit_card", "settlement_days": 30 }, { "card_brand": "elo", "currency": "brl", "fee_rate": 749, "fixed_fee_amount": 0, "installments": 7, "payment_method_type": "credit_card", "settlement_days": 30 }, { "card_brand": "elo", "currency": "brl", "fee_rate": 799, "fixed_fee_amount": 0, "installments": 8, "payment_method_type": "credit_card", "settlement_days": 30 }, { "card_brand": "elo", "currency": "brl", "fee_rate": 849, "fixed_fee_amount": 0, "installments": 9, "payment_method_type": "credit_card", "settlement_days": 30 }, { "card_brand": "elo", "currency": "brl", "fee_rate": 899, "fixed_fee_amount": 0, "installments": 10, "payment_method_type": "credit_card", "settlement_days": 30 }, { "card_brand": "elo", "currency": "brl", "fee_rate": 949, "fixed_fee_amount": 0, "installments": 11, "payment_method_type": "credit_card", "settlement_days": 30 }, { "card_brand": "elo", "currency": "brl", "fee_rate": 999, "fixed_fee_amount": 0, "installments": 12, "payment_method_type": "credit_card", "settlement_days": 30 }, { "card_brand": "mastercard", "currency": "brl", "fee_rate": 399, "fixed_fee_amount": 0, "installments": 1, "payment_method_type": "credit_card", "settlement_days": 30 }, { "card_brand": "mastercard", "currency": "brl", "fee_rate": 449, "fixed_fee_amount": 0, "installments": 2, "payment_method_type": "credit_card", "settlement_days": 30 }, { "card_brand": "mastercard", "currency": "brl", "fee_rate": 499, "fixed_fee_amount": 0, "installments": 3, "payment_method_type": "credit_card", "settlement_days": 30 }, { "card_brand": "mastercard", "currency": "brl", "fee_rate": 549, "fixed_fee_amount": 0, "installments": 4, "payment_method_type": "credit_card", "settlement_days": 30 }, { "card_brand": "mastercard", "currency": "brl", "fee_rate": 599, "fixed_fee_amount": 0, "installments": 5, "payment_method_type": "credit_card", "settlement_days": 30 }, { "card_brand": "mastercard", "currency": "brl", "fee_rate": 649, "fixed_fee_amount": 0, "installments": 6, "payment_method_type": "credit_card", "settlement_days": 30 }, { "card_brand": "mastercard", "currency": "brl", "fee_rate": 699, "fixed_fee_amount": 0, "installments": 7, "payment_method_type": "credit_card", "settlement_days": 30 }, { "card_brand": "mastercard", "currency": "brl", "fee_rate": 749, "fixed_fee_amount": 0, "installments": 8, "payment_method_type": "credit_card", "settlement_days": 30 }, { "card_brand": "mastercard", "currency": "brl", "fee_rate": 799, "fixed_fee_amount": 0, "installments": 9, "payment_method_type": "credit_card", "settlement_days": 30 }, { "card_brand": "mastercard", "currency": "brl", "fee_rate": 849, "fixed_fee_amount": 0, "installments": 10, "payment_method_type": "credit_card", "settlement_days": 30 }, { "card_brand": "mastercard", "currency": "brl", "fee_rate": 899, "fixed_fee_amount": 0, "installments": 11, "payment_method_type": "credit_card", "settlement_days": 30 }, { "card_brand": "mastercard", "currency": "brl", "fee_rate": 949, "fixed_fee_amount": 0, "installments": 12, "payment_method_type": "credit_card", "settlement_days": 30 }, { "card_brand": "visa", "currency": "brl", "fee_rate": 399, "fixed_fee_amount": 0, "installments": 1, "payment_method_type": "credit_card", "settlement_days": 30 }, { "card_brand": "visa", "currency": "brl", "fee_rate": 449, "fixed_fee_amount": 0, "installments": 2, "payment_method_type": "credit_card", "settlement_days": 30 }, { "card_brand": "visa", "currency": "brl", "fee_rate": 499, "fixed_fee_amount": 0, "installments": 3, "payment_method_type": "credit_card", "settlement_days": 30 }, { "card_brand": "visa", "currency": "brl", "fee_rate": 549, "fixed_fee_amount": 0, "installments": 4, "payment_method_type": "credit_card", "settlement_days": 30 }, { "card_brand": "visa", "currency": "brl", "fee_rate": 599, "fixed_fee_amount": 0, "installments": 5, "payment_method_type": "credit_card", "settlement_days": 30 }, { "card_brand": "visa", "currency": "brl", "fee_rate": 649, "fixed_fee_amount": 0, "installments": 6, "payment_method_type": "credit_card", "settlement_days": 30 }, { "card_brand": "visa", "currency": "brl", "fee_rate": 699, "fixed_fee_amount": 0, "installments": 7, "payment_method_type": "credit_card", "settlement_days": 30 }, { "card_brand": "visa", "currency": "brl", "fee_rate": 749, "fixed_fee_amount": 0, "installments": 8, "payment_method_type": "credit_card", "settlement_days": 30 }, { "card_brand": "visa", "currency": "brl", "fee_rate": 799, "fixed_fee_amount": 0, "installments": 9, "payment_method_type": "credit_card", "settlement_days": 30 }, { "card_brand": "visa", "currency": "brl", "fee_rate": 849, "fixed_fee_amount": 0, "installments": 10, "payment_method_type": "credit_card", "settlement_days": 30 }, { "card_brand": "visa", "currency": "brl", "fee_rate": 899, "fixed_fee_amount": 0, "installments": 11, "payment_method_type": "credit_card", "settlement_days": 30 }, { "card_brand": "visa", "currency": "brl", "fee_rate": 949, "fixed_fee_amount": 0, "installments": 12, "payment_method_type": "credit_card", "settlement_days": 30 }, { "card_brand": null, "currency": "brl", "fee_rate": 0, "fixed_fee_amount": 99, "installments": 1, "payment_method_type": "pix", "settlement_days": 1 } ], "updated_at": "2026-09-26T10:00:00Z" } ```