> 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.

# Contestação de PIX enviado

Abrir a contestação no liquidante ainda é da mesa. A API registra o
pedido, manda o e-mail e devolve um código para acompanhar.

`POST /v1/accounts/{accountId}/pix/med-requests` exige:

* PIX **enviado** por esta conta (`med_request_not_outgoing_pix` se não for);
* data dentro de **80 dias** (`med_request_out_of_window`);
* `description` com pelo menos 40 caracteres;
* `reason` em `fraud_scam`, `unauthorized`, `wrong_recipient`, `duplicate`, `other`;
* `Idempotency-Key` e `X-Acting-Document`;
* escopo `med.defend`.

A resposta traz `trackingCode` no formato `MED-YYYY-NNNNNN`. Se o e-mail
para a mesa não sair, nada é gravado (**503** `email_unavailable`).

Se já existir contestação aberta do mesmo PIX, a resposta é **409** `med_request_pending`.

## Acompanhamento

`GET` da lista e do detalhe (o `requestId` pode ser o código). Enquanto
não estiver encerrada, mensagem e anexo continuam abertos — inclusive
depois que a mesa liga a MED (`status=opened`, `medId` preenchido). A MED
aberta por nós, na rota `/pix/med`, continua só leitura.

Cancelar só cabe em `submitted` ou `info_requested`, antes de existir
`medId`.

O webhook `pix.med.request.updated` traz código, status e, quando houver,
`medId` e o pedido de informação. Não traz o relato.