# Documentação Rapid

> Documentação de integração da Rapid: prevenção de disputas, alertas de chargeback, defesa de chargeback, envio de transações, webhooks, captura e evidências. A API pública fica em https://api.rapidchargeback.com e usa Basic Auth com client_id e client_secret.

Todas as páginas existem em Markdown: troque a barra final do endereço por `.md`. A documentação inteira num arquivo só: https://doc.rapidchargeback.com/llms-full.txt. Servidor MCP para assistentes de IA: https://doc.rapidchargeback.com/mcp/. Coleção do Postman: https://doc.rapidchargeback.com/rapid.postman_collection.json.

## Começar

- [Documentação da Rapid](https://doc.rapidchargeback.com/index.md): Documentação de integração da Rapid, com prevenção de disputas, alertas de chargeback, envio de transações, webhooks e captura de evidência.
- [Primeira integração](https://doc.rapidchargeback.com/primeira-integracao.md): Do zero ao primeiro alerta respondido: credenciais, webhook com assinatura validada, primeira transação e o callback de status, com os comandos prontos.

## Produtos

- [Prevenção](https://doc.rapidchargeback.com/produtos/prevencao/visao-geral.md): Como a Prevenção encerra a disputa antes do chargeback, respondendo ao banco emissor com os dados do pedido a partir das transações que você já envia.
- [Prevenção › Integração](https://doc.rapidchargeback.com/produtos/prevencao/integracao.md): O que enviar para ativar a Prevenção: dados do merchant, campos mínimos da transação e os que habilitam a proteção contra fraude.
- [Alerta](https://doc.rapidchargeback.com/produtos/alerta/visao-geral.md): Como o Alerta avisa a disputa antes de virar chargeback, como o alerta chega à sua empresa e o que responder em cada bandeira.
- [Alerta › Regras e prazos](https://doc.rapidchargeback.com/produtos/alerta/regras-e-prazos.md): Os status de um alerta, o prazo de resposta de cada bandeira, a conversão de other para account_suspended e quando o alerta expira.
- [Disputa](https://doc.rapidchargeback.com/produtos/disputa/visao-geral.md): 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.

## Canais de integração

- [Merchants › Listar merchants](https://doc.rapidchargeback.com/canais/merchants/listar-merchants.md): Lista os merchants da sua empresa, paginado, com o merchant_id que criar transação e enviar evento de captura pedem.
- [Transações › Visão geral](https://doc.rapidchargeback.com/canais/transactions/visao-geral.md): Envie, consulte, atualize e remova as transações de venda que alimentam a Prevenção e a Disputa, com Basic Auth e JSON.
- [Transações › Criar transação](https://doc.rapidchargeback.com/canais/transactions/criar-transacao.md): Cria uma única transação de venda. Para criar várias transações de uma vez, consulte a página Envio em lote.
- [Transações › Envio em lote](https://doc.rapidchargeback.com/canais/transactions/envio-em-lote.md): Cria múltiplas transações em uma única requisição (até 1000 por chamada).
- [Transações › Consultar transação](https://doc.rapidchargeback.com/canais/transactions/consultar-transacao.md): Retorna os dados completos de uma transação, pelo ID da Rapid ou pelo ID do seu sistema, incluindo itens, cliente, endereços, pagamentos e reembolsos.
- [Transações › Atualizar transação](https://doc.rapidchargeback.com/canais/transactions/atualizar-transacao.md): Atualiza uma transação existente. Todos os campos são opcionais, envie apenas o que deseja alterar.
- [Transações › Deletar transação](https://doc.rapidchargeback.com/canais/transactions/deletar-transacao.md): Deleta uma transação e todos os seus dados relacionados (itens, cliente, endereços, pagamentos, reembolsos).
- [Transações › Códigos de erro](https://doc.rapidchargeback.com/canais/transactions/codigos-de-erro.md): Os status HTTP e os códigos de erro da API de Transações, com as mensagens exatas e o formato dos erros no envio em lote.
- [Transações › Boas práticas](https://doc.rapidchargeback.com/canais/transactions/boas-praticas.md): Como enviar transações de forma confiável: o que enviar, formato dos dados, segurança das credenciais, tratamento de respostas e imutabilidade.
- [Webhook › Visão geral](https://doc.rapidchargeback.com/canais/webhook/visao-geral.md): Como a Rapid entrega alertas e eventos no seu sistema por webhook HTTPS: cadastro da URL, chave de assinatura e fluxo de entrega.
- [Webhook › Payload](https://doc.rapidchargeback.com/canais/webhook/payload.md): Os eventos que a Rapid envia por webhook: headers, campos de cada corpo, exemplos completos e a diferença entre os formatos v2 e legacy.
- [Webhook › Autenticação](https://doc.rapidchargeback.com/canais/webhook/autenticacao.md): Como validar a assinatura HMAC-SHA256 dos webhooks da Rapid, com proteção contra replay e exemplos prontos em Node.js, Python e PHP.
- [Webhook › Retries e logs](https://doc.rapidchargeback.com/canais/webhook/retries-e-logs.md): Quando a Rapid tenta entregar o webhook de novo, em que intervalos, o que conta como sucesso e como ler o log de entregas.
- [Webhook › Boas práticas](https://doc.rapidchargeback.com/canais/webhook/boas-praticas.md): O que um endpoint de webhook precisa fazer: validar a assinatura, responder rápido, ser idempotente, usar HTTPS e endereço público.
- [Captura › Visão geral](https://doc.rapidchargeback.com/canais/capture/visao-geral.md): Como a Rapid registra, na hora em que acontecem, os sinais que sustentam uma venda: aceite de termos, aparelho, acesso, entrega e uso.
- [Captura › Instalar o snippet](https://doc.rapidchargeback.com/canais/capture/instalar-o-snippet.md): O snippet é a forma mais curta de capturar evidência: duas tags no seu checkout e uma chamada por evento. Ele conversa com o canal navegador por você.
- [Captura › Enviar evento pelo navegador](https://doc.rapidchargeback.com/canais/capture/enviar-evento-navegador.md): Registra um evento de captura usando o token publicável. É o endpoint que o snippet chama, e você pode chamá-lo direto se preferir não carregar o script.
- [Captura › Enviar evento pelo servidor](https://doc.rapidchargeback.com/canais/capture/enviar-evento-servidor.md): Registre eventos de captura pelo seu backend: entrega confirmada, rastreio, uso do serviço e eventos com data retroativa.
- [Captura › Tipos e payload](https://doc.rapidchargeback.com/canais/capture/payload.md): Referência dos valores aceitos nos dois canais de captura. Vale para POST /capture/{token}/events e POST /capture/events.
- [Captura › Configuração do snippet](https://doc.rapidchargeback.com/canais/capture/config-do-snippet.md): Endpoint que devolve a configuração de identificação da conta, lido pelo snippet ao carregar. Só é preciso se você escrever o próprio coletor.
- [Evidência › Visão geral](https://doc.rapidchargeback.com/canais/evidence/visao-geral.md): A API de Evidência anexa a uma transação já enviada os fatos que sustentam a defesa: aceite, acesso, entrega, uso e conversa com o cliente.
- [Evidência › Registrar evidência](https://doc.rapidchargeback.com/canais/evidence/registrar-evidencia.md): Anexa um registro de evidência a uma transação já enviada à Rapid.
- [Evidência › Consultar evidências](https://doc.rapidchargeback.com/canais/evidence/consultar-evidencias.md): Lista as evidências registradas numa transação, da mais antiga para a mais recente.

## Callback de status

- [Visão geral](https://doc.rapidchargeback.com/callback/visao-geral.md): Após receber um alerta via webhook, sua aplicação retorna um status para a Rapid informando o resultado da análise:
- [Atualizar status](https://doc.rapidchargeback.com/callback/atualizar-status.md): Atualiza o status de um alerta recebido via webhook.
- [Consultar alertas](https://doc.rapidchargeback.com/callback/consultar-alertas.md): Lista os alertas de chargeback da sua empresa, com filtros opcionais e paginação.

## Referência técnica

- [Autenticação](https://doc.rapidchargeback.com/referencia/autenticacao.md): Esta página é referência técnica para todos os mecanismos de autenticação da Rapid.
- [Códigos de resposta](https://doc.rapidchargeback.com/referencia/codigos-de-resposta.md): Referência dos códigos HTTP usados por toda a API da Rapid.
- [Exemplos canônicos](https://doc.rapidchargeback.com/referencia/exemplos-canonicos.md): Os IDs, valores e credenciais fixos de todos os exemplos da documentação, para que o exemplo de uma página se conecte ao da outra.
- [Ferramentas para devs](https://doc.rapidchargeback.com/referencia/ferramentas-para-devs.md): A documentação no seu assistente de IA (MCP), em Markdown e em llms.txt, e a coleção do Postman com todas as requisições prontas.