> This page is for Internet banking (beta).

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

# fee.charged

POST 

Tarifa bancária cobrada

Enviado quando uma tarifa bancária é cobrada na conta (por exemplo, tarifa por transação PIX).

**Estrutura do `data`:**

* `transactionId`: ID determinístico da row de tarifa no nosso ledger (`fee-{coreId}`).
* `accountId` / `tenantId`: Conta cobrada e tenant.
* `amount`: Valor da tarifa, **sempre positivo** em reais.
* `description`: Descrição da tarifa.
* `feeServiceType`: Tipo de serviço que originou a tarifa (`PIX`, `BOLETO`, `P2P_CRYPTO`, etc.) quando o banco informa.
* `originalRef` / `transactionRef`: Referência cruzada com a movimentação que gerou a tarifa, quando disponível.
* `occurredAt`: Timestamp da cobrança no banco.
* `status`: Sempre `"SUCCESS"`.
* `kind`: `"CHARGED"`.

Reference: https://docs.api.corpx.com/ib/referencia/webhook-events/webhook-fee-charged

## Request

### Headers

- `X-Signature` (string, optional) — Present when the subscription uses `authType: HMAC`: `base64(HMAC_SHA256(secret, raw_request_body))` (standard Base64, with padding). Compare in constant time against your own computation over the raw body.

### Payload

- `id` (string, required) — Deterministic event id. Same `id` means the same event, possibly redelivered — deduplicate on it.
- `type` (enum, required) — Event type. Full list at `GET /v1/webhooks/events`.
  - Allowed values: `fee.charged`
- `occurredAt` (datetime, required) — RFC 3339, UTC with `Z`.
- `schemaVersion` (string, required) — `1.0` today; bumped only on breaking payload changes.
- `environment` (enum, required) — Environment that emitted the event.
  - Allowed values: `production`, `sandbox`
- `tenantId` (string, required) — Tenant the event belongs to.
- `data` (WebhooksWebhookFeeChargedPayloadContentApplicationJsonSchemaData, required) — Event-specific payload. See each webhook.
- `accountId` (string, optional) — CorpX account where the event happened. Empty on cross-account events.

## Types

### WebhooksWebhookFeeChargedPayloadContentApplicationJsonSchemaData

Event-specific payload. See each webhook.

- `transactionId` (string, optional)
- `accountId` (string, optional)
- `tenantId` (string, optional)
- `amount` (double, optional)
- `description` (string, optional)
- `feeServiceType` (string, optional)
- `originalRef` (string, optional)
- `transactionRef` (string, optional)
- `occurredAt` (datetime, optional)
- `status` (string, optional)
- `kind` (string, optional)