Skip to main content
Em breve. As contestações estão em teste no Ambiente de Sandbox e ainda não chegaram à produção. Em produção, as rotas desta página respondem 404. Os campos podem mudar até o lançamento.
Uma contestação (chargeback) é aberta quando o titular do cartão não reconhece uma compra junto ao banco. Pela API você lista as contestações, consulta o prazo e envia os documentos da defesa.

Rotas

Status

O objeto

Os campos principais: id, object, status, amount, net_amount, currency, reason (category, code, description), opened_at, respond_by, days_remaining, accepts_evidence, customer, sale, evidence (file_count, total_bytes, received_at, submitted_at, files), review, review_history e timeline. A listagem devolve { "object": "list", "data": [...], "has_more": false, "summary": { ... } }. O summary traz as contagens por status, o valor em disputa e o menor prazo restante.

Enviar a defesa

  • Campo files[]: só PDF, até 20 arquivos, 2 MB por arquivo e 11 MB no total.
  • Só é aceito enquanto accepts_evidence for true.

Webhooks

chargeback.created (contestação aberta) e chargeback.updated (mudança de status ou de defesa), no formato v2. O data é o objeto da contestação.