# Disputa

> Como a Disputa monta e submete a contestação do chargeback, o que a Rapid precisa de você e o corte de acesso em disputa de fraude.

Página: https://doc.rapidchargeback.com/produtos/disputa/visao-geral/

**Disputa** é a solução da Rapid para **defesa automatizada de chargeback**. Enquanto a [Prevenção](https://doc.rapidchargeback.com/produtos/prevencao/visao-geral/) responde ao banco para a disputa não nascer e o [Alerta](https://doc.rapidchargeback.com/produtos/alerta/visao-geral/) avisa antes de virar chargeback, a Disputa atua depois: quando o chargeback já entrou, a Rapid monta e submete a contestação (*second presentment*) no prazo da bandeira.

A defesa é construída com o que você já manda: a transação, as provas registradas e os sinais capturados no checkout. Quanto mais material, maior a chance de ganhar.

## Como funciona

1. **Você** envia a transação, com o id da cobrança no gateway, e as provas da venda
2. **Gateway** registra o chargeback quando o portador abre a disputa
3. **Gateway → Rapid** avisa a Rapid na hora, porque a sua conta do gateway está conectada à Rapid (ver abaixo)
4. **Rapid** cruza a disputa com a sua transação, pelo id da cobrança
5. **Rapid → Você** avisa pelo webhook, se a razão for fraude, para você cortar o acesso do comprador
6. **Rapid** avalia o caso, monta o dossiê com as provas e submete a contestação
7. **Gateway → Rapid** devolve o desfecho, que aparece no painel

O seu trabalho está nos passos 1 e 5, em destaque: o material que você envia antes de tudo acontecer e o corte de acesso. O resto é da Rapid.

## O que a Rapid precisa de você

| O que | Por quê | Onde |
|---|---|---|
| A sua conta do gateway de pagamento conectada à Rapid | é por ela que a disputa chega; sem a conexão, nenhuma disputa aparece | Painel, em **Configurações › Integrações**: é só autorizar, sem código |
| A transação, com o id da cobrança no gateway | sem ela a disputa chega sem histórico e sem prova | [Criar transação](https://doc.rapidchargeback.com/canais/transactions/criar-transacao/) |
| Provas do que sustenta a venda | é o conteúdo da defesa | [Evidência](https://doc.rapidchargeback.com/canais/evidence/visao-geral/) e [Captura](https://doc.rapidchargeback.com/canais/capture/visao-geral/) |
| Um endpoint para o corte de acesso | é exigência de regra de bandeira | [Webhook](https://doc.rapidchargeback.com/canais/webhook/visao-geral/) |

O ponto que mais derruba integração é o da transação. A disputa encontra a transação pelo identificador da cobrança no gateway, então o campo `transaction_id` (ou `external_source` mais `external_id`) tem que carregar esse valor. Transação não encontrada significa defesa sem os dados de autenticação, sem evidência anexada e sem histórico do pedido.

## Corte de acesso em disputa de fraude

Quando a disputa é de fraude, as bandeiras exigem que o lojista tente revogar o produto ou serviço entregue e tenha processo para evitar reincidência. Para isso a Rapid dispara o evento `dispute.fraud.revoke_access` no seu webhook, com as ações exigidas e o prazo.

É o único ponto da Disputa em que a Rapid chama o seu sistema. Trate de forma automática se possível: quanto mais rápido o corte, menor o prejuízo. O formato está em [Payload do webhook](https://doc.rapidchargeback.com/canais/webhook/payload/#evento-disputefraudrevoke_access).

Se a entrega falhar, a pendência aparece no painel para alguém do seu time confirmar à mão.

## Situações da disputa

| Situação | O que significa |
|---|---|
| `received` | chegou e está em avaliação |
| `submitted` | contestação enviada ao gateway, aguardando o desfecho |
| `won` | disputa ganha |
| `lost` | disputa perdida |
| `accepted` | o caso não foi contestado |
| `needs_review` | a Rapid não conseguiu identificar o vendedor, e a equipe está revisando |

Nem todo chargeback é contestado. A Rapid avalia caso a caso: quando não há direito de contestação pela regra da bandeira, ou quando o material disponível não sustenta a defesa, o caso é marcado como não contestado em vez de gastar prazo com uma submissão perdida.

## Requisitos de configuração

- produto **Disputa** ativo na sua empresa
- a conta do seu gateway de pagamento conectada no painel, em Configurações
- um webhook ativo, se você quer receber o corte de acesso

A conexão do gateway é feita no painel, sem código: você cria uma chave restrita na plataforma de pagamento, cola no painel e registra o endereço que o painel mostrar. O suporte da Rapid acompanha esse passo.

## Próximos passos

- [Criar transação](https://doc.rapidchargeback.com/canais/transactions/criar-transacao/): o que mandar para a disputa achar a transação
- [Visão geral da evidência](https://doc.rapidchargeback.com/canais/evidence/visao-geral/): como registrar prova
- [Visão geral da captura](https://doc.rapidchargeback.com/canais/capture/visao-geral/): como capturar sinais no checkout
- [Payload do webhook](https://doc.rapidchargeback.com/canais/webhook/payload/): o formato do corte de acesso