Visión general
Un cobro puede quedar pendiente o fallar por el gateway (tarjeta rechazada), por esperar la confirmación del cliente (PIX/boleto) o porque un webhook no llegó. La confirmación real del pago siempre viene del webhook del gateway, no de la pantalla de éxito.
Requisitos previos
- Un gateway conectado (Asaas/Mercado Pago) con webhook configurado.
Paso a paso
- Abre el cobro y revisa su estado actual.
- Tarjeta rechazada: pide al cliente que pruebe otra tarjeta o método.
- PIX/boleto pendiente: espera la confirmación; reenvía el enlace/QR si hace falta.
- Pagado en el gateway pero pendiente aquí: verifica si llegó el webhook.
- Confirma el estado final en el panel del gateway si es necesario.
Configuración y opciones
- Webhook: la fuente de verdad del estado. Debe estar activo y validado.
- Métodos: PIX, boleto y tarjeta (checkout alojado).
Casos de uso
- Recuperar una venta con tarjeta rechazada ofreciendo otro método.
- Reenviar un cobro PIX que expiró.
Consejos, límites y buenas prácticas
- Nunca confíes en la pantalla de éxito para marcar como pagado — confía en el webhook.
- Garantiza idempotencia al procesar eventos del gateway.
Solución de problemas
- El estado no se actualiza: revisa la configuración y la firma del webhook.
- Cobro duplicado: verifica la idempotencia por identificador.