Solución de Problemas de API y Webhook
El soporte de API y webhook de QrX funciona mejor cuando las solicitudes incluyen identificadores claros y detalles técnicos depurados.
Problemas Comunes de API
Identificador incorrecto de comerciante, cliente o canal.
Falta de correo electrónico o teléfono del cliente para flujos de verificación y soporte.
Configuración inválida de monto, moneda, país o método de pago.
Endpoint de webhook no disponible o que devuelve una respuesta no exitosa.
Referencias de pedido duplicadas o problemas de idempotencia.
Entorno incorrecto, como enviar credenciales de producción a un endpoint de prueba.
Qué Enviar al Soporte
Envíe el entorno, comerciante o canal, referencia de pedido, ID de transacción QrX, marca de tiempo, endpoint, estado de respuesta, ID de evento webhook y cuerpo de solicitud o respuesta depurado. Elimine claves API, tokens, firmas, contraseñas y datos personales que no sean necesarios para la depuración.
Verificaciones de Reintento de Webhook
Verifique que su endpoint sea accesible, devuelva un estado de éxito rápidamente, valide correctamente las firmas y maneje de forma segura eventos webhook duplicados. Los consumidores de webhook deben ser idempotentes porque pueden ocurrir reintentos.
Cuándo Fin Debe Escalar
Fin debe escalar problemas de API relacionados con credenciales, seguridad, incidentes en producción, inconsistencias de pago, fallos en la firma del webhook o errores repetidos de integración.