Resolución de problemas
Guía rápida de diagnóstico para los fallos más comunes en integraciones Cobru.
Usa esta página cuando la integración esté fallando y necesites una ruta concreta de diagnóstico, no solo guía general de API.
Orden de triage rápido
- Confirma ambiente y base URL.
- Confirma que las credenciales requeridas estén presentes.
- Inspecciona el JSON exacto enviado a Cobru.
- Inspecciona la respuesta raw de Cobru.
- Verifica si la URL hosted se construyó desde
url. - Verifica si los callbacks están llegando y deduplicándose.
Mapa de fallos comunes
| Síntoma | Primera cosa que debes revisar |
|---|---|
403 al crear pago | validación del request, no solo auth |
400 al crear pago | serialización de payment_method_enabled |
| la página de pago no abre | la URL hosted se construyó con pk en lugar de url |
| llega callback pero la orden no cambia | persistencia del webhook y procesamiento asíncrono |
| acciones de negocio duplicadas | falta de idempotencia en el handler del webhook |
| flujo de payouts poco claro | valida el nivel de confianza del endpoint antes de implementarlo |
Triage de creación de pago
Triage de webhooks
Lo que soporte siempre debe tener a mano
- order ID interno
- slug
urlde Cobru - timestamp de creación del pago
- body raw del error Cobru cuando falle la creación
- payload raw del webhook cuando exista callback
Cuándo escalar a Cobru
- cuando sandbox y producción difieran de forma no documentada
- cuando un endpoint documentado como legacy se comporte distinto a la documentación publicada
- cuando veas fallas sostenidas de proveedor sin detalles de error accionables
Páginas relacionadas
/docs/testing/docs/webhooks/docs/errors/docs/api/reference