PayZu Conta HubMED (Mecanismo Especial de Devolução)

Listar as infrações MED

GET/transactions/infractions

Confira o passo a passo → https://docs.payzu.com.br/docs/account-hub/list-infractions


A infração MED é a contestação de uma cobrança ou de um depósito, e a defesa é feita no painel.

Query Params

limitintegerPadrão: 20
Itens por página.
cursorstring
nextCursor da página anterior.
dateFromstring
Início do período, pela data de abertura.
dateTostring
Fim do período, pela data de abertura.
statusstring enum
Status da infração.
openboolean
Só as infrações ainda em andamento.
typestring enum
Motivo alegado.
analysisResultstring enum
Resultado da análise.AGREEDDISAGREED

Headers

Authorizationstringobrigatório
Bearer seguido do token de API.
acceptstring
Formato da resposta.

Responses

200Lista de infrações
dataarray of objectsInfrações, da mais recente à mais antiga.
Campos de cada item 15
protocolstringProtocolo da infração, usado na consulta e nos webhooks.
typestringMotivo alegado.
REFUND_REQUESTFRAUDREFUND_CANCELLED
statusstringStatus da infração.
OPENACKNOWLEDGEDDEFENDEDANSWEREDWAITING_PSPWAITING_ADJUSTMENTSCANCELLEDCLOSED
reportedBystringQuem abriu a infração.
DEBITED_PARTICIPANTCREDITED_PARTICIPANT
reportDetailsstringRelato de quem abriu a infração.
analysisResultstring | nullResultado da análise.
AGREEDDISAGREED
analysisDetailsstring | nullJustificativa do resultado da análise.
endToEndIdstringID end-to-end do Pix contestado.
blockedAmountintegerValor bloqueado durante a análise, em centavos.
feeChargedintegerTaxa de análise cobrada, em centavos.
settledAmountintegerValor que voltou ao pagador, em centavos.
reportedAtstringData e hora da abertura.
dueAtstring | nullPrazo para responder.
closedAtstring | nullData e hora do encerramento.
originobjectOperação contestada.
Campos do objeto 5
kindstringTipo da operação contestada.
PAYMENTDEPOSIT
amountintegerValor recebido, em centavos.
paidAtstring | nullData e hora do recebimento.
payerNamestring | nullNome do cliente da cobrança ou de quem pagou o depósito.
payerDocumentstring | nullCPF ou CNPJ de quem pagou, com o CPF mascarado.
nextCursorstringCursor da próxima página, ausente na última.
400Requisição inválida
messagestringMotivo em texto, para exibir ou registrar.
codestringCódigo do erro.
401Credencial ausente ou inválida
messagestringMotivo em texto, para exibir ou registrar.
codestringCódigo do erro.
403Acesso negado
messagestringMotivo em texto, para exibir ou registrar.
codestringCódigo do erro.

Linguagem

Credenciais Bearer

Token de API

curl --request GET \     --url https://api.sandbox.payzu.dev/api/v1/transactions/infractions \     --header 'authorization: Bearer SEU_TOKEN' \     --header 'accept: application/json'
Resposta

Clique em Try It! para enviar uma requisição e ver a resposta aqui. Ou escolha um exemplo:

application/json