Ir al contenido

↑↓ navegar ↵ abrir Ctrl↵ nueva pestaña esc cerrar

El snippet es la forma más corta de capturar evidencia: dos tags en tu checkout y una llamada por evento. Se comunica con el canal navegador por ti.

Si tu checkout se renderiza en el servidor, o si prefieres no cargar un script de terceros, salta esta página y llama al endpoint directamente.

En el panel, en Configuración › Integraciones, en la fila de Rapid Capture. Actívalo y el panel muestra el snippet listo en la pestaña Instalación, ya con el token de la tienda elegida arriba. Se puede activar si tienes Prevención o Disputa activa.

El token es publicable: queda en el HTML de tu tienda y no necesita protección. Con él solo se pueden enviar eventos, nunca leer datos. Un evento que no corresponde a un pedido tuyo se descarta.

El token solo vale en el primer sitio donde se use, en sus subdominios y en el dominio de arriba (tienda.com vale también para www.tienda.com y checkout.tienda.com; fijado en checkout.tienda.com, vale también para tienda.com). Un evento que viene de otro sitio se rechaza. Así, si alguien copia el snippet en otra página, los eventos de allí no se mezclan con los tuyos.

Las pruebas en localhost, por IP o en un dominio interno (.local, .test) no cuentan como primer sitio. Los sitios en los que vale el token aparecen en el detalle de Rapid Capture (Gestionar, pestaña Visión general). Si otro sitio intenta usar el código, aparece ahí con el botón Autorizar: es el camino para tiendas con más de un dominio (checkout en uno, área de miembros en otro). Quitar saca un sitio; sin ninguno, el token vuelve a fijarse en el próximo sitio que use el código.

Si el token se filtra, Generar código nuevo lo cambia de inmediato. El anterior deja de funcionar y pegas el código nuevo en tu sitio. El panel vuelve a mostrar que espera el primer evento hasta que llegue un evento después del cambio.

<script>window.rapid=window.rapid||function(){(window.rapid.q=window.rapid.q||[]).push(arguments)};rapid('init',{token:'tu_token_publicable'})</script>
<script async src="https://api.rapidchargeback.com/sdk/v1/rapid.js"></script>

La primera etiqueta crea una cola: las llamadas a rapid(...) hechas antes de que el script termine de cargar se guardan y se envían cuando llega. Por eso el script puede ser async, y si no carga (bloqueador, red inestable, navegador antiguo) las llamadas de tu página solo quedan en espera, nunca se convierten en un error en tu checkout.

Pon el snippet lo antes posible en la página, de preferencia en el <head>: el init ya prepara la identificación del dispositivo, y cuanto antes empiece, más rápido sale la identificación en el checkout. La identificación en sí solo ocurre en el checkout: las demás páginas con el snippet no identifican el dispositivo.

El snippet antiguo (el script sin async y el init justo después) sigue funcionando.

El script tiene unos 8 KB, no tiene dependencias y no bloquea la página.

// Compra finalizada. También captura los datos del dispositivo.
rapid('checkout', { order_ref: 'TXN-2026-001' })
// El cliente aceptó los términos.
rapid('terms', { order_ref: 'TXN-2026-001' })
// El cliente accedió al producto.
rapid('track', 'access_log', { order_ref: 'TXN-2026-001' })
// El cliente usó el producto o servicio.
rapid('track', 'usage_log', { order_ref: 'TXN-2026-001' })
LlamadaEvento generadoPayload que arma el snippet
rapid('checkout', …)checkoutidentificación del dispositivo
rapid('terms', …)terms_acceptancela URL de la página
rapid('track', 'access_log', …)access_logla URL de la página
rapid('track', 'usage_log', …)usage_logla URL de la página

El order_ref es obligatorio en todas, como texto o número. Es el identificador del pedido en tu sistema, el mismo que envías en external_id al crear la transacción. Ver Tipos y payload.

Una llamada sin order_ref se ignora: no genera evento ni error visible.

El snippet nunca rompe el checkout, y eso tiene un costo que vale la pena conocer:

  • toda llamada es silenciosa. No lanza excepciones, no devuelve promesas y no lee la respuesta
  • los errores de validación (tipo equivocado, order_ref demasiado largo) no aparecen en la consola
  • las fallas de red no se reintentan en el navegador

Para probar la integración, llama al endpoint del navegador directamente con curl, donde ves el estado y el mensaje. Una vez validado, el snippet hace lo mismo en producción.

El envío usa navigator.sendBeacon cuando está disponible, con fetch en modo keepalive como alternativa. Los dos sobreviven a la navegación a la página siguiente, así que el evento de checkout no se pierde en la redirección del pago. Si la página se va antes de que termine la identificación del dispositivo, el evento sale en ese momento con la identificación propia del snippet. Por eso, si la página redirige justo después del checkout, es mejor llamarlo en una página donde el comprador se quede unos instantes, como la de confirmación del pedido.

En el checkout, el snippet identifica el dispositivo antes de enviar el evento. Intenta con Fingerprint, con un tope de 2 segundos, y recurre a una identificación propia si no lo logra (identificador en localStorage más un hash de atributos del navegador).

El resultado va en el campo fp del payload:

fpSignifica
proidentificación de Fingerprint, validada del lado del servidor
fallbackidentificación propia del snippet

La diferencia es práctica: solo la identificación validada completa el dispositivo y la IP de la transacción y genera el registro de verificación. Ver El evento checkout.

Si tu sitio tiene una CSP restrictiva, permite https://api.rapidchargeback.com en script-src y connect-src, y dale al <script> inline del snippet el mismo nonce de tus otros scripts. Para Fingerprint, permite también https://fpjscdn.net en script-src, https://api.fpjs.io y https://*.api.fpjs.io en connect-src, y blob: en worker-src. Agrega estos elementos a las directivas que tu sitio ya usa, sin quitar lo que ya tienen:

script-src 'self' 'nonce-TU_NONCE' https://api.rapidchargeback.com https://fpjscdn.net;
connect-src 'self' https://api.rapidchargeback.com https://api.fpjs.io https://*.api.fpjs.io;
worker-src 'self' blob:;

Con todo permitido, la identificación mejora. Si alguno de estos elementos queda bloqueado, la captura sigue funcionando: los eventos llegan, pero el checkout puede no completar el dispositivo ni la IP.

El mismo detalle de Rapid Capture en el panel muestra si la tienda ya recibió eventos y cuándo fue el último. Un evento cuenta cuando la transacción de su pedido ya está en Rapid. Después de instalar, haz una compra de prueba y revísalo ahí cuando su transacción llegue a Rapid.