Solución de problemas de API y webhooks
El soporte de API y webhooks de QrX funciona mejor cuando las solicitudes incluyen identificadores claros y detalles técnicos sin datos sensibles.
Problemas comunes de API
Identificador incorrecto de comercio, cliente o canal.
Falta el correo electrónico o el teléfono del cliente para los flujos de verificación y soporte.
Configuración inválida de importe, moneda, país o método de pago.
Endpoint de webhook no disponible o que devuelve una respuesta de error.
Referencias de pedido duplicadas o problemas de idempotencia.
Entorno incorrecto, como enviar credenciales de producción a un endpoint de prueba.
Qué enviar a soporte
Envíe el entorno, el comercio o canal, la referencia del pedido, el id de transacción de QrX, la marca de tiempo, el endpoint, el estado de la respuesta, el id del evento del webhook y un cuerpo de solicitud o respuesta sin datos sensibles. Elimine las claves de API, los tokens, las firmas, las contraseñas y los datos personales que no sean necesarios para la depuración.
Comprobaciones de reintentos de webhooks
Compruebe si su endpoint es accesible, devuelve un estado de éxito rápidamente, valida las firmas correctamente y gestiona los eventos de webhook duplicados de forma segura. Los consumidores de webhooks deben ser idempotentes porque pueden producirse reintentos.
Salud de los webhooks y registros de entrega
Cada suscripción a webhooks en PortalX muestra un estado de salud. Si un endpoint falla de forma continua, QrX envía correos de advertencia a los destinatarios configurados y desactiva automáticamente la suscripción tras aproximadamente 24 horas de fallo; puede reactivarse en PortalX una vez corregido el endpoint. Use el registro de entregas de cada webhook en PortalX para inspeccionar cada intento de entrega, incluida la solicitud, la respuesta y los reintentos, antes de contactar con soporte.
Cuándo contactar con nuestro equipo de soporte
Contacte directamente con el soporte de QrX para problemas de API que involucren credenciales, seguridad, incidentes de producción, inconsistencias de pago, fallos de firma de webhooks o errores de integración repetidos. Estos casos siempre los gestiona una persona.