Skip to main content
GET
cURL

Escopo

O que esta chamada traz

Os chargebacks e MEDs dos seus produtos no período (period, 90 dias por padrão), contados pela data da contestação. A aba awaiting, que é o padrão, é a fila do que ainda pode ser defendido, com o prazo mais próximo primeiro. É a mesma lista de Minhas vendas › Chargeback e MED no painel. O id da disputa é o orderId, o id do pedido. Use-o em Consultar, Enviar defesa e Complementar.
O pré-chargeback não aparece: ele é um alerta, não uma contestação, e não comporta defesa. Veja o guia de chargeback, pré-chargeback e MED.

Abas (status)

counts traz o total de cada aba no período, e summary, os números do painel: quantas estão a defender, o valor delas, o próximo prazo e o que foi revertido em 90 dias.

Para saber de uma contestação nova

Não é preciso consultar esta lista em intervalos. O webhook dispute_defense_requested avisa quando um chargeback ou MED abre prazo de defesa, com o prazo no corpo do evento.

Authorizations

Authorization
string
header
required

Token de autenticação do tipo Bearer {access_token}, onde {access_token} é o token obtido no fluxo de autenticação.

Query Parameters

limit
integer

Itens por página. Default 10, máximo 50.

page
integer

Página a retornar. Default 1.

period
enum<integer>

Dias para trás, pela data da contestação. Default 90.

Available options:
30,
365,
90

refId do pedido, nome do produto ou nome ou e-mail do comprador.

status
enum<string>

Aba da lista. awaiting (default): aguardando defesa ou com complemento pedido. in_review: com o Compliance ou no banco. won, lost (inclui a não encaminhada), expired e all.

Available options:
all,
awaiting,
expired,
in_review,
lost,
won
type
enum<string>

Tipo da contestação. Default all.

Available options:
all,
chargeback,
med

Response

Disputas da aba pedida. counts traz o total de cada aba, e summary, os números do painel (a defender, próximo prazo, revertidos em 90 dias).

{key}
any