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).
| Estado | Qué significa | ¿Entregas? |
|---|---|---|
pendiente | Creado, nadie lo ha pagado | No |
cobrando | Un cliente está pagando en este momento | Todavía no |
procesando | El banco recibió el débito y todavía no confirma que el dinero se movió | Todavía no: espera |
revision | Lo estamos verificando con el banco | Todavía no: espera |
pagado | El banco confirmó el pago: el dinero es tuyo | Sí |
expirado | Venció sin pagarse | No |
cancelado | Lo cancelaste antes de que lo pagaran | No |
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 porprocesandohasta que el banco confirma (suele tardar menos de un minuto, pero a veces bastante más) y entonces quedapagadoy te llegalink.pagado. - Si el banco rechaza el pago (clave equivocada, sin saldo), el cobro vuelve a
pendientey el cliente puede intentarlo otra vez con una clave nueva. También puede volver apendientedesdeprocesando, 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
procesandoy vuelve apendiente(o quedaexpirado, 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. procesandoyrevisionno son rechazos: el pago puede terminar aprobado. Nunca le cobres de nuevo a un cliente con un cobro en esos estados.- Un cobro
pendientepasa aexpiradoal llegar suexpires_at(por omisión, 24 horas después de creado). Desde ese momento la consulta, el listado (también el filtroestado), los lotes y tu portal lo muestranexpirado, la página de pago ya no deja pagarlo y cancelarlo responde409. Vencer no envía webhook. - Un cobro que ya estaba en curso (
cobrando,procesando,revision) cuando llegó suexpires_atno vence por eso: sigue hastapagado. Si el banco termina rechazándolo, quedaexpirado. pagadoycanceladoson finales: no cambian más.expiradotambién, salvo un caso: un pago con tarjeta que Credicard confirma después del vencimiento pasa el cobro apagadoy te llegalink.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.