Solución de problemas

Pago no recibido

Síntomas

• El cliente dice que pagó, pero la transacción aparece como "Pendiente" o no aparece ninguna transacción.

Pasos para el diagnóstico

1. Verificar la blockchain: Utilice un explorador de blockchain (por ejemplo, Etherscan, Blockchain.com) para verificar el hash de la transacción. Confirme que el pago se envió a la dirección correcta.

1. Verificar las confirmaciones: Es posible que el pago esté esperando el número requerido de confirmaciones. Vaya a su panel → Transacciones y busque el estado de la transacción.

1. Verificar el monto: Si el cliente envió menos del monto requerido, la transacción se marcará como pago insuficiente a menos que "Aceptar pagos insuficientes" esté habilitado.

1. Verificar la dirección: Asegúrese de que el cliente haya enviado a la dirección de billetera correcta y en la red correcta. Un error común es enviar tokens ERC-20 a una dirección TRC-20 (redes diferentes, los fondos pueden perderse).

1. Verificar la criptomoneda: Verifique que el cliente haya pagado con la criptomoneda que seleccionó, no con un token diferente en la misma red.

Resolución

• Si la transacción se confirma en la blockchain pero no se refleja en QuantaPay, utilice lacheck-transactionAPI para forzar una nueva verificación.
• Si el pago se envió a la dirección incorrecta o a la red incorrecta, QuantaPay no puede recuperar los fondos.

Webhook no se activa

Síntomas

• Los pagos se completan en el panel de QuantaPay, pero su servidor no recibe notificaciones de webhook.

Pasos para el diagnóstico

1. Verificar la URL del webhook: Vaya a Configuración → Pagos → Webhook y confirme que la URL sea correcta.

1. Verificar la accesibilidad del endpoint: Asegúrese de que su endpoint de webhook sea accesible públicamente a través de HTTPS. Pruebe con curl:

   curl -X POST https://yoursite.com/wp-json/quantapay/webhook \
     -H "Content-Type: application/json" \
     -d '{"test": true}'

1. Verificar los registros del servidor: Busque solicitudes POST entrantes a su endpoint de webhook. Si no hay ninguna, el problema es con la entrega. Si hay errores 500, el problema está en su código de controlador.

1. Firewall / WAF: Si utiliza Cloudflare, asegúrese de que el endpoint de webhook esté permitido (consulteWordPress / WooCommercepara la configuración de Cloudflare).

1. Verificar el estado del webhook: En su panel → Transacciones, la columna "Webhook" muestra1si el webhook se envió para esa transacción.

Resolución

• Corrija la URL del webhook o la accesibilidad del endpoint.
• Utilice temporalmente un servicio de prueba de webhook (webhook.site) para confirmar que QuantaPay está enviando webhooks.
• Como alternativa, sondee la APIget-checkout-sessionpara verificar el estado del pago.

Errores de conexión API

Síntomas

• Las llamadas a la API devuelven errores, tiempos de espera o respuestas inesperadas.

Problemas comunes

Consejos para la depuración

1. Pruebe con curl: Utilice curl para aislar si el problema está en su código o en la API:

   curl -X POST https://cloud.quantapay.app/api.php \
     -d "function=get-balances" \
     -d "api-key=YOUR_API_KEY"

1. Compruebe el formato de la respuesta: Todas las respuestas siguen el formato{"success": true/false, ...}. Analice el camposuccessantes de acceder a laresponse.

1. Registre las solicitudes: Registre la solicitud y la respuesta completas para la depuración.

Problemas con el plugin de WordPress

No se actualiza el estado del pedido

• Verifique que la URL del webhook esté configurada tanto en WordPress como en QuantaPay Cloud.
• Revise el registro de depuración de WordPress (wp-content/debug.log) para ver si hay errores.
• Asegúrese de que el pedido de WooCommerce exista y tenga el estado "Pendiente".

No se guardan los ajustes del plugin

• Borre los plugins de caché (WP Super Cache, W3 Total Cache, etc.).
• Compruebe los permisos de archivo enwp-content/.
• Verifique que el usuario de la base de datos tenga permisos de escritura.

La redirección al finalizar la compra no funciona

• Asegúrese de que el certificado SSL de su sitio sea válido.
• Compruebe si hay errores de JavaScript en la consola del navegador.
• Verifique que se pueda acceder a la API de QuantaPay Cloud desde su servidor.