Visión general

La captura registra, en el momento en que ocurren, las señales que respaldan una venta: la aceptación de los términos en el checkout, el dispositivo usado en la compra, el acceso al producto, la confirmación de entrega, el uso del servicio.

Son dos canales para lo mismo, y puedes usar los dos juntos:

Canal	Quién llama	Autenticación
Navegador	el snippet en tu checkout, o tu propio código	token publicable en la URL
Servidor	tu backend	Basic Auth, igual que las otras APIs

Flujo resumido

Activas el SDK de captura en el panel y recibes el token publicable del merchant
Instalas el snippet en el checkout, o llamas al endpoint directamente
Con cada hecho relevante, envías un evento con el order_ref del pedido
Rapid correlaciona el evento con la transacción y guarda el registro
Si esa transacción se convierte en disputa, los registros entran en la defensa

Cómo el evento se convierte en evidencia

El evento no se adjunta a nada en el momento en que llega. Entra en una cola y solo se convierte en evidencia cuando coincide con una transacción real del merchant dueño del token, por el campo order_ref.

Esto tiene una consecuencia práctica que vale la pena entender: un token filtrado genera ruido, nunca datos. Quien tenga tu token publicable puede enviar eventos, pero mueren en la cola si no corresponden a un pedido tuyo de verdad.

Por eso:

enviar un evento antes de que exista la transacción es normal, la correlación ocurre después, dentro de una ventana de unas 68 horas
order_ref tiene que ser el mismo identificador que usas en la transacción (external_id)
la respuesta de éxito es 202 Accepted, no 201: Rapid aceptó el evento, el procesamiento es asíncrono
un order_ref equivocado no devuelve error. El evento se acepta y se descarta después, en silencio

Diferencia entre captura y evidencia

	Captura	Evidencia
Cuándo usar	en el momento del hecho, sin saber si se convierte en disputa	cuando ya tienes la transacción en Rapid
Referencia	`order_ref` (tu identificador)	`transaction_id` o `transaction_ref`
La transacción debe existir	no	sí, si no `404`
Campos del payload	lista cerrada	formato libre, tope de 32 KB
Respuesta	`202`, asíncrono	`201`, ya guardado

Autenticación

Navegador: el token va en la URL (/capture/{token}/events). Es publicable, puede quedar en el HTML.
Servidor: Basic Auth con client_id:client_secret. Ver Autenticación.

El token de la captura se genera en el panel, en Configuración › Integraciones, al activar el SDK de captura del merchant.

Endpoints

Endpoint	Canal	Qué hace
`POST /capture/{token}/events`	navegador	Envía un evento del checkout
`POST /capture/events`	servidor	Envía un evento desde tu backend
`GET /capture/{token}/config`	navegador	Configuración que el snippet lee al cargar