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_pixse não for); - data dentro de 80 dias (
med_request_out_of_window); descriptioncom pelo menos 40 caracteres;reasonemfraud_scam,unauthorized,wrong_recipient,duplicate,other;Idempotency-KeyeX-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.