# Visão geral

> Como a Rapid registra, na hora em que acontecem, os sinais que sustentam uma venda: aceite de termos, aparelho, acesso, entrega e uso.

Página: https://doc.rapidchargeback.com/canais/capture/visao-geral/

A captura registra, no momento em que acontecem, os sinais que sustentam uma venda: o aceite dos termos no checkout, o aparelho usado na compra, o acesso ao produto, a confirmação de entrega, o uso do serviço.

São dois canais para a mesma coisa, e dá para usar os dois juntos:

| Canal | Quem chama | Autenticação |
|---|---|---|
| **Navegador** | o snippet no seu checkout, ou o seu próprio código | token publicável na URL |
| **Servidor** | o seu backend | Basic Auth, igual às outras APIs |

## Fluxo resumido

1. Você ativa o SDK de captura no painel e recebe o token publicável do merchant
2. [Instala o snippet](https://doc.rapidchargeback.com/canais/capture/instalar-o-snippet/) no checkout, ou chama o endpoint direto
3. A cada fato relevante, envia um evento com o `order_ref` do pedido
4. A Rapid correlaciona o evento com a transação e guarda o registro
5. Se aquela transação virar disputa, os registros entram na defesa

## Como o evento vira evidência

O evento **não** é anexado a nada na hora em que chega. Ele entra numa fila e só vira evidência quando casa com uma transação real do merchant dono do token, pelo campo `order_ref`.

Isso tem uma consequência prática que vale entender: token vazado gera ruído, nunca dado. Quem tiver o seu token publicável consegue mandar eventos, mas eles morrem na fila se não corresponderem a um pedido seu de verdade.

Por isso:

- enviar evento antes da transação existir é normal, a correlação acontece depois, dentro de uma janela de cerca de 68 horas
- `order_ref` tem que ser o mesmo identificador que você usa na transação (`external_id`)
- a resposta de sucesso é `202 Accepted`, não `201`: a Rapid aceitou o evento, o processamento é assíncrono
- `order_ref` errado não devolve erro. O evento é aceito e descartado depois, em silêncio

## Diferença entre captura e evidência

| | Captura | [Evidência](https://doc.rapidchargeback.com/canais/evidence/visao-geral/) |
|---|---|---|
| Quando usar | no momento do fato, sem saber se vira disputa | quando você já tem a transação na Rapid |
| Referência | `order_ref` (o seu identificador) | `transaction_id` ou `transaction_ref` |
| Transação precisa existir | não | sim, senão `404` |
| Campos do payload | lista fechada | formato livre, teto de 32 KB |
| Resposta | `202`, assíncrono | `201`, já gravado |

## Autenticação

- **Navegador:** o token vai na URL (`/capture/{token}/events`). É publicável, pode ficar no HTML.
- **Servidor:** Basic Auth com `client_id:client_secret`. Ver [Autenticação](https://doc.rapidchargeback.com/referencia/autenticacao/).

O token da captura é gerado no painel, em **Configurações › Integrações**, ao ativar o SDK de captura do merchant.

## Endpoints

| Endpoint | Canal | O que faz |
|---|---|---|
| [`POST /capture/{token}/events`](https://doc.rapidchargeback.com/canais/capture/enviar-evento-navegador/) | navegador | Envia um evento do checkout |
| [`POST /capture/events`](https://doc.rapidchargeback.com/canais/capture/enviar-evento-servidor/) | servidor | Envia um evento pelo seu backend |
| [`GET /capture/{token}/config`](https://doc.rapidchargeback.com/canais/capture/config-do-snippet/) | navegador | Configuração que o snippet lê ao carregar |

## Próximos passos

- [Instalar o snippet](https://doc.rapidchargeback.com/canais/capture/instalar-o-snippet/)
- [Tipos e payload](https://doc.rapidchargeback.com/canais/capture/payload/)
- [Enviar evento pelo navegador](https://doc.rapidchargeback.com/canais/capture/enviar-evento-navegador/)
- [Enviar evento pelo servidor](https://doc.rapidchargeback.com/canais/capture/enviar-evento-servidor/)