Docs · Referencia Descargar .md
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 |
| 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 |
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/simularsólo funcionan en cobros de prueba; en producción responden403o se tratan como una clave cualquiera. - Sólo se cancela un cobro
pendiente. Si alguien ya está pagando o ya pagó,POST /links/:id/cancelarresponde409. - 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
503cierre_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