Entender ePlaza · Estados de un cobro
Docs · Entender ePlaza 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.
  • A veces el banco cancela el débito después de recibirlo, por ejemplo porque se agotó su tiempo de espera. Cuando lo confirmamos (el aviso del banco, su consulta y nuestro estado de cuenta coinciden en que el dinero no entró), el cobro sale de procesando y vuelve a pendiente (o queda expirado, si ya venció), y tu cliente puede pagar otra vez. Esa confirmación puede llegar desde los 30 minutos, cuando nuestro estado de cuenta ya muestra movimientos posteriores al pago; si alguna señal falta, puede tardar varias horas.
  • 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.
  • Un cobro pendiente pasa a expirado al llegar su expires_at (por omisión, 24 horas después de creado). Desde ese momento la consulta, el listado (también el filtro estado), los lotes y tu portal lo muestran expirado, la página de pago ya no deja pagarlo y cancelarlo responde 409. Vencer no envía webhook.
  • Un cobro que ya estaba en curso (cobrando, procesando, revision) cuando llegó su expires_at no vence por eso: sigue hasta pagado. Si el banco termina rechazándolo, queda expirado.
  • pagado y cancelado son finales: no cambian más. expirado también, salvo un caso: un pago con tarjeta que Credicard confirma después del vencimiento pasa el cobro a pagado y te llega link.pagado.

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

Pagos (dinero que sale)

Un pago (operacion: "pago" en los avisos transaccion.*, por ejemplo la transferencia del neto a tu cuenta o un reintegro) también pasa a LIQUIDADA. En un pago a otro banco, LIQUIDADA puede volverse RECHAZADA si el banco receptor rechaza la transferencia, por ejemplo porque la cuenta no está a nombre de la cédula o el RIF indicados. En ese caso llega transaccion.rechazada con el mismo data.id: el dinero no llegó al beneficiario y no se vuelve a pagar solo. Si es la transferencia de tu dinero, revisa en Ajustes › Dónde recibes tu dinero que tu cuenta esté a tu nombre.