Disputa

Disputa é a solução da Rapid para defesa automatizada de chargeback. Enquanto a Prevenção responde ao banco para a disputa não nascer e o Alerta 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

Você envia a transação, com o id da cobrança no gateway, e as provas da venda
Gateway registra o chargeback quando o portador abre a disputa
Gateway → Rapid avisa a Rapid na hora, porque a sua conta do gateway está conectada à Rapid (ver abaixo)
Rapid cruza a disputa com a sua transação, pelo id da cobrança
Rapid → Você avisa pelo webhook, se a razão for fraude, para você cortar o acesso do comprador
Rapid avalia o caso, monta o dossiê com as provas e submete a contestação
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
Provas do que sustenta a venda	é o conteúdo da defesa	Evidência e Captura
Um endpoint para o corte de acesso	é exigência de regra de bandeira	Webhook

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.

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: o que mandar para a disputa achar a transação
Visão geral da evidência: como registrar prova
Visão geral da captura: como capturar sinais no checkout
Payload do webhook: o formato do corte de acesso