> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.thepennyinc.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.thepennyinc.com/_mcp/server.

# fee.updated

POST 

Sent when a `fee.updated` event occurs.

Reference: https://docs.thepennyinc.com/banking/api-reference/webhook-payloads/fee/fee-updated-webhook

## Request

### Payload

- `event_id` (string, required) — Penny's unique identifier for this notification event.
- `business_id` (string, required) — The business the event belongs to. When the event originated from a different business, this contains the originating business.
- `type` ("fee.updated", required) — The notification event type. This identifies the specific occurrence represented by the event and determines how its data should be interpreted.
- `category` ("object", required) — The category of the event payload. This groups related notification event types and describes the general kind of data contained in ``data``.
- `schema_version` ("1.0", required) — The version of the JSON notification event schema used to encode this webhook payload.
- `event_time` (datetime, required) — The date and time Penny generated the notification event.
- `occurrence_time` (datetime, required) — The date and time the underlying occurrence represented by this notification event took place.
- `data` (WebhooksFeeUpdatedWebhookPayloadContentApplicationJsonSchemaData, required) — A notification about a domain object being created, updated, or deleted.

## Types

### WebhooksFeeUpdatedWebhookPayloadContentApplicationJsonSchemaData

A notification about a domain object being created, updated, or deleted.

- `operation` (enum, required) — The change that produced this event: 'created', 'updated', or 'deleted'.
  - Allowed values: `created`, `updated`, `deleted`
- `subject` (ObjectReferenceResponse, required) — The object this event concerns.
- `category` ("object", optional, default: object) — Identifies this payload as an object change.
- `object` (FeeWebhookPayload, optional) — Sent when a fee is created or its state changes.
- `previous_attributes` (map from string to any, optional, nullable) — The object's attributes before this change, if included.

### ObjectReferenceResponse

A pointer to the object this event concerns.

- `object_type` (string, required) — The kind of object this event concerns.
- `object_id` (string, required) — The unique identifier of the object this event concerns.
- `version` (integer, optional, nullable) — The object's version at the time of this event, if known.
- `stage` (integer, optional, nullable) — The object's lifecycle stage at the time of this event, if applicable.

### FeeWebhookPayload

Sent when a fee is created or its state changes.

- `fee_id` (string, required) — Unique identifier for the fee, assigned by Penny.
- `version` (integer, required) — A counter, assigned by Penny, that increases each time this fee is updated.
- `version_time` (datetime, required) — When this version of the fee was recorded.
- `stage` (integer, required) — Tracks how far this fee has progressed through its billing lifecycle, increasing each time the fee moves to its next stage — for example, from assessment to collection.
- `stage_time` (datetime, required) — When the fee entered its current lifecycle stage.
- `currency` (enum, required) — The three-letter ISO 4217 currency code the fee amount is stated in.
  - Allowed values: `USD`
- `amount` (string, required) — The total amount of this fee, expressed as a decimal string in the fee's currency.
- `status` (enum, required) — The fee's current status in its billing lifecycle, such as assessed, pending collection, or collected.
  - Allowed values: `assessed`, `pending_collection`, `cancelled`, `partially_collected`, `collected`, `refunded`
- `source` (FeeSourceClientResponse, required) — The entity that caused this fee to be assessed, such as a specific card, transaction, or account.

### FeeSourceClientResponse

The card, account, transaction, or other item that caused a fee to be assessed.

- `type` (enum, required) — The kind of entity that triggered this fee, such as a card, account, or transaction.
  - Allowed values: `program`, `account`, `cardholder`, `card`, `transaction`, `api`, `passthrough`
- `source_id` (string, required) — The identifier of the entity that triggered this fee.
- `stage` (integer, optional, nullable) — The lifecycle stage of the originating entity at the time this fee was created, if that information was tracked.
- `version` (integer, optional, nullable) — The version of the originating entity at the time this fee was created, if that information was tracked.