# 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 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.
