> This page is for BaaS.

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

# pix.med.opened

POST 

MED aberto contra uma transação

Enviado quando uma nova disputa MED (Mecanismo Especial de Devolução) é aberta contra uma transação **creditada em uma das suas contas**. A partir dele começa a correr o prazo de **48h** para a sua resposta — ver [Guia de Disputas](/baas/guias/pagar/med).

**Estrutura do `data`:**

* `medId`: Identificador da disputa (infraction report). É o `{medId}` das rotas REST.
* `originalEndToEnd`: `endToEndId` da transação PIX em disputa.
* `amount`: Valor disputado.
* `reasonCode`: Motivo reportado pelo arranjo, cru (ex.: `scam-or-fraud`, `unauthorized-transaction`).
* `claimMessage`: Detalhes textuais informados pelo reclamante (quando presente).
* `openedAtIso`: Data de abertura do MED (ISO 8601).
* `clientAnswerDeadlineIso`: Prazo da sua resposta — `openedAtIso` + 48h.
* `status`: `OPEN` na abertura.

Reference: https://en.docs.api.corpx.com/baas/referencia/webhook-events/webhook-pix-med-opened

## 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: `pix.med.opened`
- `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` (WebhooksWebhookPixMedOpenedPayloadContentApplicationJsonSchemaData, required) — Event-specific payload. See each webhook.
- `accountId` (string, optional) — CorpX account where the event happened. Empty on cross-account events.

## Types

### WebhooksWebhookPixMedOpenedPayloadContentApplicationJsonSchemaData

Event-specific payload. See each webhook.

- `medId` (string, optional)
- `originalEndToEnd` (string, optional)
- `amount` (double, optional)
- `reasonCode` (string, optional)
- `claimMessage` (string, optional)
- `openedAtIso` (datetime, optional)
- `clientAnswerDeadlineIso` (datetime, optional)
- `status` (string, optional)