Visão 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

Você ativa o SDK de captura no painel e recebe o token publicável do merchant
Instala o snippet no checkout, ou chama o endpoint direto
A cada fato relevante, envia um evento com o order_ref do pedido
A Rapid correlaciona o evento com a transação e guarda o registro
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
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.

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`	navegador	Envia um evento do checkout
`POST /capture/events`	servidor	Envia um evento pelo seu backend
`GET /capture/{token}/config`	navegador	Configuração que o snippet lê ao carregar