PayZu PixMED (Mecanismo Especial de Devolução)Infrações recebidas

Listar as infrações MED

GET/user/infractions

Confira o passo a passo → https://docs.payzu.com.br/docs/pix/look-up-an-infraction


A infração MED é a contestação de um Pix recebido.

Query Params

pageintegerPadrão: 1
Número da página.
limitintegerPadrão: 10
Itens por página.
statusstring
Status da infração.
typestring
Tipo da infração.
endToEndIdstring
ID end-to-end do Pix.
transactionIdstring
ID da transação.
amountMinnumber
Valor mínimo da transação.
amountMaxnumber
Valor máximo da transação.
analysisResultstring
Resultado da análise.
reportedBystring
Quem abriu a infração.
participantDocumentstring
CPF ou CNPJ do participante.
participantNamestring
Nome do participante.
sortBystring enumPadrão: createdAt
Campo de ordenação.createdAtupdatedAt
sortDirectionstring enumPadrão: desc
Direção da ordenação.ascdesc
reportedAtFromstring
Abertas a partir desta data.
reportedAtTostring
Abertas até esta data.
createdAtFromstring
Registradas a partir desta data.
createdAtTostring
Registradas até esta data.
expiresAtFromstring
Prazo de defesa a partir desta data.
expiresAtTostring
Prazo de defesa até esta data.
updatedAtFromstring
Alteradas a partir desta data.
updatedAtTostring
Alteradas até esta data.
idstring
ID da infração.
protocolstring
Protocolo da infração no Bacen.

Headers

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

Responses

200Lista de infrações
infractionsarray of objectsInfrações da página.
Campos de cada item 12
idstringID da infração na PayZu.
protocolstringProtocolo da infração no Bacen.
statusstringStatus da infração.
WAITING_PSPCLOSEDOPENCANCELLEDACKNOWLEDGEDDEFENDEDANSWEREDWAITING_ADJUSTMENTS
typestringTipo da infração.
REFUND_REQUESTFRAUDREFUND_CANCELLED
reportedBystringQuem abriu a infração.
DEBITED_PARTICIPANTCREDITED_PARTICIPANT
reportDetailsstring | nullRelato de quem abriu a infração.
analysisResultstring | nullResultado da análise.
AGREEDDISAGREED
analysisDetailsstring | nullJustificativa do resultado da análise.
reportedAtstringData e hora da abertura.
expiresAtstring | nullPrazo para enviar a defesa.
transactionobjectResumo do Pix contestado.
Campos do objeto 7
idstringIdentificador da transação na PayZu.
amountnumberValor do Pix.
payerNamestring | nullTitular da conta que pagou.
payerDocumentstring | nullCPF ou CNPJ de quem pagou.
receiverNamestring | nullTitular da conta que recebe.
receiverDocumentstring | nullCPF ou CNPJ de quem recebe.
endToEndIdstring | nullID end-to-end do Pix.
defenseHistoryarray of objectsDefesas enviadas para a infração.
Campos de cada item 6
idstringIdentificador da defesa.
defensestringTexto da defesa.
statusstringStatus da defesa.
PENDINGDEFENDED
createdAtstringData e hora do envio.
updatedAtstringData e hora da última alteração.
filesarray of objectsAnexos da defesa.
Campos de cada item 3
namestringNome do arquivo.
mimeTypestringTipo MIME do arquivo.
sizeintegerTamanho do arquivo em bytes.
paginationobjectDados da paginação.
Campos do objeto 4
pageintegerPágina retornada.
limitintegerItens por página.
totalItemsintegerTotal de infrações que atendem aos filtros, até 100.000.
totalPagesintegerTotal de páginas.
400Requisição inválida
statusstringSempre ERROR.
errorstringNome do status HTTP.
errorCodestringCódigo do erro, como PZV001.
messagestringMotivo em texto, para exibir ou registrar.
statusCodeintegerO mesmo status HTTP da resposta.
requestIdstringInforme este id ao suporte para localizar a chamada.
detailsarray of objectsErros de validação por campo.
Campos de cada item 2
fieldstringCampo rejeitado.
messagestringMotivo da rejeição.
401Token ausente ou inválido
statusstringSempre ERROR.
errorstringNome do status HTTP.
errorCodestringCódigo do erro, como PZV001.
messagestringMotivo em texto, para exibir ou registrar.
statusCodeintegerO mesmo status HTTP da resposta.
requestIdstringInforme este id ao suporte para localizar a chamada.
403Acesso negado
statusstringSempre ERROR.
errorstringNome do status HTTP.
errorCodestringCódigo do erro, como PZV001.
messagestringMotivo em texto, para exibir ou registrar.
statusCodeintegerO mesmo status HTTP da resposta.
requestIdstringInforme este id ao suporte para localizar a chamada.

Linguagem

Credenciais Bearer

Token de API

Gerar credencial de sandbox

curl --request GET \     --url https://pix.sandbox.payzu.dev/v1/user/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