# Problemas comunes

> Í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.

Página: https://doc.rapidchargeback.com/es/referencia/problemas-comuns/

¿Encontraste tu síntoma? La causa probable está en una línea, y el detalle en la página del enlace.

## Credenciales y acceso

### Toda llamada responde `401`

El header `Authorization` no coincide: credencial incorrecta, regenerada en el panel (la anterior deja de valer al instante) o base64 armado sobre algo distinto de `client_id:client_secret`. Ver [Autenticación](https://doc.rapidchargeback.com/es/referencia/autenticacao/).

### La API responde `403 COMPANY_BLOCKED`

La empresa está bloqueada en Rapid. Las llamadas con credencial se detienen; los webhooks siguen llegando. Ver [Empresas bloqueadas](https://doc.rapidchargeback.com/es/canais/webhook/retries-e-logs/#empresas-bloqueadas).

### Recibo `429`

Superaste el límite de solicitudes. Espera el tiempo del header `Retry-After` y, para volumen, usa el envío por lotes. Ver [Rate limit](https://doc.rapidchargeback.com/es/referencia/codigos-de-resposta/#rate-limit).

### Recibo `404 NOT_FOUND` en un endpoint que existe

La ruta tiene una diferencia: barra final de más, falta `/api/v1` o un error de tipeo. Ver [Códigos de respuesta](https://doc.rapidchargeback.com/es/referencia/codigos-de-resposta/).

## Webhook

### No llega ningún webhook

Primero confirma que el webhook esté registrado y activo en **Configuración › Webhook**: sin eso no hay entrega ni registro en el log. Después, mira el motivo de cada intento en el log de entregas del panel, en **Actividad**, pestaña **Webhooks**: empieza con `[https]`, `[destino]`, `[redirecionamento]` o `[assinatura]` cuando la falla no fue una respuesta de tu servidor. Ver [Reintentos y logs](https://doc.rapidchargeback.com/es/canais/webhook/retries-e-logs/#logs-de-entrega).

### La firma nunca coincide

Casi siempre el cuerpo se leyó como JSON antes de validar: la firma es sobre el cuerpo crudo, byte a byte. Otras causas: una clave que ya se cambió y un timestamp fuera de la ventana. Pruébalo con el [verificador de firma](https://doc.rapidchargeback.com/es/canais/webhook/autenticacao/#verificador-de-firma) y compáralo con los ejemplos de [Autenticación del webhook](https://doc.rapidchargeback.com/es/canais/webhook/autenticacao/).

### El log muestra una falla, pero mi servidor lo recibió

Tu servidor respondió fuera de `2xx` o tardó más que el tiempo límite. Ver [Qué cuenta como éxito](https://doc.rapidchargeback.com/es/canais/webhook/retries-e-logs/#qué-cuenta-como-éxito).

### La misma alerta llegó dos veces

Es un reintento o un reenvío, con el mismo `alert_id`. Ver [Idempotencia](https://doc.rapidchargeback.com/es/canais/webhook/boas-praticas/#idempotencia).

## Alertas

### `422 ALERT_INVALID_STATUS` al responder una alerta

El plazo pasó o la alerta ya tiene un estado definitivo. El mensaje indica cuál de los casos es. Ver [Transición no permitida](https://doc.rapidchargeback.com/es/callback/atualizar-status/#transición-no-permitida).

### No sé el `id` de la alerta, solo el del proveedor

Busca por el `provider_alert_id`. Ver [Buscar por tu propio ID](https://doc.rapidchargeback.com/es/callback/consultar-alertas/#buscar-por-tu-propio-id-el-del-proveedor).

## Transacciones

### `409 TRANSACTION_DUPLICATE`

Ya tienes una transacción con el mismo `external_source` y `external_id`. Ver [Códigos de error](https://doc.rapidchargeback.com/es/canais/transactions/codigos-de-erro/).

### `409 TRANSACTION_IMMUTABLE`

La transacción ya fue usada por un producto y ya no se puede modificar ni eliminar. Ver [Protección de inmutabilidad](https://doc.rapidchargeback.com/es/canais/transactions/visao-geral/#protección-de-inmutabilidad).

### `404 MERCHANT_NOT_FOUND`

El `merchant_id` no es de un merchant de tu empresa. Ver [Listar merchants](https://doc.rapidchargeback.com/es/canais/merchants/listar-merchants/).

### Perdí el `id` de la transacción

Encuéntrala por el identificador que enviaste. Ver [Por el ID de tu sistema](https://doc.rapidchargeback.com/es/canais/transactions/consultar-transacao/#por-el-id-de-tu-sistema).

### `413 PAYLOAD_TOO_LARGE` en el envío por lotes

El cuerpo superó el tamaño máximo. Divídelo en lotes más chicos. Ver [Envío por lotes](https://doc.rapidchargeback.com/es/canais/transactions/envio-em-lote/).

### La respuesta trae `warnings`

La transacción se creó, pero faltan campos que mejoran la protección. Ver [Warnings](https://doc.rapidchargeback.com/es/canais/transactions/criar-transacao/#warnings).

### Llegó una disputa sin la transacción asociada

La transacción no tiene el identificador del cobro en el gateway. Ver [Nota sobre `transaction_id`](https://doc.rapidchargeback.com/es/canais/transactions/criar-transacao/#nota-sobre-transaction_id).
