Skip to navigation

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.