# Límites y reglas

| Qué | Límite |
|---|---|
| Peticiones a la API | 120 por minuto por comercio (al pasarlo: `429`) |
| Ítems por lote | 500 |
| Vigencia de un enlace | De 1 hora a 30 días (`expira_horas` 1–720); por omisión 24 horas |
| `concepto` | 140 caracteres |
| `metadata` | Hasta 20 claves; nombre de hasta 40 caracteres y valor de hasta 200 |
| `idempotency_key` | Hasta 64 caracteres |
| `success_url` y `failure_url` | Deben empezar con `https://`; hasta 400 caracteres |
| Pago de prueba en `procesando` (clave `22222222`) | Pasa a `pagado` a los 30 segundos más o menos |
| Moneda | Bolívares (`VES`). Si cobras en dólares desde el portal, se convierte a la tasa BCV del momento |
| Webhooks | URL `https://`; hasta 6 intentos de entrega |
| Pedir la clave de pago en la página de pago | 5 por hora por cobro. En producción, además, con la misma cédula y el mismo teléfono: 3 cada 10 minutos y una por minuto, y 10 cada 10 minutos desde una misma conexión (IP). Las solicitudes que el banco rechaza (por ejemplo, una cédula mal escrita) no cuentan. Al pasarlo, tu cliente ve cuánto debe esperar |
| Cierre diario de los bancos | De 11:45 p. m. a 1:30 a. m. (hora de Venezuela) no se puede pedir la clave de pago; aviso previo desde las 11:30 p. m. → [Cierre diario](/developers/enlaces-de-pago#cierre-diario-de-los-bancos) |
| Monto por cobro y por día | Tu cuenta puede tener un monto mínimo y uno máximo por cobro, y un máximo por día. Los fija QuickPay; si no tienes, no hay. Pueden estar en bolívares o en dólares: si están en dólares, se convierten a bolívares con la tasa oficial del BCV en el momento de cada operación. Un cobro que pasa el máximo se rechaza con `EXCEDE_LIMITE` (por debajo del mínimo, `MONTO_INVALIDO`) sin debitar a tu cliente. Si necesitas más, escríbenos |
| Tope de lo que recibes | Tu cuenta puede tener un tope por día (hora de Venezuela) y otro en total. Los fija QuickPay; si no tienes, no hay tope. Pueden estar en bolívares o en dólares: si están en dólares, se convierten a bolívares con la tasa oficial del BCV en el momento de cada cobro (así el tope no pierde valor cuando sube el dólar). Cuentan los cobros pagados y los que el banco está procesando; los rechazados no. Con el tope lleno, tu cliente no puede pedir la clave de pago (`409` `tope_diario_excedido` o `tope_acumulado_excedido`, con el mensaje en `motivo`; con tu llave, `POST /cobrar/token` trae además `tope` y `usado` en Bs y, si tu tope está en dólares, `topes_moneda`, `tope_usd` y `tasa_bcv`); quien ya la tenía termina su pago. Las cuentas nuevas que se aprueban automáticamente, sin revisión previa, nacen con un tope de US$ 300 por día y US$ 1.000 en total hasta que QuickPay las revisa. Si necesitas más, escríbenos |
| Propina | Hasta el tope que elijas (máximo el 100 % del cobro) y nunca más de Bs 100.000; dos decimales; sólo en bolívares → [Propinas](/developers/propinas) |

## Reglas que no cambian

- **Un cobro se paga una sola vez.** Nadie puede pagar dos veces el mismo enlace.
- **El monto no lo cambia el pagador** (salvo en tu página de pago, donde él lo escribe). La propina, si la activaste, va aparte en `propina`.
- **Prueba nunca mueve dinero**, aunque alguien abra el enlace de verdad. Las claves mágicas y `POST /links/:id/simular` sólo funcionan en cobros de prueba; en producción responden `403` o se tratan como una clave cualquiera.
- **Sólo se cancela un cobro `pendiente`.** Si alguien ya está pagando o ya pagó, `POST /links/:id/cancelar` responde `409`.
- **Las cuentas donde recibes deben estar a tu nombre** (tu cédula o el RIF de tu empresa). Vale también para la cuenta de cada sucursal y la que elijas en un cobro.
- **Cierre bancario diario:** de 11:45 p. m. a 1:30 a. m. (hora de Venezuela) los bancos hacen su cierre. En esa franja la página de pago lo avisa y no deja pedir la clave (al intentarlo responde `503` `cierre_bancario`); desde 15 minutos antes avisa sin bloquear. Lo que ya estaba en curso termina normalmente y los enlaces de prueba no se afectan. → [Cierre diario](/developers/enlaces-de-pago#cierre-diario-de-los-bancos)