PayZu PixDevoluções e MED

MED


Nesta páginaOperaçõesOrigem e tipoCiclo de vidaPrazosEfeito no saldo

Acompanhe pela API as infrações do MED (Mecanismo Especial de Devolução) abertas contra Pix que você recebeu e responda a cada uma com a sua defesa.

Operações

Origem e tipo

CampoO que traz
reportedByQuem abriu: DEBITED_PARTICIPANT, a instituição da conta debitada, ou CREDITED_PARTICIPANT, a instituição da conta creditada.
typeO tipo informado: REFUND_REQUEST, FRAUD ou REFUND_CANCELLED.
reportDetailsO motivo, no texto enviado pela instituição parceira.
protocolO código da infração no Bacen. As rotas usam o id da PayZu.

Ciclo de vida

Os status vêm da instituição parceira, e a PayZu repassa cada mudança. Enviar uma defesa muda o status da defesa, não o da infração.

StatusO que muda para você
OPENA infração aceita defesa.
ACKNOWLEDGED, DEFENDED, ANSWERED, WAITING_PSP, WAITING_ADJUSTMENTSEtapas informadas pela instituição parceira; a API não aceita defesa nelas.
CLOSEDFim da análise. analysisResult traz AGREED ou DISAGREED, e analysisDetails, o texto da decisão quando a instituição envia.
CANCELLEDInfração cancelada; não aceita defesa.

Prazos

expiresAt, quando presente, é o prazo final para a defesa. Filtre a listagem por expiresAtFrom e expiresAtTo para ver o que vence antes.

Efeito no saldo

MomentoO que acontece
A infração chegaConforme a configuração da conta e o valor do Pix, a PayZu bloqueia o valor contestado: ele sai de balanceAvailable e passa a balanceBlocked.
Fechamento com AGREEDO valor do Pix é devolvido ao pagador, e a transação registra refundReason: "INFRACTION".
Fechamento com DISAGREED ou infração canceladaO bloqueio é desfeito e o valor volta ao saldo disponível.

Cada mudança na infração gera um aviso.

O evento INFRACTION_CHANGED vai aos webhooks da conta, e a callbackUrl do Pix contestado recebe um aviso com o objeto infraction no corpo, também no encerramento automático. O corpo está em Infração MED atualizada.