PayZu GatewayContestações

Listar as contestações

GET/v1/chargebacks

Confira o passo a passo → https://docs.payzu.com.br/docs/gateway/look-up-a-chargeback


Query Params

statusstring enum
Filtra pelo status da contestação.
invoice_idstring
Filtra pelo ID da fatura.
created_fromstring
Criados a partir deste dia, no horário de Brasília.
created_tostring
Criados até este dia, no horário de Brasília.
cursorstring
next_cursor da página anterior, como veio.
limitintegerPadrão: 100
Itens por página; sem ele, 100.

Headers

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

Responses

200Sucesso
itemsarray of objectsItens da página.
Campos de cada item 10
idstringID da contestação.
statusstringStatus da contestação.
receivedaccepteddefended
amountintegerValor contestado, em centavos.
issued_atstringData e hora em que o cliente contestou.
defense_deadlinestringPrazo para responder.
created_atstringData e hora da criação.
updated_atstringData e hora da última alteração.
disputeobjectMotivo da contestação.
Campos do objeto 2
codestring | nullCódigo do motivo na bandeira.
descriptionstring | nullMotivo em texto.
responseobject | nullResposta enviada; nula sem resposta.
Campos do objeto 4
actionstringaccept (aceite) ou defend (defesa).
acceptdefend
notestring | nullJustificativa da defesa.
file_namestring | nullNome do arquivo da defesa.
sent_atstringData e hora do envio.
invoiceobjectFatura contestada.
Campos do objeto 4
idstringID da fatura.
statusstringStatus da fatura.
pendingpaidcanceledexpiredrefundedchargedback
urlstringPágina da fatura.
external_referencestring | nullSua referência da fatura.
next_cursorstring | nullCursor da próxima página; nulo na última.
400Requisição inválida
status_codeintegerStatus HTTP.
errorstringNome do status HTTP.
messagestringMotivo em texto.
codestringCódigo do erro, quando existe.
request_idstringID da chamada, para o suporte.
fieldsarray of objectsCampos recusados na validação.
Campos de cada item 2
namestringCaminho do campo recusado.
messagestringMotivo da recusa.
401Chave ausente ou inválida
status_codeintegerStatus HTTP.
errorstringNome do status HTTP.
messagestringMotivo em texto.
codestringCódigo do erro, quando existe.
request_idstringID da chamada, para o suporte.
403Acesso negado
status_codeintegerStatus HTTP.
errorstringNome do status HTTP.
messagestringMotivo em texto.
codestringCódigo do erro, quando existe.
request_idstringID da chamada, para o suporte.
500Erro interno
status_codeintegerStatus HTTP.
errorstringNome do status HTTP.
messagestringMotivo em texto.
request_idstringID da chamada, para o suporte.

Linguagem

Credenciais Bearer

Token de API

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