Entender QuickPay · Estados de un cobro
Docs · Entender QuickPay Descargar .md

Estados de un cobro

Un cobro siempre está en uno de estos estados. Los consultas con GET /switch/v1/links/:id (campo estado).

EstadoQué significa¿Entregas?
pendienteCreado, nadie lo ha pagadoNo
cobrandoUn cliente está pagando en este momentoTodavía no
procesandoEl banco recibió el débito y todavía no confirma que el dinero se movióTodavía no: espera
revisionLo estamos verificando con el bancoTodavía no: espera
pagadoEl banco confirmó el pago: el dinero es tuyoSí
expiradoVenció sin pagarseNo
canceladoLo cancelaste antes de que lo pagaranNo

Cómo se mueve

pendiente → cobrando → pagado
                    ↘ procesando / revision → pagado
pendiente → expirado | cancelado
  • Según el banco de tu cliente, la confirmación puede llegar en el acto (el cobro pasa directo a pagado) o el cobro pasa por procesando hasta que el banco confirma (suele tardar menos de un minuto, pero a veces bastante más) y entonces queda pagado y te llega link.pagado.
  • Si el banco rechaza el pago (clave equivocada, sin saldo), el cobro vuelve a pendiente y el cliente puede intentarlo otra vez con una clave nueva. También puede volver a pendiente desde procesando, si el banco termina rechazándolo.
  • procesando y revision no son rechazos: el pago puede terminar aprobado. Nunca le cobres de nuevo a un cliente con un cobro en esos estados.
  • pagado, expirado y cancelado son finales: no cambian más.

Una regla: entrega sólo con pagado. Todo lo demás es "todavía no".