Problemas comunes
¿Encontraste tu síntoma? La causa probable está en una línea, y el detalle en la página del enlace.
Credenciales y acceso
Sección titulada «Credenciales y acceso»Toda llamada responde 401
Sección titulada «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.
La API responde 403 COMPANY_BLOCKED
Sección titulada «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.
Recibo 429
Sección titulada «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.
Recibo 404 NOT_FOUND en un endpoint que existe
Sección titulada «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.
Webhook
Sección titulada «Webhook»No llega ningún webhook
Sección titulada «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.
La firma nunca coincide
Sección titulada «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 y compáralo con los ejemplos de Autenticación del webhook.
El log muestra una falla, pero mi servidor lo recibió
Sección titulada «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.
La misma alerta llegó dos veces
Sección titulada «La misma alerta llegó dos veces»Es un reintento o un reenvío, con el mismo alert_id. Ver Idempotencia.
Alertas
Sección titulada «Alertas»422 ALERT_INVALID_STATUS al responder una alerta
Sección titulada «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.
No sé el id de la alerta, solo el del proveedor
Sección titulada «No sé el id de la alerta, solo el del proveedor»Busca por el provider_alert_id. Ver Buscar por tu propio ID.
Transacciones
Sección titulada «Transacciones»409 TRANSACTION_DUPLICATE
Sección titulada «409 TRANSACTION_DUPLICATE»Ya tienes una transacción con el mismo external_source y external_id. Ver Códigos de error.
409 TRANSACTION_IMMUTABLE
Sección titulada «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.
404 MERCHANT_NOT_FOUND
Sección titulada «404 MERCHANT_NOT_FOUND»El merchant_id no es de un merchant de tu empresa. Ver Listar merchants.
Perdí el id de la transacción
Sección titulada «Perdí el id de la transacción»Encuéntrala por el identificador que enviaste. Ver Por el ID de tu sistema.
413 PAYLOAD_TOO_LARGE en el envío por lotes
Sección titulada «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.
La respuesta trae warnings
Sección titulada «La respuesta trae warnings»La transacción se creó, pero faltan campos que mejoran la protección. Ver Warnings.
Llegó una disputa sin la transacción asociada
Sección titulada «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.