# Documentación de Rapid > Documentación de integración de Rapid: prevención de disputas, alertas de contracargo, defensa de contracargos, envío de transacciones, webhooks, captura y evidencias. La API pública está en https://api.rapidchargeback.com y usa Basic Auth con client_id y client_secret. Todas las páginas están disponibles en Markdown: cambia la barra final de la dirección por `.md`. Toda la documentación en un solo archivo: https://doc.rapidchargeback.com/es/llms-full.txt. Servidor MCP para asistentes de IA: https://doc.rapidchargeback.com/mcp/. Colección de Postman: https://doc.rapidchargeback.com/es/rapid.postman_collection.json. También en portugués (https://doc.rapidchargeback.com/llms.txt) e inglés (https://doc.rapidchargeback.com/en/llms.txt). ## Empezar - [Documentación de Rapid](https://doc.rapidchargeback.com/es/index.md): Documentación de integración de Rapid, con prevención de disputas, alertas de contracargo, envío de transacciones, webhooks y captura de evidencias. - [Primera integración](https://doc.rapidchargeback.com/es/primeira-integracao.md): De cero a la primera alerta respondida: credenciales, webhook con firma validada, primera transacción y el callback de estado, con los comandos listos. ## Productos - [Prevención](https://doc.rapidchargeback.com/es/produtos/prevencao/visao-geral.md): Cómo Prevención cierra la disputa antes del contracargo, respondiendo al banco emisor con los datos del pedido a partir de las transacciones que ya envías. - [Prevención › Integración](https://doc.rapidchargeback.com/es/produtos/prevencao/integracao.md): Qué enviar para activar Prevención: datos del merchant, campos mínimos de la transacción y los que habilitan la protección contra fraude. - [Alerta](https://doc.rapidchargeback.com/es/produtos/alerta/visao-geral.md): Cómo Alerta te avisa de una disputa antes de que se convierta en contracargo, cómo llega la alerta a tu empresa y qué responder en cada red de tarjetas. - [Alerta › Reglas y plazos](https://doc.rapidchargeback.com/es/produtos/alerta/regras-e-prazos.md): Los estados de una alerta, el plazo de respuesta de cada red de tarjetas, la conversión de other a account_suspended y cuándo vence la alerta. - [Disputa](https://doc.rapidchargeback.com/es/produtos/disputa/visao-geral.md): Cómo Disputa arma y presenta la defensa del contracargo, qué necesita Rapid de ti y el corte de acceso en disputas por fraude. ## Canales de integración - [Merchants › Listar merchants](https://doc.rapidchargeback.com/es/canais/merchants/listar-merchants.md): Lista los merchants de tu empresa, paginado, con el merchant_id que crear transacción y enviar evento de captura requieren. - [Transacciones › Visión general](https://doc.rapidchargeback.com/es/canais/transactions/visao-geral.md): Envía, consulta, actualiza y elimina las transacciones de venta que alimentan la Prevención y la Disputa, con Basic Auth y JSON. - [Transacciones › Crear transacción](https://doc.rapidchargeback.com/es/canais/transactions/criar-transacao.md): Crea una única transacción de venta. Para crear varias transacciones a la vez, consulta la página Envío por lotes. - [Transacciones › Envío por lotes](https://doc.rapidchargeback.com/es/canais/transactions/envio-em-lote.md): Crea varias transacciones en una sola solicitud (hasta 1000 por llamada). - [Transacciones › Consultar transacción](https://doc.rapidchargeback.com/es/canais/transactions/consultar-transacao.md): Devuelve los datos completos de una transacción, por el ID de Rapid o por el ID de tu sistema, incluyendo ítems, cliente, direcciones, pagos y reembolsos. - [Transacciones › Actualizar transacción](https://doc.rapidchargeback.com/es/canais/transactions/atualizar-transacao.md): Actualiza una transacción existente. Todos los campos son opcionales: envía solo lo que quieres cambiar. - [Transacciones › Eliminar transacción](https://doc.rapidchargeback.com/es/canais/transactions/deletar-transacao.md): Elimina una transacción y todos sus datos relacionados (ítems, cliente, direcciones, pagos, reembolsos). - [Transacciones › Códigos de error](https://doc.rapidchargeback.com/es/canais/transactions/codigos-de-erro.md): Los estados HTTP y los códigos de error de la API de Transacciones, con los mensajes exactos y el formato de los errores en el envío por lotes. - [Transacciones › Buenas prácticas](https://doc.rapidchargeback.com/es/canais/transactions/boas-praticas.md): Cómo enviar transacciones de forma confiable: qué enviar, formato de los datos, seguridad de las credenciales, manejo de respuestas e inmutabilidad. - [Webhook › Visión general](https://doc.rapidchargeback.com/es/canais/webhook/visao-geral.md): Cómo Rapid entrega alertas y eventos en tu sistema por webhook HTTPS: registro de la URL, clave de firma y flujo de entrega. - [Webhook › Payload](https://doc.rapidchargeback.com/es/canais/webhook/payload.md): Los eventos que Rapid envía por webhook: headers, campos de cada cuerpo, ejemplos completos y la diferencia entre los formatos v2 y legacy. - [Webhook › Autenticación](https://doc.rapidchargeback.com/es/canais/webhook/autenticacao.md): Cómo validar la firma HMAC-SHA256 de los webhooks de Rapid, con protección contra replay y ejemplos listos en Node.js, Python y PHP. - [Webhook › Reintentos y logs](https://doc.rapidchargeback.com/es/canais/webhook/retries-e-logs.md): Cuándo Rapid intenta entregar el webhook de nuevo, en qué intervalos, qué cuenta como éxito y cómo leer el log de entregas. - [Webhook › Buenas prácticas](https://doc.rapidchargeback.com/es/canais/webhook/boas-praticas.md): Lo que un endpoint de webhook necesita hacer: validar la firma, responder rápido, ser idempotente, usar HTTPS y una dirección pública. - [Captura › Visión general](https://doc.rapidchargeback.com/es/canais/capture/visao-geral.md): Cómo Rapid registra, en el momento en que ocurren, las señales que respaldan una venta: aceptación de términos, dispositivo, acceso, entrega y uso. - [Captura › Instalar el snippet](https://doc.rapidchargeback.com/es/canais/capture/instalar-o-snippet.md): 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. - [Captura › Enviar evento desde el navegador](https://doc.rapidchargeback.com/es/canais/capture/enviar-evento-navegador.md): Registra un evento de captura usando el token publicable. Es el endpoint que llama el snippet, y puedes llamarlo directamente si prefieres no cargar el script. - [Captura › Enviar evento desde el servidor](https://doc.rapidchargeback.com/es/canais/capture/enviar-evento-servidor.md): Registra eventos de captura desde tu backend: entrega confirmada, rastreo, uso del servicio y eventos con fecha retroactiva. - [Captura › Tipos y payload](https://doc.rapidchargeback.com/es/canais/capture/payload.md): Referencia de los valores aceptados en los dos canales de captura. Vale para POST /capture/{token}/events y POST /capture/events. - [Captura › Configuración del snippet](https://doc.rapidchargeback.com/es/canais/capture/config-do-snippet.md): Endpoint que devuelve la configuración de identificación de la cuenta, leído por el snippet al cargar. Solo hace falta si escribes tu propio colector. - [Evidencia › Visión general](https://doc.rapidchargeback.com/es/canais/evidence/visao-geral.md): La API de Evidencia adjunta a una transacción ya enviada los hechos que sostienen la defensa: aceptación, acceso, entrega, uso y conversación con el cliente. - [Evidencia › Registrar evidencia](https://doc.rapidchargeback.com/es/canais/evidence/registrar-evidencia.md): Adjunta un registro de evidencia a una transacción ya enviada a Rapid. - [Evidencia › Consultar evidencias](https://doc.rapidchargeback.com/es/canais/evidence/consultar-evidencias.md): Lista las evidencias registradas en una transacción, de la más antigua a la más reciente. ## Callback de estado - [Visión general](https://doc.rapidchargeback.com/es/callback/visao-geral.md): El callback de estado: la respuesta que tu aplicación devuelve a Rapid después de analizar una alerta, y cuándo es obligatoria. - [Actualizar estado](https://doc.rapidchargeback.com/es/callback/atualizar-status.md): Actualiza el estado de una alerta recibida por webhook. - [Consultar alertas](https://doc.rapidchargeback.com/es/callback/consultar-alertas.md): Lista las alertas de contracargo de tu empresa, con filtros opcionales y paginación. ## Referencia técnica - [Autenticación](https://doc.rapidchargeback.com/es/referencia/autenticacao.md): Referencia técnica de todos los mecanismos de autenticación de Rapid: Basic Auth para tus llamadas y la firma del webhook para las llamadas de Rapid. - [Códigos de respuesta](https://doc.rapidchargeback.com/es/referencia/codigos-de-resposta.md): Referencia de los códigos HTTP usados en toda la API de Rapid. - [Problemas comunes](https://doc.rapidchargeback.com/es/referencia/problemas-comuns.md): Índice por síntoma de los problemas de integración más comunes, con la causa probable y la página que resuelve cada uno. - [Glosario](https://doc.rapidchargeback.com/es/referencia/glossario.md): Los términos de pago y de integración usados en esta documentación, de ARN a webhook, con lo que cada uno significa para quien integra con Rapid. - [Ejemplos canónicos](https://doc.rapidchargeback.com/es/referencia/exemplos-canonicos.md): Los IDs, valores y credenciales fijos de todos los ejemplos de la documentación, para que el ejemplo de una página se conecte con el de otra. - [Herramientas para devs](https://doc.rapidchargeback.com/es/referencia/ferramentas-para-devs.md): La documentación en tu asistente de IA (MCP), en Markdown y en llms.txt, y la colección de Postman con todas las solicitudes listas. - [Novedades de la API](https://doc.rapidchargeback.com/es/referencia/novidades-da-api.md): Qué cambió en la API de integración de Rapid, por fecha: endpoints nuevos, cambios de comportamiento y lo que sigue funcionando del sistema anterior.