# Documentación de QuickPay Todas las guías de https://docs.pagaconquickpay.com en un solo archivo, en el orden del sitio. Cada página empieza con su título (`#`) y su dirección. La referencia técnica de la API (OpenAPI) está en https://docs.pagaconquickpay.com/docs. --- # Qué es QuickPay y cómo llega el dinero Con QuickPay cobras en bolívares a cualquier persona con cuenta en un banco venezolano. Tu cliente abre un enlace, elige su banco, escribe su teléfono y su cédula, y confirma con la **clave de 8 dígitos que le envía su banco** (por SMS, notificación o correo). No se registra ni instala nada. | Lo que pasa | Quién lo hace | |---|---| | Creas el cobro (un enlace, un QR o un botón) | Tú, desde el portal o desde tu sistema | | Abre el enlace y paga con la clave de su banco | Tu cliente | | Confirma el pago con el banco | QuickPay | | Te avisa (en el portal y, si integraste, por webhook) | QuickPay | | Te transfiere el dinero a tu cuenta | QuickPay | ## Un pago ocurre en dos momentos 1. **El pago.** El banco confirma el débito y el cobro queda **pagado**. Desde tu sistema te llega el webhook `link.pagado`. 2. **La acreditación.** QuickPay te transfiere el monto, menos la comisión, a tu cuenta. Con la liquidación inmediata (activándose por etapas) te llega además el webhook `link.acreditado` con el desglose. > **Entrega cuando el cobro esté pagado, no antes.** Que el cliente vuelva a tu web o te mande una captura no prueba nada: la prueba es el estado `pagado` (webhook o consulta). ## Dos formas de usarlo - **Desde el portal:** sin programar. Creas cobros, los mandas por WhatsApp o correo, haces cobranza masiva y suscripciones. → [El portal de comercios](https://docs.pagaconquickpay.com/developers/portal) - **Desde tu sistema:** lo integras con la API en tu web, tu app o tu bot. → [Cómo se integra](https://docs.pagaconquickpay.com/developers/como-se-integra) ¿No sabes cuál? → [¿Cuál solución necesito?](https://docs.pagaconquickpay.com/developers/cual-solucion) # ¿Cuál solución necesito? Elegir mal no rompe nada, pero trabajas de más. Ubícate en la primera tabla que te describa. ## Si no programas | Si… | Usa… | Dónde | |---|---|---| | Cobras un monto puntual a una persona | Un cobro con monto (enlace + QR, o por WhatsApp) | [Cobrar](https://docs.pagaconquickpay.com/developers/cobrar-desde-el-portal) | | Quieres que te paguen el monto que ellos escriban | Tu página de pago `/p/tu-usuario` | [Página de pago](https://docs.pagaconquickpay.com/developers/pagina-de-pago) | | Cobras a muchos clientes a la vez (condominio, colegio, cartera) | Cobranza masiva desde un Excel | [Clientes y cobranza](https://docs.pagaconquickpay.com/developers/clientes-y-cobranza) | | Cobras lo mismo cada mes, semana o año | Suscripciones | [Suscripciones](https://docs.pagaconquickpay.com/developers/suscripciones) | | Tienes una web y quieres un botón "Pagar" | El botón de tu portal (copiar y pegar) | [Botón para tu web](https://docs.pagaconquickpay.com/developers/boton-de-pago) | ## Si programas | Si… | Usa… | Guía | |---|---|---| | Tu web, app o bot crea un cobro por pedido | Un enlace de pago por pedido + webhook | [Enlaces de pago](https://docs.pagaconquickpay.com/developers/enlaces-de-pago) | | Generas cobros en bloque desde tu sistema | Cobro por lote (hasta 500 por llamada) | [Cobro por lote](https://docs.pagaconquickpay.com/developers/cobro-por-lote) | | Tu bot de WhatsApp cobra | Enlace en un mensaje con botón + webhook | [Cobrar desde tu bot](https://docs.pagaconquickpay.com/developers/integracion-para-bots) | | Quieres pedir la clave del banco desde tu propia pantalla | API directa (sólo aliados) | [API directa](https://docs.pagaconquickpay.com/developers/api-directa) | > **Lo más simple casi siempre gana.** Si dudas entre el portal y la API, empieza por el portal: puedes pasar a la API después sin cambiar nada de tu cuenta. # Cómo funciona un cobro Todo en QuickPay es un **cobro**: un monto, un concepto y una fecha de vencimiento. Cada cobro tiene un **enlace** (`https://pay.pagaconquickpay.com/l/…`) donde tu cliente paga. ## De principio a fin 1. **Creas el cobro.** Desde el portal o con `POST /switch/v1/links`. Te devolvemos su `id` y su `url`. 2. **Se lo haces llegar.** Por WhatsApp, correo, QR, un botón en tu web o tu bot. 3. **Tu cliente paga.** Elige su banco, escribe su teléfono y su cédula, recibe la clave de 8 dígitos de su banco y la escribe. 4. **Se confirma con el banco.** El cobro pasa a `pagado`. Un cobro se paga **una sola vez**: nadie puede pagarlo dos veces. 5. **Te enteras.** En el portal (Transacciones y el aviso "Recibiste…") y, si integraste, con el webhook `link.pagado`. 6. **Te acreditamos.** El monto, menos la comisión, a tu cuenta. Con la liquidación inmediata (activándose por etapas) llega también `link.acreditado`. ## Lo que conviene saber - **El monto lo fijas tú.** El cliente no lo puede cambiar (salvo en tu página de pago, donde él lo escribe). - **Vence.** Por omisión a las 24 horas; tú eliges entre 1 hora y 30 días. Un cobro vencido ya no se puede pagar. - **Prueba y producción no se mezclan.** Un cobro creado con tu llave de prueba nunca mueve dinero, aunque lo abra alguien de verdad. → [Modo prueba](https://docs.pagaconquickpay.com/developers/datos-de-prueba) - **Tus datos viajan con el cobro.** Lo que pongas en `metadata` (tu número de pedido, por ejemplo) vuelve en las consultas. Siguiente: [Estados de un cobro](https://docs.pagaconquickpay.com/developers/ciclo-de-vida) # 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. - `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. - `pagado`, `expirado` y `cancelado` son finales: no cambian más. > **Una regla:** entrega sólo con `pagado`. Todo lo demás es "todavía no". # Comisión y liquidación ## Cuánto cuesta Cada pago recibido paga una comisión, que se descuenta del pago: tu cliente paga el monto exacto del cobro y a ti te llega el monto menos la comisión. Tu tarifa te la confirmamos al abrir tu cuenta. ## Cuándo llega el dinero La **liquidación inmediata** te transfiere el neto de cada pago apenas el banco lo confirma. La estamos **activando por etapas**: hoy se aplica a pagos pequeños mientras terminamos las pruebas con dinero real; te avisaremos cuando cubra todos tus cobros. Por cada pago liquidado te llega el webhook `link.acreditado` con el desglose: | Campo | Qué es | |---|---| | `monto_bruto` | Lo que pagó tu cliente | | `comision` | La comisión descontada | | `monto_acreditado` | Lo que llegó a tu cuenta | | `liquidacion_txn_id` | El id de la transferencia | El neto irá a tu cuenta principal. Si registraste varias cuentas, al cobrar **desde el portal** puedes elegir en cuál cae cada cobro; por la API va siempre a la principal. > **Las cuentas deben estar a tu nombre.** A nombre de tu cédula si te registraste como persona, o del RIF de tu empresa si te registraste como negocio. Así lo verificamos con un pago de Bs 1 al registrarte. --- # El portal de comercios Todo lo que necesitas para cobrar, sin programar. Entras con tu usuario o correo y tu contraseña. ## Cómo se abre la cuenta 1. Eliges **Para mí** (con tu cédula) o **Para mi negocio** (con el RIF de tu empresa). 2. Confirmas tu correo con un código. 3. Subes la foto o el PDF de tu cédula o tu RIF: llenamos tus datos por ti y tú los confirmas. 4. Si abres la cuenta **para tu negocio**, nos dices a qué se dedica: colegios y universidades, condominios, gimnasios y clubes, proveedores de internet, restaurantes y comida, sector salud, tiendas y emprendimientos, veterinarias y mascotas, u otro. Este paso no aparece en las cuentas **para ti**. 5. Registras la cuenta donde quieres recibir el dinero. La verificamos enviándote **Bs 1**: así comprobamos que está a tu nombre. 6. Creas tu usuario y tu contraseña. Al terminar, tu cuenta queda **aprobada para cobrar dinero real**: la verificación con Bs 1 es la que la habilita. El equipo de QuickPay revisa cada alta después; si algo no cuadra, te escribimos. > **De 11:45 p. m. a 1:30 a. m. (hora de Venezuela)** los bancos hacen su mantenimiento diario: la verificación con Bs 1 espera a la 1:30 a. m. y no gastas intentos. En esa franja tampoco se pueden hacer pagos: tu portal, tu página de pago y tus enlaces lo avisan desde las 11:30 p. m. Puedes crear y enviar cobros a cualquier hora; tu cliente los paga a partir de la 1:30 a. m. > **La cuenta debe estar a tu nombre.** Si la cédula o el RIF no coinciden con el titular, el banco rechaza la verificación. ## Qué haces en el portal | Sección | Para qué | |---|---| | Inicio | Lo cobrado hoy y en el mes, lo que ya llegó a tu banco y tus últimos movimientos, en la [divisa de tu panel](#divisa-del-panel) | | Cobrar | Crear un cobro con monto, tu página de pago o dividir una cuenta | | Transacciones | Todos tus cobros: filtrar por fecha, estado y más, buscar, ver detalle, cancelar o reenviar uno pendiente, y descargarlos en Excel o CSV → [Filtrar tus transacciones](#filtrar-tus-transacciones) | | Clientes | Tu base de clientes, a mano o desde Excel, con búsqueda y filtros, segmentos automáticos, etiquetas, estado de pago y acciones en grupo → [Clientes y cobranza](https://docs.pagaconquickpay.com/developers/clientes-y-cobranza). En condominios se llama **Propietarios e inquilinos** | | Cobranza masiva | Enviar el cobro a muchos clientes, ahora o programado | | Suscripciones | Planes de cobro recurrente y sus suscriptores, en tres pestañas: **Suscriptores**, **Planes** y **Métricas**, con un resumen arriba (activas, al día, atrasadas, cobrado este mes) → [Suscripciones](https://docs.pagaconquickpay.com/developers/suscripciones). No aparece en restaurantes, que no tienen cobros recurrentes | | Productos | Tu catálogo: cobras eligiendo el producto (en restaurantes se llama **Menú y productos**; gimnasios, condominios y colegios no lo usan) | | Sucursales | Restaurantes, gimnasios, sector salud, veterinarias y tiendas: tus locales, para etiquetar cada cobro, elegir a qué cuenta caen sus pagos y filtrar Transacciones | | Propinas | Restaurantes: activar la pregunta de propina al pagar, sus botones y ver las propinas recibidas → [Propinas](https://docs.pagaconquickpay.com/developers/propinas) | | Urbanizaciones y complejos | Condominios: cada urbanización o complejo con sus propietarios e inquilinos | | Integraciones | Botón para tu web, llaves de API y webhooks | | Ajustes | Tus datos, tu plan, tus cuentas de cobro, tu equipo, la divisa del panel y tus avisos | **Nombre comercial.** Si tu negocio se conoce con un nombre distinto a su razón social (p. ej. razón social *Inversiones Ejemplo 2023, C.A.* y nombre comercial *Pizzería Ejemplo*), escríbelo al registrarte o en **Ajustes › Tu cuenta** (opcional, hasta 100 caracteres). Quien te paga ve ese nombre en la página de pago ("Estás pagando a…") y en el comprobante del pago. Tu razón social no cambia: es la que usan el banco y la verificación de tu cuenta. Si lo borras, vuelve a mostrarse la razón social. El portal se adapta al **tipo de negocio** que elegiste al registrarte: el menú y los filtros cambian, pero los cobros, la cobranza masiva y las notificaciones funcionan igual para todos. Si elegiste "Otro", ves el menú estándar. Cuando entra un pago, el portal te lo muestra al momento: "Recibiste US$ X (Bs Y) de Z", en la divisa de tu panel. Además te enviamos un correo por cada pago. ## Cuentas personales Si abriste la cuenta con **Para mí**, el portal es más corto, porque una persona recibe pagos pero no administra un negocio. El menú tiene cinco secciones: | Sección | Para qué | |---|---| | Inicio | Lo cobrado hoy y en el mes, lo que ya llegó a tu banco y tus últimos movimientos | | Cobrar | **Pedir un monto** (enlace o QR para un pago puntual), **Mi enlace** (quien te paga escribe el monto) y **Dividir una cuenta** | | Movimientos | Cada pago con su referencia del banco: filtrar, buscar, ver detalle y descargarlo. Es la misma pantalla que **Transacciones** en un negocio | | Contactos | Las personas que te han pagado y eligieron guardar sus datos, y las que agregas tú. Es la misma pantalla que **Clientes** en un negocio, sin carga masiva | | Ajustes | Tus datos, tu plan, tus cuentas de cobro, la divisa del panel y tus avisos | Una cuenta personal no tiene Cobranza masiva, Suscripciones, Productos, Sucursales, Integraciones ni Equipo: esas pantallas no aparecen, si abres su dirección vuelves a Inicio y las funciones equivalentes de la API responden `403`. La página de pago de una persona muestra sus iniciales en lugar del ícono de tienda, y en ella quien te paga ve la casilla **"Guardar mis datos para pagarle más rápido a *tu nombre*."** (sin nombre obligatorio). Quien la marca aparece en **Contactos** cuando el pago queda confirmado; esa casilla no es permiso para enviarle novedades. El estado de tu cuenta se dice igual en Inicio, Cobrar y Ajustes: **cuenta de demostración** (los pagos son simulados), **en revisión** (tus cobros son de prueba hasta que te aprobemos; pasa sólo si la aprobación automática no se pudo completar) o, cuando puedes cobrar, sin aviso. En Inicio, lo cobrado hoy y en el mes suma sólo pagos reales y debajo dice cuántos de prueba quedaron fuera; en una **cuenta de demostración** (todos sus pagos son simulados) los suma, para que se vea cómo luce un negocio cobrando. ## Divisa del panel En **Ajustes › Divisa del panel** eliges en qué moneda ves tus montos: **dólares (US$)**, que es la que viene por omisión, **euros (€)** o **bolívares (Bs)**. Sólo el Propietario y los Administradores la cambian; el Cobrador ve los montos en esa divisa. Con dólares o euros, cada monto sale **grande en esa divisa** y, **debajo y pequeño, lo que fue en bolívares**; al lado sigue la cantidad de pagos. Aplica en Inicio (cobrado hoy, este mes, ya en tu banco y lo que está llegando), Últimos movimientos, Transacciones (la lista, el detalle y los totales de lo filtrado), Propinas, el total de cada lote de Cobranza masiva y el aviso de pago recibido. Los planes y productos siguen en la moneda en que fijaste su precio, y el monto que escribes al cobrar (Cobrar, Dividir cuenta, Nueva cobranza) arranca siempre en bolívares (puedes cambiarlo en cada cobro); al crear un producto o un plan, el precio arranca en tu divisa. **Con qué tasa se convierte.** Cada pago usa la tasa BCV del **día en que se pagó** (día de Venezuela), no la de hoy: - Si el cobro se creó en esa misma divisa, se usa el monto y la tasa exactos con que se creó. - Dólares: la última tasa BCV publicada hasta el día del pago (un sábado usa la del viernes). - Euros: la tasa oficial del euro que guardamos cada día. Si no tenemos la de ese día (pagos anteriores a que empezáramos a guardarla), se usa la más cercana anterior o, en su defecto, la de hoy, y el monto aparece con **≈**. Los totales suman cada pago ya convertido y se redondean al final; los bolívares de abajo son la suma real en bolívares. Es sólo cómo se muestra: los cobros y lo que llega a tu banco siguen siendo en bolívares. ## Avisos por correo Cada vez que te pagan, te llega un correo "Recibiste un pago" con el monto, el concepto, la fecha y un enlace a la transacción. Les llega al Propietario y a los Administradores, una sola vez por cobro. Viene encendido; lo apagas en **Ajustes › Avisos**. ## Tu plan En **Ajustes › Tu plan** ves tu plan, hasta cuándo está pagado, cuántos cobros por WhatsApp enviaste en los últimos 30 días y cuántos te quedan, y los planes disponibles con sus límites. Los cobros por correo no tienen límite. Esta sección la ven el Propietario y los Administradores. | Plan | Precio | Cobros por WhatsApp | |---|---|---| | Gratis | US$ 0 | 20 al mes, hasta 5 por día uno a uno | | Emprendedor | US$ 3 cada 30 días | 150 al mes, hasta 30 por día uno a uno | | Negocio | US$ 12 cada 30 días | 600 al mes, hasta 100 por día uno a uno | **Cambiar de plan:** tocas **Cambiar a …**, ves el monto en US$ y su equivalente en bolívares a la tasa BCV de ese momento, y al continuar se abre el pago de QuickPay en otra pestaña. La tarjeta queda en **Esperando tu pago…** y, cuando el pago se confirma, el plan se activa solo y te llega un correo. Si el pago en línea no está disponible en ese momento, el botón abre el WhatsApp de QuickPay con el mensaje listo. - Cada pago te da **30 días** del plan y se paga en bolívares a la tasa BCV del momento en que se crea el enlace. - **Renovar** antes de que venza suma los 30 días al final de tu período. - **Subir** de plan: empiezas 30 días nuevos desde el pago y los días que te quedaban del plan anterior se suman, convertidos al precio del nuevo (por ejemplo, 20 días de Emprendedor equivalen a 5 días de Negocio). - **Bajar** de plan: el cambio se aplica cuando termina el período que ya pagaste. No se devuelve dinero. Puedes cancelarlo antes de esa fecha. - Te avisamos por correo 3 días antes de que venza, el día que vence y el día siguiente, con el enlace para pagar. - Si no renuevas, tienes **3 días de gracia**; después vuelves al plan Gratis y te avisamos. Los cobros que ya enviaste no se cortan: el cupo sólo se revisa al enviar un cobro nuevo. ## Filtrar tus transacciones Arriba de la lista siempre ves tres controles: **Fecha**, **Estado** y **Buscar**. El botón **Filtros** abre el resto. | Filtro | Qué hace | |---|---| | Fecha | Hoy, Ayer, Últimos 7 días, Este mes, Mes pasado o **Rango personalizado** (desde–hasta, ambos días incluidos). Los días son de Venezuela: un pago de las 9:00 p. m. entra en ese día. Un cobro cuenta en la fecha en que se pagó; si aún no se paga, en la que se creó | | Estado | Pagado (en tu banco), Pendiente, Procesando, En revisión, Vencido o Cancelado | | Buscar | Por concepto, nombre del cliente, referencia del pago o del crédito a tu cuenta, o el identificador del cobro (el final de su enlace) | | Sucursal | En los tipos de negocio con sucursales. En condominios, urbanización o complejo y propietario o inquilino; en colegios, grado y sección | | Cuenta donde cae el dinero | Sólo si tienes más de una cuenta de cobro | | Monto | Mínimo y máximo del cobro, en Bs | | Propina | Con o sin propina (restaurantes) | | Cómo se creó | Creado en el portal, página de pago, botón de pago, WhatsApp, API, cobranza masiva o suscripción | | Etiqueta del cliente | Sólo los cobros enviados a personas con esa [etiqueta](https://docs.pagaconquickpay.com/developers/clientes-y-cobranza#etiquetas). El cobro del switch no trae al cliente, así que se cruza con lo que guardamos al enviarlo: Cobranza masiva, Suscripciones y quienes se registraron al pagar. **Un cobro suelto** (el de Cobrar, o un pago en tu página sin que la persona se registre) **no tiene un cliente asociado y no aparece** con este filtro | | Modo | Cobros reales o de prueba | | Pagos rechazados | **Con rechazos:** cobros con al menos un intento de pago rechazado. **Sin rechazos:** los que no tienen ninguno | Un rechazo no cambia el estado del cobro: vuelve a quedar **Pendiente** y tu cliente puede intentarlo de nuevo; si después paga, sale como pagado y el filtro lo sigue encontrando. Al abrir un cobro con intentos rechazados ves cuántos fueron (por ejemplo **2 intentos rechazados**). Sólo cuentan los intentos en los que tu cliente llegó a escribir la clave de pago de su banco. Los filtros activos aparecen como etiquetas que quitas con la **x**, y **Limpiar filtros** los quita todos. Quedan en la dirección de la página: puedes recargarla o compartirla y verás lo mismo. Debajo de los filtros ves cuántos cobros salieron, lo **cobrado** (suma de los pagados, sin contar los de prueba; en una cuenta de demostración, que sólo tiene pagos simulados, sí los cuenta) y, en restaurantes, las **propinas**, en la [divisa de tu panel](#divisa-del-panel) y con los bolívares al lado. La lista carga de 50 en 50 con **Ver más**. Los filtros y los totales cuentan todos tus cobros, en cualquier divisa del panel. En dólares o euros, cada pago se convierte con la tasa BCV de su día de pago, y un cobro que creaste en esa misma divisa cuenta con su monto exacto. Los cobros de suscripción enviados antes del 9 de octubre de 2026 aparecen como cobranza masiva. ## Descargar tus transacciones En **Transacciones › Descargar** bajas en Excel o CSV **exactamente lo que estás viendo**, con los mismos filtros, y con las fechas en hora de Venezuela. Incluye hasta 5.000 cobros de lo filtrado (los más recientes); si hay más, la pantalla te avisa: acota las fechas para bajar el resto. Las columnas en bolívares (para tu contabilidad) se mantienen; si tu divisa es dólares o euros, se agregan al lado las columnas **Monto**, **Propina** y **Acreditado** en esa divisa, la **Tasa BCV usada** de cada pago y **Tasa aproximada** (Sí cuando no era la tasa exacta de ese día). # Cobrar: enlace, QR y WhatsApp En **Cobrar › Cobro con monto**: 1. Escribe el monto en **bolívares (Bs), dólares (US$) o euros (€)**; el selector arranca en **bolívares** y puedes cambiarlo en cada cobro. En dólares o euros se convierte a bolívares a la tasa BCV del momento y debajo del monto ves la equivalencia (por ejemplo, «≈ Bs 9.806,15 a tasa BCV del 09/10»): tu cliente siempre paga en bolívares. El dólar usa la tasa BCV de QuickPay; el euro, la tasa oficial del euro, con máximo 36 horas de antigüedad. Si en ese momento no tenemos una tasa del euro confiable, la opción **€** aparece deshabilitada («Tasa del euro no disponible ahora») y no se puede cobrar en euros hasta que haya. 2. Si quieres, agrega un concepto (lo ve tu cliente) o elige productos de tu catálogo. 3. Elige cuándo vence: 1 hora, 24 horas, 3 días, 7 días o 30 días. 4. Si tienes sucursales, elige la sucursal. Si tienes más de una cuenta, en **¿Dónde recibes este pago?** ves la cuenta (banco y teléfono, con parte del número oculto): viene la de la sucursal, o la principal, y la puedes cambiar. Si la cambias, la recordamos para esa sucursal en ese navegador. 5. Pulsa **Crear cobro**. Te damos el enlace y su **QR** (puedes descargarlo para imprimirlo). Compártelo como quieras. ## Por WhatsApp desde QuickPay Con **Cobrar por WhatsApp**, le llega a tu cliente un mensaje de QuickPay con tu nombre, el monto y un botón **Pagar** que abre el pago dentro de WhatsApp, sin salir de la conversación. - Pides el nombre y el WhatsApp sólo después de crear el cobro. - Las personas a las que ya les cobraste aparecen en **Cobrar de nuevo**: tocas a la persona, pones el monto y el envío sale ya lleno. - Cada plan incluye un cupo de cobros por WhatsApp (cuenta los de los últimos 30 días). Lo ves en **Ajustes › Tu plan**. ## Dividir una cuenta En **Cobrar › Dividir cuenta** repartes un total entre varias personas: cada una recibe su propio cobro y en Transacciones los ves juntos. El total lo puedes poner en **Bs, US$ o €**, igual que en un cobro con monto: cada parte se convierte a bolívares a la tasa BCV del momento y ves lo que paga cada persona. Debajo del total aparece su equivalente en bolívares («Total ≈ Bs …») y, junto a cada persona, el de su parte. ## Después En **Transacciones** ves cada cobro con su estado y lo filtras por fecha, estado, monto y más ([Filtrar tus transacciones](https://docs.pagaconquickpay.com/developers/portal#filtrar-tus-transacciones)). Mientras esté pendiente puedes reenviarlo o cancelarlo. # Tu página de pago Es una dirección fija con tu usuario: `https://portal.pagaconquickpay.com/p/tu-usuario`. Quien la abre escribe el monto y te paga desde cualquier banco. Sirve para: - Ponerla en tu perfil de Instagram o tu firma de correo. - Imprimir su QR en el mostrador: cada cliente paga lo que le toca. La encuentras en **Inicio** y en **Cobrar › Tu página de pago**, lista para copiar o compartir por WhatsApp. ## Bs, US$ o € Junto al monto, quien paga escoge en qué moneda lo escribe: **Bs**, **US$** o **€**. Si no es Bs, debajo ve la equivalencia, por ejemplo "≈ Bs 1.250,00 a tasa BCV del 09/10". El pago siempre se debita en bolívares, a la tasa BCV del momento en que pulsa **Continuar al pago**; la conversión la hace QuickPay, no el navegador. Si no hay tasa disponible (sobre todo la del euro), esa moneda queda deshabilitada y, si se intenta igual, no se crea el cobro. Con el monto ya puesto en la dirección (abajo) el monto es en Bs y no se puede cambiar. ## Con el monto ya puesto Puedes agregar el monto y el concepto a la dirección para que el cliente sólo confirme: ``` https://portal.pagaconquickpay.com/p/tu-usuario?monto=150&concepto=Pedido%201024 ``` Así funciona también el [botón para tu web](https://docs.pagaconquickpay.com/developers/boton-de-pago). ## Un QR por sucursal o por cuenta En **Cobrar › Tu página de pago** puedes elegir una **sucursal** y, si tienes más de una cuenta, la **cuenta**. La dirección y el QR cambian: los pagos que entren por ahí quedan en esa sucursal y caen en esa cuenta (o en la de la sucursal). Imprime un QR por local. ``` https://portal.pagaconquickpay.com/p/tu-usuario?sucursal=3 ``` El enlace sigue funcionando aunque después archives esa sucursal o quites esa cuenta: lo que ya no exista se ignora y el pago cae en la cuenta que corresponda o, si no, en la principal. Si activaste [propinas](https://docs.pagaconquickpay.com/developers/propinas), tu cliente puede agregar una antes de pagar. # Clientes y cobranza masiva ## Tu base de clientes En **Clientes** guardas a quién le cobras: nombre, WhatsApp o correo (al menos uno), cédula o RIF y una **referencia** (número de contrato, apartamento, socio). También llegan solos: quien te paga con un enlace y marca **"Quiero ser cliente de *tu comercio* y recibir sus novedades"** aparece aquí cuando el pago queda confirmado, con la etiqueta **Se registró al pagar** y **Acepta novedades**. Usa el filtro **Aceptan novedades** para ver sólo a quienes lo pidieron. En una cuenta en modo prueba, el filtro también muestra a quienes marcaron la casilla con un enlace de prueba, con la etiqueta **Aceptó novedades (prueba)**: se ven para que pruebes el filtro, pero nunca reciben novedades. → [Quiero ser cliente](https://docs.pagaconquickpay.com/developers/enlaces-de-pago#quiero-ser-cliente) En condominios esta sección se llama **Propietarios e inquilinos**: cada persona se guarda dentro de una urbanización o complejo, con su tipo (propietario o inquilino) y su unidad (apartamento o casa). En colegios puedes anotar el **grado y sección**; en restaurantes, gimnasios, salud, veterinarias y tiendas, la **sucursal**. ### Buscar, filtrar y descargar La lista de **Clientes** se carga de **50 en 50**: al final pulsas **Ver más**, y el pie dice cuántos hay en total ("Mostrando 50 de 2.500"). Nada se queda fuera por ser muchos: el total es siempre el de lo que coincide con tu búsqueda y tus filtros. Arriba tienes la **búsqueda** (por nombre, teléfono, correo, cédula o referencia), un selector de **segmento**, uno de **etiqueta** y el botón **Filtros**, que abre una ventana con el resto. Lo que filtras aparece como etiquetas que quitas con la **x**; **Limpiar filtros** las quita todas. Los filtros quedan en la dirección de la página: puedes recargarla o compartirla y verás lo mismo. | Filtro | Qué muestra | |---|---| | Etiquetas | Quienes tengan **cualquiera** de las etiquetas que marques | | Tiene suscripción / De qué plan | Quienes tienen una suscripción activa o pausada (en cualquier plan o en uno en particular), o ninguna. Las canceladas y las terminadas no cuentan | | Estado de pago | Al día, pendiente o atrasado, según el último cobro que se le envió ([cómo se calcula](#estado-de-pago-ultimo-pago-y-total-pagado)) | | Fecha del último pago | Un rango de días de Venezuela, ambos incluidos | | Total pagado | Mínimo y máximo, en bolívares o en la divisa de tu panel. Quien nunca ha pagado cuenta como 0 | | Cómo llegó | **A mano**, **Carga masiva** o **Se registró al pagar**. Lo que cargaste antes de que existiera esta distinción aparece como "A mano" | | Aceptan novedades | Sólo quienes lo pidieron al pagar | | WhatsApp / Correo | Con o sin ese dato | | Fecha de alta | Cuándo se agregó a tu lista (días de Venezuela, ambos incluidos) | | Los de tu tipo de negocio | Urbanización o complejo y propietario o inquilino (condominios), sucursal, grado y sección | **Descargar** baja en Excel (.xlsx) o CSV **exactamente lo que estás viendo**, con los mismos filtros: contacto, cédula, referencia, etiquetas, suscripciones activas, de dónde llegó, si acepta novedades, fecha de alta y, si tienes los pagos al día, su estado de pago, último pago, cantidad de pagos y total pagado en bolívares (y en tu divisa). Incluye hasta 20.000 clientes; si hay más, la pantalla te avisa para que afines el filtro. ### Segmentos automáticos Son listas que se arman solas, sin que etiquetes a nadie. Los eliges en el selector de segmento: | Segmento | Quiénes son | |---|---| | **Morosos** | Su último cobro enviado ya venció y no lo pagaron | | **Nuevos (30 días)** | Se agregaron en los últimos 30 días | | **Frecuentes** | 3 pagos o más en los últimos 90 días | | **Aceptan novedades** | Marcaron "quiero recibir novedades" al pagar | | **Sin pagar hace 60 días** | Llevan más de 60 días en tu lista y no han pagado en ese tiempo (incluye a quien nunca pagó) | ### Etiquetas Una **etiqueta** es una marca libre, con color, que le pones a tus clientes: VIP, moroso, referido, el grupo que quieras. Se crean en **Clientes › Etiquetas** (hasta 100, con nombre de hasta 40 letras y 8 colores; "VIP" y "vip" son la misma). Una persona puede tener varias. - **Poner o quitar a uno o a muchos:** marca las casillas de la lista (o elige a todos los que coinciden con tu filtro) y usa **Etiquetar** o **Quitar etiqueta**. Poner una etiqueta que ya tenían no la duplica. - **Filtrar:** por etiqueta en Clientes, en [Suscripciones](https://docs.pagaconquickpay.com/developers/suscripciones#filtrar-y-trabajar-en-grupo) y en [Transacciones](https://docs.pagaconquickpay.com/developers/portal#filtrar-tus-transacciones), y enviar una cobranza **a una etiqueta**. - **Borrar una etiqueta** la quita de todas las personas; las personas no se borran. El **Cobrador** ve las etiquetas de cada cliente y puede filtrar por ellas; crearlas, editarlas, borrarlas y ponerlas es del Propietario y del Administrador. ### Acciones en grupo Marca las casillas de la lista, o la casilla de arriba para elegir **los de esa página**; entonces aparece **"Elegir los N que coinciden"** para elegir a **todos los que cumplen tu filtro**, aunque no estén cargados en pantalla. Con ellos puedes: - **Etiquetar** o **quitar una etiqueta**. - **Enviar cobranza:** te lleva a **Nueva cobranza** con esas personas ya elegidas. - **Suscribir a un plan.** El máximo es de **5.000 personas por acción**. Si eliges más, no se hace una parte en silencio: te dice cuántas son y te pide afinar el filtro o hacerlo por partes. Sólo el Propietario y el Administrador eligen y administran; el Cobrador ve la lista pero no administra. ### Estado de pago, último pago y total pagado En la lista ves, de cada persona, su **estado de pago**, su **último pago** y lo que lleva **pagado** (en la divisa de tu panel, con los bolívares debajo; cada pago se convierte con la tasa BCV de su día de pago). Se calculan así: - **Estado de pago**, según el **último cobro que se le envió** (por Cobranza masiva o Suscripciones): **al día** si lo pagó; **pendiente** si aún no pagó pero el enlace no ha vencido; **atrasado** si venció sin pagarse (y cuántos días lleva vencido). Los cobros anteriores sin pagar no se acumulan. Quien nunca recibió un cobro no tiene estado. - **Último pago** y **total pagado** suman sólo los pagos que podemos **ligar a la persona**: los cobros que le enviaste desde Cobranza masiva o Suscripciones, quienes se registraron al pagar y quienes se suscribieron por enlace. Un cobro suelto (el que creas en **Cobrar**, o un pago en tu página sin que la persona se registre) no trae un cliente y **no cuenta**: no adivinamos quién pagó por su nombre o su teléfono. - Los pagos de prueba sólo cuentan si tu cuenta está en modo prueba. - Se actualiza solo, a los pocos minutos de cada pago. ### Carga masiva desde Excel Pulsa **Carga masiva** y sube un Excel (.xlsx) o un CSV de hasta 2.000 filas. Reconocemos estas columnas por su nombre: | Columna | Obligatoria | También se puede llamar | |---|---|---| | nombre | Sí | cliente, razón social, socio | | whatsapp | Uno de los dos | teléfono, celular | | correo | Uno de los dos | email | | cedula | No | documento, rif | | referencia | No | contrato, apartamento, código | | monto | No | deuda, saldo, total | | moneda | No | divisa. Bs (o VES), US$ (USD, dólares) o € (EUR, euros); si falta, Bs | | concepto | No | descripción, detalle | Pulsa **Descargar plantilla** para bajar un Excel con las columnas exactas de tu tipo de negocio y una fila de ejemplo. Según el negocio se agregan: **tipo** (propietario o inquilino) y **complejo** en condominios, que debe existir ya en Urbanizaciones y complejos; **sucursal** donde hay sucursales; **grado** en colegios. Antes de guardar ves cada fila con su error, si lo tiene. Si vuelves a subir la planilla, los clientes que ya existen (mismo WhatsApp, correo o referencia) **se actualizan, no se duplican**. ## Cobranza masiva En **Cobranza masiva** le envías el cobro a muchos clientes de una vez: - **Desde un Excel:** cada fila con su monto (o un monto general para las que no traen). - **A tus clientes:** los eliges de la lista (con búsqueda y de 50 en 50; **Elegir todos los que coinciden** toma a todos los de tu búsqueda, no sólo los que ves) y pones el monto o un producto del catálogo. - **A una etiqueta:** el envío sale a todos los que tengan esa etiqueta **en el momento de enviar**. - **Desde Clientes:** elige a las personas allá (o a todos los de un filtro) y pulsa **Enviar cobranza**: la ventana se abre con ellas elegidas. La ventana **Nueva cobranza** tiene dos pasos. **Paso 1, qué cobras:** el monto (en **Bs, US$ o €**; en dólares o euros se convierte a bolívares a la tasa BCV del momento del envío), el concepto, cuándo sale y cuándo vence; en **Más opciones** van el nombre del envío, la sucursal y la cuenta. **Paso 2, a quién:** tus clientes, una etiqueta o el Excel, el canal y un resumen antes de enviar. Un envío a clientes admite hasta **5.000 personas**; con más, te pide dividirlo en lugar de dejar a alguien fuera. El paso 1 debe estar completo para pasar al 2. Eliges el canal (**WhatsApp, correo o los dos**), cuándo sale (**ahora o en una fecha y hora**) y cuándo vence. En el detalle de cada envío ves por dónde le llegó a cada cliente y **quién ya pagó**. Puedes filtrar a quién enviar por urbanización o complejo y por propietario o inquilino (condominios), y asignar el envío a una sucursal. En **Transacciones** filtras luego por esos mismos datos. Si tienes más de una cuenta, en **¿Dónde recibes estos pagos?** eliges una para todo el envío. Si dejas **Según la sucursal**, cada cobro cae en la cuenta de la sucursal del envío (o de la sucursal de cada cliente) y, si no tiene, en la principal. Las suscripciones siguen la misma regla con la sucursal de cada suscriptor. En la lista de cobranzas, el total de cada lote sale en la [divisa de tu panel](https://docs.pagaconquickpay.com/developers/portal#divisa-del-panel) con los bolívares debajo (con «≈» cuando incluye precios en otra moneda o el lote aún no sale, porque se cobra a la tasa del envío). > **WhatsApp usa el cupo de tu plan.** Si se acaba y el cliente tiene correo, el cobro le llega por correo. El correo no tiene límite. Tu cupo y los planes están en **Ajustes › Tu plan**. # Suscripciones Para lo que cobras siempre igual: el plan de internet, la mensualidad del gimnasio, la cuota del condominio. > **Restaurantes:** esta sección no está disponible en el portal de un restaurante, porque no tiene cobros recurrentes. 1. Crea un **plan**: nombre, monto (en bolívares, dólares o euros; en dólares o euros, cada período se cobra en bolívares a la tasa BCV de ese día) y cada cuánto se cobra (semanal, quincenal, mensual, trimestral o anual). 2. Agrega **suscriptores** desde tus clientes, eliges por dónde les llega (WhatsApp, correo o los dos) y la fecha del primer cobro. En cada fecha, a partir de las 8:00 a. m. (hora de Venezuela), le enviamos el cobro a cada suscriptor y paga desde cualquier banco con la clave del suyo. > **No es un débito automático.** Nadie le debita a tu cliente sin que él lo apruebe: en cada período le llega el cobro y él lo paga. ## Cuándo termina Una suscripción puede terminar en una **fecha** o tras una **cantidad de cobros** (por ejemplo, mensual por 6 meses). En la lista ves "Termina el …". Después del último cobro queda **Finalizada**: no se genera ningún cobro más ni se envía ningún recordatorio. Para volver a cobrarle, agrégalo otra vez al plan. Los suscriptores y los planes están en dos pestañas: **Suscriptores** y **Planes**. ## Recordatorios Cada plan trae **Recordatorios** encendidos (los apagas en la tarjeta del plan): - **3 días antes del cobro**, un correo: "Tu próximo cobro de es el ". No aplica a planes semanales. - **Si a las 24 horas no ha pagado**, le reenviamos el mismo enlace; si al cobro le queda menos de un día, le enviamos un último recordatorio. - **Como mucho dos recordatorios** después del cobro, sólo entre las 8:00 a. m. y las 8:00 p. m. (hora de Venezuela), y se detienen en cuanto paga. Llegan por correo a quien eligió recibir el cobro por correo. Si activas **WhatsApp** en el plan (viene apagado), también se reenvía el cobro pendiente por WhatsApp, y cada mensaje cuenta en tu cupo. En la lista de suscriptores ves el último recordatorio de cada uno. ## Lo que puedes hacer - Pausar, reanudar o cancelar una suscripción. - Editar el plan: el cambio aplica desde el próximo cobro. - Ver los envíos de cada fecha en **Cobranza masiva** (con quién pagó). - Todo lo de abajo: [resumen y métricas](#resumen-y-metricas), [estado de pago](#estado-de-pago), [filtros y acciones en grupo](#filtrar-y-trabajar-en-grupo), [editar a un suscriptor](#editar-a-un-suscriptor), [su historial](#historial-de-cobros) y [el enlace para que se suscriban solos](#enlace-para-que-se-suscriban-solos). Si un cliente no paga un período, el siguiente le llega igual: los cobros no se acumulan en uno. ## Resumen y métricas Arriba de la pantalla ves cuatro tarjetas: **Activas** (con cuántas están pausadas y finalizadas), **Al día**, **Atrasadas** y **Cobrado este mes**, en la [divisa de tu panel](https://docs.pagaconquickpay.com/developers/portal#divisa-del-panel) con los bolívares debajo. "Cobrado este mes" suma lo pagado en el mes (días de Venezuela) por cobros de suscripciones. La pestaña **Métricas** agrega, para el mes en curso: - **Ingreso mensual recurrente:** lo que cobran en un mes típico tus suscripciones **activas**, con el precio que de verdad se les cobra (descuentos incluidos). Cada frecuencia se lleva a mes: semanal ×4,35, quincenal ×2,03, mensual ×1, trimestral ÷3, anual ÷12. Es una proyección: se convierte a tu divisa con la tasa BCV de **hoy** (por eso lleva «≈»). - **Morosidad:** las suscripciones atrasadas entre las activas, en porcentaje. - **Altas y bajas:** las suscripciones nuevas del mes y las **canceladas**. Las bajas se cuentan desde que se empezó a llevar el historial de cambios; la pantalla dice desde cuándo. - **Cobrado vs esperado:** *esperado* es lo que salió en cobros este mes (convertido a la tasa del día del envío, con «≈»); *cobrado* es lo que ya pagaron de esos mismos cobros. ## Estado de pago Cada suscriptor tiene un estado de pago, según el **último cobro que se le envió**: - **Al día:** lo pagó. - **Pendiente:** aún no lo paga pero su enlace no ha vencido, o todavía no le ha tocado ningún cobro. - **Atrasado (N días):** el enlace venció sin pagarse; N son los días que lleva vencido. Los cobros anteriores que no pagó no se acumulan: si pagó el último, está al día. El estado sale de los pagos que confirma el banco y se actualiza solo, a los pocos minutos de cada pago. ## Filtrar y trabajar en grupo La lista de suscriptores se carga de **50 en 50** (**Ver más**) con el total exacto de lo filtrado. Filtras por **estado** (activas, pausadas, finalizadas), **plan**, **estado de pago**, **etiqueta** del cliente y **con descuento**, y buscas por nombre, teléfono, correo, referencia o plan. Los filtros quedan en la dirección de la página. Las [etiquetas](https://docs.pagaconquickpay.com/developers/clientes-y-cobranza#etiquetas) son las de Clientes: se ponen a la persona, no a la suscripción. Marca las casillas, o elige **todos los que coinciden** con tu filtro, y puedes: **pausar**, **reanudar**, **cambiar de plan**, **etiquetar** o **quitar una etiqueta**. Cada acción dice cuántos se cambiaron y cuántos no (por ejemplo, a quien no estaba activa no se le puede pausar). **Descargar** baja en Excel o CSV lo que estás viendo, con su estado de pago y su descuento, hasta 20.000 filas. Las suscripciones las administran el Propietario y el Administrador; el Cobrador no las ve. ## Editar a un suscriptor El lápiz de cada fila abre **Editar suscriptor**, con tres bloques que se guardan por separado: - **Cambiar de plan.** La suscripción pasa al plan nuevo **desde su próximo cobro**: ese cobro sale con el precio del plan nuevo. **No hay prorrateo:** no se cobra ni se acredita ninguna diferencia del período en curso, y el cobro que ya salió queda como salió. Se conservan la fecha del próximo cobro, el fin y la cuenta de cobros. Si la persona **ya está** en el plan nuevo, o ya estuvo y se canceló o terminó, no se puede cambiar: cancela esta suscripción y agrégala al plan nuevo desde **Agregar suscriptores** (si ya tuvo ese plan, se reactiva). Un descuento fijo o un precio especial se quitan al cambiar (se fijaron con el precio del plan anterior); un descuento en % se conserva. - **Precio especial o descuento.** Para un suscriptor en particular: un **descuento en %**, un **descuento fijo** (en la moneda del plan) o un **precio especial** que reemplaza al del plan, con un **motivo** opcional. Se aplica a **cada cobro que se genere desde ese momento**, y el monto final nunca baja de 0,01: el descuento en % va hasta 99,99 y el fijo tiene que ser menor que el precio del plan. Si después bajas el precio del plan y el cobro de un suscriptor quedaría en cero, ese período no se envía. Ves el descuento en la lista, y puedes quitarlo en cualquier momento. - **Envío y fechas:** por dónde le llega el cobro (WhatsApp, correo o los dos) y la fecha del próximo cobro. Cada cambio queda en el [historial](#historial-de-cobros) del suscriptor. ## Historial de cobros El botón del reloj abre el **historial** de un suscriptor: cada cobro que se le generó, con su **fecha**, **monto**, **estado** (pagado, esperando pago, vencido, cancelado…), **referencia** del pago y **código de verificación QP**. Debajo, los cambios de su suscripción: pausas, cambios de plan y de descuento. El estado de cada cobro lo dice el switch; si no responde en ese momento, el estado se deduce de lo que ya sabemos y se marca como tal. ## Agregar suscriptores a un plan **Agregar suscriptores** abre una lista de tus clientes con búsqueda y de 50 en 50 (también puedes filtrar por etiqueta). Para el plan que elegiste: - Quien **ya está en ese plan** sale deshabilitado, con **Ya suscrito**. - Quien está en **otro plan** sale con ese plan (**En Plan 50mb**) y se puede elegir. - **Elegir todos** toma a todos los que coinciden con tu búsqueda, menos los que ya están en el plan. Admite hasta 5.000 por vez. Si cancelaste a alguien o terminó su plan, al agregarlo de nuevo se reactiva con la fecha y el fin nuevos. ## Enlace para que se suscriban solos Cada plan puede tener un **enlace de suscripción** (en la tarjeta del plan, pestaña **Planes**, interruptor **Enlace para suscribirse solo**). Lo copias y lo compartes por donde quieras. Quien lo abre: 1. **Elige su plan** entre los que tienen el enlace encendido, y deja su **nombre**, su **WhatsApp o correo** (al menos uno) y, si quiere, su cédula o RIF. 2. **Paga el primer cobro** desde su banco. Si el plan está en dólares o euros, se cobra en bolívares a la tasa BCV del día. El enlace de pago dura 24 horas. 3. **Queda suscrito sólo cuando el pago se confirma.** Al volver del banco, la misma página espera la confirmación y se lo dice, con la fecha de su próximo cobro. Si no paga, no queda suscrito ni se crea nada. Si ya estaba en tus clientes (mismo WhatsApp o correo y sin una cédula distinta), se usa su ficha y no se duplica; si no, se crea y aparece como **Se registró al pagar**. Enviar el formulario dos veces no crea dos cobros. El primer cobro cuenta como el primero del plan, y el siguiente le llega en la fecha que toca. Si el pago confirmado no cuadra con el cobro (otro monto), la suscripción no se activa por su cuenta. Un pago de prueba nunca suscribe a nadie en una cuenta que ya cobra de verdad. **Cambiar por un enlace nuevo** deja de servir el anterior; apagar el interruptor deja el plan fuera del enlace. # Productos Tu catálogo: lo que vendes con su precio, en bolívares, dólares o euros. - Lo creas en **Productos** (nombre, precio y una descripción opcional). - Al crear un cobro, **Elegir del catálogo** te deja tomar varios productos con su cantidad: el monto y el concepto se llenan solos. - También los usas en la cobranza masiva. Un producto no se borra: se **archiva**, para que los cobros viejos lo sigan nombrando. Un cobro va en una sola moneda: no mezcla productos en monedas distintas. Al cobrar un producto en dólares o euros se convierte a bolívares a la tasa BCV del momento. ## Importar el menú con IA (restaurantes) En **Menú y productos**, **Importar menú con IA** lee una foto (JPG, PNG o HEIC), un PDF o un Excel o CSV de tu menú y arma la lista con nombre, descripción, precio y moneda. Antes de guardar revisas todo: corriges o descartas filas. Si un producto ya está en tu catálogo con el mismo nombre y precio, no se repite. Hasta 5 archivos de 9 MB. # Propinas Para **restaurantes y comida**. Tu cliente puede agregar propina al pagar: se suma al pago y se debita **en un solo débito**, a la misma cuenta que el pago. ## Activarlas En el portal, ve a **Propinas** y enciende **Pedir propina al pagar**. Eliges: - **Dónde se pregunta:** en la página de pago (enlace, QR y botón web), en el pago por WhatsApp, o en los dos. - **Los botones:** hasta 4. Cada uno en dólares, en euros, en bolívares o en porcentaje del pago. Vienen **US$ 1, US$ 2 y US$ 5**; los montos en dólares se convierten a bolívares a la tasa BCV del dólar del momento del pago, y los montos en euros a la tasa BCV del euro. Si el cobro se creó en dólares o en euros, los botones en esa misma divisa usan la tasa con que se creó el cobro. Al lado de cada botón ves cuánto es hoy en bolívares. - **El tope:** nadie puede agregar más que ese porcentaje del pago (10 %, 20 %, 30 %, 50 % o 100 %). **Otro** (tu cliente escribe el monto) y **Sin propina** siempre aparecen. ## Qué ve tu cliente Antes de elegir su banco ve **¿Quieres agregar propina?** con tus botones (por ejemplo **US$ 1 · Bs 36,50** o **€ 1 · Bs 39,80**), **Otro** y **Sin propina**. Si elige una, el monto a pagar pasa a ser el del cobro más la propina, y su comprobante muestra las dos líneas: **Monto** y **Propina**. Si en ese momento no tenemos la tasa BCV del dólar, los botones en dólares no aparecen; si no tenemos una tasa del euro confiable, los de euros tampoco. Los de bolívares, los de porcentaje, **Otro** y **Sin propina** siempre aparecen. ## Qué recibes - En **Propinas** ves las propinas recibidas por fecha y sucursal, con el total y el promedio. - En **Transacciones**, el detalle de cada pago muestra la **Propina** y el **Total pagado por el cliente**. La descarga en Excel o CSV trae la columna **Propina (Bs)** y, si tu divisa es dólares o euros, también la propina en esa divisa. En la pestaña **Recibidas** los montos salen en la [divisa de tu panel](https://docs.pagaconquickpay.com/developers/portal#divisa-del-panel) con los bolívares debajo. - Desde tu sistema, el enlace y el aviso `link.pagado` traen `propina` y `total` (`monto` sigue siendo el del cobro). → [Glosario](https://docs.pagaconquickpay.com/developers/glosario) La comisión de QuickPay se calcula sobre lo debitado (pago más propina) y, con liquidación inmediata, la propina te llega junto con el resto del pago. ## Reglas - **El monto del cobro no cambia.** La propina va aparte. - **La propina la valida QuickPay**, no la página: no puede ser negativa, lleva hasta dos decimales y no pasa del tope. Si apagas las propinas, nadie puede agregar una, ni con un enlace viejo. - Sólo en cobros en bolívares. # Botón para tu web Un botón **Pagar con QuickPay** que pegas en cualquier página, sin programar. 1. En el portal, ve a **Integraciones › Configura tu botón**. 2. Elige el texto del botón y, si quieres, un monto fijo, un concepto, una sucursal y la cuenta donde caen sus pagos (si tienes más de una). Sin elegir, la de la sucursal o la principal. 3. Copia el código y pégalo en tu web (WordPress, Wix, una tienda o HTML propio). El botón lleva a tu [página de pago](https://docs.pagaconquickpay.com/developers/pagina-de-pago) con el monto y el concepto que elegiste. Si no fijas monto, tu cliente escribe cuánto paga. > **¿Necesitas un monto distinto por pedido?** Entonces crea un enlace por pedido desde tu sistema: → [Enlaces de pago](https://docs.pagaconquickpay.com/developers/enlaces-de-pago). ## Botón en una sola línea: `boton.js` Si ya tienes el enlace de cobro (el `id` que devuelve `POST /links`, o el `slug` de tu comercio), pega esto donde quieras que aparezca el botón: ```html ``` Cambia `ID_O_SLUG` por el `id` del enlace (por ejemplo `3f2c9a1e-5b7d-4e21-9c0a-8d4f6b1a2e37`) o por el slug de tu comercio (por ejemplo `mi-comercio`). El botón **Pagar con QuickPay** aparece justo ahí y abre el pago en una pestaña nueva: - Con un `id`, abre la [página de pago](https://docs.pagaconquickpay.com/developers/pagina-de-pago) de ese enlace, `https://pay.pagaconquickpay.com/l/`. - Con un `slug`, abre la página de cobro de tu comercio, `https://pagaconquickpay.com/pay/`. Atributos opcionales: | Atributo | Para qué | Valores | |---|---|---| | `data-texto` | Cambiar el texto del botón | Texto plano, hasta 40 caracteres. Por omisión, `Pagar con QuickPay` | | `data-abrir` | Abrir en una ventana emergente en vez de una pestaña | `ventana`. Si el navegador la bloquea, se abre la pestaña de siempre | Un botón por etiqueta `` pinta el botón **Pagar con QuickPay** y abre el pago en una pestaña (o en una ventana con `data-abrir="ventana"`). No usa llaves ni ejecuta nada de lo que escribas en los atributos. → [Botón para tu web](https://docs.pagaconquickpay.com/developers/boton-de-pago) - **Página de estado de los cobros:** [/estado](https://docs.pagaconquickpay.com/estado) y [/estado.json](https://docs.pagaconquickpay.com/estado.json) ahora muestran el estado de los cobros con débito inmediato (operativo, degradado, caído o sin datos recientes), con la hora de actualización, y los incidentes de los últimos 7 días. No se nombra a los bancos. Sin llave. - **`failure_url`:** la guía [Volver a tu web](https://docs.pagaconquickpay.com/developers/volver-a-tu-web) ya describe exactamente los tres casos (`expirado`, `cancelado` y `rechazado`), también cuando el cobro vence o se cancela mientras tu cliente está pagando. ## 10 de octubre de 2026 (segunda auditoría de seguridad) - **Un cobro `ACEPTADA` se confirma con el banco antes de devolverlo.** `POST /switch/v1/reintegro` sobre un cobro en `ACEPTADA` consulta al banco en ese momento y sólo devuelve si queda `LIQUIDADA`. Si el banco todavía no lo confirma, responde **409 `cobro_no_confirmado_banco`**: no es definitivo, vuelve a intentarlo más tarde. - **Un reintento a la vez por cobro:** si llega un `retry_nonce` mientras otro intento de reintegro del mismo cobro está en curso, responde **409 `reintegro_en_curso`** y no emite otro pago. - **Liquidación en revisión:** si el pago de ese cobro a tu cuenta quedó en revisión después de enviarse, el reintegro también responde **409 `cobro_ya_liquidado_al_comercio`**. - **Pedir la clave de pago:** las solicitudes que el banco rechaza (cédula o teléfono mal escritos) ya no cuentan para los topes, y el tope por pagador se aplica al par cédula + teléfono (antes, a cualquiera de los dos). En producción se suma un tope de 10 solicitudes cada 10 minutos por conexión. El conteo es atómico: varias solicitudes simultáneas no se saltan el tope. → [Límites](https://docs.pagaconquickpay.com/developers/limites-y-reglas) - **Enviar dos veces el pago:** el segundo envío espera al primero durante todo el plazo de respuesta del banco (antes, 90 s fijos) y responde `procesando` sin mandar el cobro a revisión. - **Webhooks:** `POST`, `PATCH` y `DELETE /switch/v1/webhooks` exigen una `sk_live_` (con `sk_test_`, `403` `requiere_llave_live`): el webhook recibe también los avisos de producción. Listar y ver los webhooks sigue funcionando con cualquier llave, y el portal permite registrar la URL sin llave de producción. → [Webhooks](https://docs.pagaconquickpay.com/developers/webhooks-referencia) - **Historial de entregas con `sk_test_`:** `GET /switch/v1/webhooks/:id/deliveries` sólo lista las entregas de avisos de prueba (`data.mode: "test"`). Las de producción, y los avisos `transaccion.*`, sólo se ven con una `sk_live_`. → [Webhooks](https://docs.pagaconquickpay.com/developers/webhooks-referencia) - **Flows:** `POST /switch/v1/flow/config` y `PUT /switch/v1/flows/definicion` exigen siempre `sk_live_` (antes sólo si ya tenías un Flow de producción). → [Llaves y entornos](https://docs.pagaconquickpay.com/developers/llaves-y-entornos) - **Lotes de dispersión:** `GET /switch/v1/dispersiones/:id` y `POST /switch/v1/dispersiones/:id/cancelar` responden **404** si el lote es de otro modo que tu llave. - **Llaves:** al crear una llave por API, el `label` no puede empezar por `service-key:` ni `partner:`; responde `400` con `label_reservado`. → [Llaves y entornos](https://docs.pagaconquickpay.com/developers/llaves-y-entornos) - **Cobro por WhatsApp Flow:** un binding con `monto_fijo` ya no cobra si el Flow manda otro monto (antes cobraba el fijo sin avisar). Nuevo modo opcional `exigir_monto_firmado`: tu bot firma el monto de cada orden en el `flow_token` con un `monto_secret` que sólo vive en tu servidor. Sin estas opciones nada cambia. ## 10 de octubre de 2026 (operaciones sobre una transacción) - **El modo de la llave manda:** `POST /switch/v1/consultar` y `POST /switch/v1/reintegro` responden **404** si el `id` es de otro modo que tu llave (una llave de prueba no consulta ni devuelve un cobro real, y al revés). - **`retry_nonce` del reintegro sólo reintenta lo que el banco rechazó sin mover dinero.** Si un intento anterior quedó sin respuesta clara (`DESCONOCIDA`, `PENDIENTE`, `ERROR` o un código técnico), responde **409 `reintegro_intento_ambiguo`** y no se emite otro pago hasta conciliarlo. Si ningún intento anterior existe, **409 `reintegro_sin_intento_previo`**: el primer intento va sin `retry_nonce`. Si alguno ya pagó, sigue siendo **409 `reintegro_ya_pagado`**. - **No se reintegra un cobro que ya se te liquidó:** con liquidación inmediata, si el pago de ese cobro a tu cuenta está en curso o hecho, el reintegro responde **409 `cobro_ya_liquidado_al_comercio`**. ## 10 de octubre de 2026 (seguridad) - **`POST /switch/v1/pagar` y `POST /switch/v1/dispersiones`** debitan una cuenta de QuickPay: con una llave de comercio sin habilitación responden `403` con `{ "error": "pagar_no_habilitado" }`. → [API directa](https://docs.pagaconquickpay.com/developers/api-directa) - **`GET /switch/v1/saldo` y `GET /switch/v1/movimientos` pasan a uso interno**: responden `403` `cuenta_no_permitida` a las llaves de comercio. Lo tuyo lo ves en Transacciones y Cartera. - **Verificar un comprobante** trae `concepto`, `referencia_externa` y cuántas veces se ha verificado el código (`verificaciones`, `primera_verificacion`). Lo que ya leías no cambia. → [Verificar un comprobante](https://docs.pagaconquickpay.com/developers/enlaces-de-pago#verificar-un-comprobante) - **Límite de peticiones:** las peticiones sin llave, o con una llave que no es válida, se cuentan por la IP de quien llama, y nunca contra el cupo de un comercio. - **Errores `500`** responden `{ "error": "error_interno" }`, sin el detalle interno. ## 10 de octubre de 2026 (seguridad de llaves y webhooks) - **Llaves:** una llave de prueba (`sk_test_`) sólo crea y revoca llaves de prueba. Crear o revocar una de producción exige una `sk_live_`; si no, `403` con `requiere_llave_live`. → [Llaves y entornos](https://docs.pagaconquickpay.com/developers/llaves-y-entornos) - **Webhooks:** la URL tiene que llegar a una dirección pública (una de red interna responde `422` con `destino_bloqueado`), no seguimos redirecciones (una `3xx` cuenta como no entregada) y hay un máximo de 10 webhooks por comercio (`409` con `limite_webhooks`). El historial de entregas trae el campo `error`. → [Webhooks](https://docs.pagaconquickpay.com/developers/webhooks-referencia) ## 10 de octubre de 2026 (prueba y producción separadas) - **Cada llave sólo ve y toca lo de su modo.** Con `sk_test_` ya no se consultan, listan, editan ni cancelan enlaces, lotes, órdenes, suscripciones, productos, propinas ni miembros del equipo creados con `sk_live_` (responde `404`), y al revés. `GET /links` sin `mode` trae sólo los del modo de tu llave. → [Llaves y entornos](https://docs.pagaconquickpay.com/developers/llaves-y-entornos) - **`idempotency_key` por modo:** la misma llave en prueba y en producción crea dos objetos distintos; con `sk_live_` nunca recibes un enlace, lote u orden de prueba. Nuevo `409 idempotency_key_en_uso` si la llave choca con una usada en el otro modo. → [No duplicar cobros](https://docs.pagaconquickpay.com/developers/enlaces-de-pago) - **Página de pago:** pedir la clave de pago tiene tope (5 por hora por cobro; en producción, con los mismos datos, 3 cada 10 minutos y una por minuto). Si tu cliente envía dos veces el pago, el segundo envío espera al primero en vez de dejar el cobro en revisión; y un cobro en `revision` que el banco termina de confirmar o rechazar se cierra solo. → [Límites](https://docs.pagaconquickpay.com/developers/limites-y-reglas) ## 9 de octubre de 2026 (conciliación de pagos entrantes) - **`POST /switch/v1/conciliar`, `/conciliar/saliente` y `/conciliar/multiple` pasan a uso interno**: responden 403 a las llaves de comercio. Para saber si te pagaron, usa el estado del enlace o el aviso `link.pagado`. - **`ya_conciliado: true` ya no cuenta como pagado**: el banco la responde aunque el monto no coincida. Sólo `conciliado: true` autoriza entregar, y exige el monto exacto y una referencia que no se haya usado antes. Nuevo campo `revision` para los casos que revisa una persona. ## 9 de octubre de 2026 (cuentas demo) - **Inicio y Transacciones en las cuentas de demostración:** lo cobrado (hoy, en el mes y en lo filtrado) suma los pagos simulados, que son los únicos que tiene una demo. En las demás cuentas sigue igual: sólo pagos reales, con «Sin contar N de prueba». → [Portal](https://docs.pagaconquickpay.com/developers/portal#cuentas-personales) ## 9 de octubre de 2026 (Clientes y Suscripciones a escala) - **Clientes y Suscripciones se cargan de 50 en 50** con el total exacto de lo filtrado y **Ver más**. Antes mostraban sólo los primeros 1.000 clientes y 2.000 suscriptores y el resto no aparecía; ahora nada se queda fuera. → [Clientes y cobranza](https://docs.pagaconquickpay.com/developers/clientes-y-cobranza#buscar-filtrar-y-descargar) - **Filtros de Clientes** en la dirección de la página, con etiquetas que se quitan con la **x**: etiqueta, suscripción y plan, estado de pago, último pago, total pagado (en Bs o en tu divisa), cómo llegó, aceptan novedades, WhatsApp, correo, fecha de alta y los de tu tipo de negocio. - **Etiquetas de clientes** con color (se ponen a uno o a muchos) y **segmentos automáticos**: morosos, nuevos (30 días), frecuentes, aceptan novedades y sin pagar hace 60 días. Se pueden usar para filtrar Clientes, Suscripciones y Transacciones, y para enviar una cobranza **a una etiqueta**. El Cobrador las ve y filtra; no las administra. → [Etiquetas](https://docs.pagaconquickpay.com/developers/clientes-y-cobranza#etiquetas) - **Estado de pago, último pago y total pagado** por cliente y por suscriptor, a partir de los pagos confirmados. Cuentan los pagos que se pueden ligar a la persona; un cobro suelto no. → [Estado de pago](https://docs.pagaconquickpay.com/developers/clientes-y-cobranza#estado-de-pago-ultimo-pago-y-total-pagado) - **Acciones en grupo** sobre lo elegido o sobre **todo lo filtrado** (máximo 5.000 por acción; con más, se pide afinar en vez de dejar a alguien fuera): etiquetar, quitar etiqueta, enviar cobranza y suscribir; en Suscripciones, también pausar, reanudar y cambiar de plan. **Descargar** en Excel o CSV lo filtrado. - **Suscripciones:** resumen arriba, pestaña **Métricas** (ingreso mensual recurrente, morosidad, altas y bajas, cobrado vs esperado), **historial de cobros** por suscriptor y **Editar suscriptor**: cambiar de plan **desde el próximo cobro y sin prorrateo**, y **precio especial o descuento** (en %, fijo o precio fijo) con motivo, aplicado a cada cobro que se genere. → [Suscripciones](https://docs.pagaconquickpay.com/developers/suscripciones#editar-a-un-suscriptor) - **Agregar suscriptores:** quien ya está en el plan sale deshabilitado ("Ya suscrito"), quien está en otro lleva su plan como etiqueta y "Elegir todos" respeta eso. Ya no se le pisa el canal a quien ya estaba suscrito. - **Enlace para suscribirse solo:** cada plan puede tener un enlace público donde la persona elige el plan, deja sus datos y paga el primer cobro; **queda suscrita sólo cuando el pago se confirma**. → [Enlace para que se suscriban solos](https://docs.pagaconquickpay.com/developers/suscripciones#enlace-para-que-se-suscriban-solos) ## 9 de octubre de 2026 (cuentas personales) - **Cuentas personales:** quien abre su cuenta con **Para mí** ve un portal más corto: Inicio, Cobrar, Movimientos, Contactos y Ajustes, sin Cobranza masiva, Suscripciones, Productos, Sucursales, Integraciones ni Equipo. → [Cuentas personales](https://docs.pagaconquickpay.com/developers/portal#cuentas-personales) - **Página de pago:** si quien cobra es una persona, la casilla dice «Guardar mis datos para pagarle más rápido a *su nombre*.» y no exige el nombre. En los negocios queda igual. → [Quiero ser cliente](https://docs.pagaconquickpay.com/developers/enlaces-de-pago#quiero-ser-cliente) - **Estado de la cuenta:** Inicio, Cobrar y Ajustes dicen lo mismo: cuenta de demostración, en revisión o, si puedes cobrar, sin aviso. - **Inicio:** las tarjetas dicen «Sin contar N de prueba» cuando hay pagos de prueba. En el detalle de un movimiento, una comisión menor a un centavo se muestra como «< US$ 0,01 (Bs 3,00)». - **Dirección de tu página de pago:** es la misma en todas las pantallas, incluido el registro. ## 9 de octubre de 2026 (comisión general) - **Comisión por cobro:** la comisión general por omisión es **1 %** (antes 2 %). Las cuentas que no tienen una comisión acordada usan la general; las que tienen una acordada la conservan. Tu comisión vigente se ve en **Ajustes › Comisión**. ## 9 de octubre de 2026 (revisión de QA) - **Comisión real:** **Ajustes › Comisión** muestra la comisión que el switch aplica a tu cuenta; si no se puede leer, te pide consultarla con soporte en lugar de mostrar una cifra. En el switch, la comisión acordada por debajo del piso ya no se vuelve a subir al piso (2 %) al verificar o aprobar la cuenta. - **Clientes › Aceptan novedades** en una cuenta de prueba incluye a quienes marcaron la casilla con un enlace de prueba (etiqueta «Aceptó novedades (prueba)»); nunca entran a envíos reales. → [Clientes y cobranza](https://docs.pagaconquickpay.com/developers/clientes-y-cobranza) - **Dividir cuenta:** el total muestra «Total ≈ Bs …» y cada persona su equivalente en bolívares. En tu página de pago, con US$ o €, el pagador ve «Pagarás ≈ Bs … a tasa BCV del …». - **Transacciones:** los pagos de prueba dicen «Pago de prueba» (no «En tu banco») también en Inicio; el detalle muestra el nombre del banco del cliente y el código de verificación; el filtro de monto acepta Bs o tu divisa (se convierte con la tasa de hoy). Propinas › Recibidas sigue el mismo criterio que Transacciones con los pagos de prueba. - **Página de pago:** la lista «Otro banco» muestra el código junto al nombre y la pantalla «Procesando» ya no parpadea cuando el pago se resuelve en menos de un segundo. ## 9 de octubre de 2026 (planes de WhatsApp) - **Tu plan se paga desde el portal:** en **Ajustes › Tu plan**, **Cambiar a …** muestra el precio en US$ y en bolívares a la tasa BCV, abre el pago de QuickPay y el plan se activa solo cuando el pago se confirma. Cada pago da 30 días; al subir de plan los días que te quedaban se suman convertidos al precio del nuevo; bajar de plan se aplica al terminar el período; si no renuevas hay 3 días de gracia antes de volver a Gratis. Te avisamos 3 días antes, el día del vencimiento y el día siguiente. → [Tu plan](https://docs.pagaconquickpay.com/developers/portal#tu-plan) ## 9 de octubre de 2026 (noche, propinas en euros) - **Propinas en euros:** en **Propinas › Ajustes** cada botón puede ser en **€**, además de US$, Bs o %. Tu cliente lo ve como **€ 1 · Bs 39,80**, convertido a la tasa BCV del euro. Si en ese momento no hay una tasa del euro confiable, los botones en € no aparecen; los demás sí. → [Propinas](https://docs.pagaconquickpay.com/developers/propinas) - **Transacciones › Filtros › Pagos rechazados:** muestra los cobros con al menos un intento de pago rechazado (o los que no tienen ninguno), y el detalle del cobro dice cuántos intentos se rechazaron. Un rechazo deja el cobro pendiente para que tu cliente lo intente de nuevo. → [Filtrar tus transacciones](https://docs.pagaconquickpay.com/developers/portal#filtrar-tus-transacciones) ## 9 de octubre de 2026 (tarde) - **Transacciones en dólares o euros:** los filtros y los totales cuentan todos tus cobros, no sólo los últimos 5.000. Cada pago se sigue convirtiendo con la tasa BCV de su día de pago (con «≈» si la tasa es aproximada) y un cobro creado en esa misma divisa cuenta con su monto exacto. → [Filtrar tus transacciones](https://docs.pagaconquickpay.com/developers/portal#filtrar-tus-transacciones) ## 9 de octubre de 2026 (mediodía) - **Divisa del panel:** en **Ajustes › Divisa del panel** eliges ver tus montos en **dólares (por omisión), euros o bolívares**. Inicio (cobrado hoy, este mes, ya en tu banco), Transacciones, Propinas, los lotes de Cobranza y el aviso de pago salen en esa divisa con **los bolívares debajo, en pequeño**. Cada pago se convierte con la tasa BCV de **su día de pago**, no la de hoy; si la tasa es aproximada (euros de días anteriores) se muestra con «≈». El monto que escribes al cobrar arranca en tu divisa. → [Divisa del panel](https://docs.pagaconquickpay.com/developers/portal#divisa-del-panel) - **Descarga de transacciones:** conserva las columnas en bolívares y agrega las de tu divisa con la **tasa usada** de cada pago. - **Inicio:** «Cobrado este mes» y «Ya en tu banco» ahora suman todos los cobros del mes; antes podían quedarse cortos con más de 200 cobros. ## 9 de octubre de 2026 - **Listar enlaces con filtros:** `GET /links` ahora acepta varios estados separados por coma (`estado=pagado,procesando`), `desde` y `hasta` (fecha del pago o, si no se pagó, de creación), `q` (concepto, nombre de quien pagó, referencia, `id` o código de verificación), `min` y `max` en Bs, `con_propina`, `mode` y `origen`. Sigue devolviendo una lista y lo que ya usabas no cambia. Un valor que no se entiende en uno de los filtros nuevos responde `400` con `parametro`. → [Listar tus enlaces](https://docs.pagaconquickpay.com/developers/enlaces-de-pago#6-listar-tus-enlaces) - **`codigo_verificacion` también al listar** (antes sólo al consultar un enlace). Es `null` si el enlace no está pagado. El SDK trae `listarEnlaces`. - **Pago confirmado más rápido:** cuando el banco nos notifica que un pago en `procesando` se completó, el enlace pasa a `pagado` y sale `link.pagado` en ese mismo momento (antes esperaba la siguiente revisión, hasta 15 segundos después). - **Transacciones en el portal:** con la divisa del panel en bolívares, los filtros se aplican sobre todos tus cobros (ya no sólo sobre los últimos 5.000); en dólares o euros siguen contando tus últimos 5.000. **Cómo se creó** incluye **Suscripción**. → [Filtrar tus transacciones](https://docs.pagaconquickpay.com/developers/portal#filtrar-tus-transacciones) ## 9 de octubre de 2026 (mañana) - **Página de pago en Bs, US$ o €:** quien paga escoge la moneda en que escribe el monto y ve la equivalencia en bolívares a la tasa BCV. El cobro se hace en bolívares con la tasa del momento. → [Tu página de pago](https://docs.pagaconquickpay.com/developers/pagina-de-pago) - **Referencia en €:** si el cobro se hizo con precio en euros, la página de pago muestra el monto en € y la tasa BCV, igual que con US$. ## 9 de octubre de 2026 (madrugada) - **Transacciones con filtros:** por **fecha** (Hoy, Ayer, Últimos 7 días, Este mes, Mes pasado o un rango, en días de Venezuela), **estado**, **búsqueda** (concepto, cliente o referencia), sucursal, cuenta donde cae el dinero, **monto** mínimo y máximo, propina, cómo se creó el cobro y cobros de prueba. Los filtros quedan en la dirección de la página, se quitan con la **x** y muestran cuántos cobros salieron y cuánto suman. **Descargar** baja exactamente lo filtrado. → [Filtrar tus transacciones](https://docs.pagaconquickpay.com/developers/portal#filtrar-tus-transacciones) - Un cobro que el banco está revisando se muestra como **En revisión** (antes decía Procesando). - **Restaurantes sin Suscripciones:** el portal de un restaurante ya no trae planes ni suscripciones, porque no tiene cobros recurrentes. Los demás tipos de negocio no cambian. ## 9 de octubre de 2026 (noche) - **Página de pago, elegir banco:** cinco bancos a la vista (Venezuela, Banesco, Mercantil, Plaza y Bancaribe) y un botón **Otro banco** que abre la lista con el resto, ordenada por código. - **Euros en el portal:** donde pones un monto (Cobrar, Dividir cuenta, Nueva cobranza, planes y productos) ahora eliges **Bs, US$ o €** y ves la equivalencia en bolívares a la tasa BCV. Tu cliente sigue pagando en bolívares. Si no hay una tasa del euro confiable en ese momento, la opción € se deshabilita. → [Cobrar desde el portal](https://docs.pagaconquickpay.com/developers/cobrar-desde-el-portal) - **Dividir cuenta** ahora acepta el total en Bs, US$ o € (antes sólo bolívares). - **Nueva cobranza** en dos pasos: qué cobras y a quién, con resumen antes de enviar. → [Clientes y cobranza](https://docs.pagaconquickpay.com/developers/clientes-y-cobranza) - **"Quiero ser cliente" en la página de pago:** tu cliente puede escribir su nombre y marcar "Quiero ser cliente de *tu comercio* y recibir sus novedades" (desmarcada por omisión). Cuando el pago queda confirmado aparece en **Clientes** con **Se registró al pagar** y **Acepta novedades**, sin duplicar a quien ya tenías. Nuevo filtro **Aceptan novedades** en Clientes. → [Quiero ser cliente](https://docs.pagaconquickpay.com/developers/enlaces-de-pago#quiero-ser-cliente) - **Campo nuevo `pagador.alta_cliente`** (sí/no) al consultar o listar un enlace y en `data` del aviso `link.pagado`. No trae cédula, teléfono ni nombre. Lo que ya leías no cambia. - **Procesando tu pago:** mientras el banco confirma, la página de pago muestra una pantalla de carga en lugar del formulario, no deja reenviar el pago y pregunta antes de salir. Si se recarga, vuelve a esa pantalla. - Si tu cliente escribe su nombre al pagar, lo ves en **Transacciones** y en el correo "Recibiste un pago". ## 9 de octubre de 2026 (tarde) - **Propinas** (restaurantes): tu cliente puede agregar propina al pagar, en la página de pago y en WhatsApp, con tus botones (por omisión US$ 1, 2 y 5 a tasa BCV), **Otro** y **Sin propina**. Se debita junto con el pago en un solo débito. Nueva sección **Propinas** en el portal. → [Propinas](https://docs.pagaconquickpay.com/developers/propinas) - **Campos nuevos `propina` y `total`** al consultar o listar un enlace y en `data` del aviso `link.pagado`. `monto` no cambia: es el del cobro. Sin propina, `propina` es `0` y `total` es igual a `monto`. Lo que ya leías no cambia. - **Una cuenta por sucursal:** cada sucursal puede tener su cuenta; al cobrar con esa sucursal el pago cae ahí (y se puede cambiar en cada cobro). También en cobranza masiva, suscripciones, el botón web y el enlace de tu página (`?sucursal=` y `?cuenta=`). → [Equipo y cuentas](https://docs.pagaconquickpay.com/developers/equipo-y-cuentas) - **Descarga de transacciones:** columna nueva **Propina (Bs)**. ## 9 de octubre de 2026 (mañana) - **Código de verificación en cada comprobante:** el comprobante de un pago exitoso trae un código (`QP-XXXXX-XXXXX`) y la línea "Verifícalo en pagaconquickpay.com/verificar". Cualquiera puede comprobar ahí que el comprobante es auténtico: así una captura editada no pasa. Para ti es un campo nuevo, `codigo_verificacion`, al consultar un enlace `pagado` y en `data` del aviso `link.pagado`; lo que ya leías no cambia. Nuevo `GET /verificar/:codigo` (público, 20 consultas por minuto por IP). Los pagos de prueba también tienen código y la verificación los marca como "Pago de prueba (no movió dinero)". - **Registro de negocios:** ahora pregunta a qué se dedica el negocio (o "Otro"). - **Portal por tipo de negocio:** menú con importación por IA en restaurantes, sucursales, urbanizaciones y complejos en condominios, y filtros por cada uno en Transacciones. - **Suscripciones:** fecha de fin o cantidad de cobros, y pestañas Suscriptores y Planes. - **Carga masiva:** plantilla de Excel para descargar. ## 8 de octubre de 2026 (noche) - **Comercio suspendido:** crear enlaces o lotes responde `403` con `comercio_suspendido`, y un enlace `pendiente` muestra "Este comercio no está recibiendo pagos" sin cobrarle nada a tu cliente. Lo que ya se estaba pagando termina normalmente y lo ya pagado se te sigue liquidando. Detalle en [Errores](https://docs.pagaconquickpay.com/developers/errores). ## 8 de octubre de 2026 (tarde) - **Aviso "Recibiste un pago" por correo** al Propietario y a los Administradores, uno por cobro. Se apaga en **Ajustes › Avisos**. - **Descargar transacciones** en Excel o CSV desde Transacciones, con el filtro que estás viendo. - **Recordatorios de suscripción** por plan: 3 días antes, a las 24 horas y un último aviso; por correo, y por WhatsApp si lo activas. - **Ajustes › Tu plan:** tu plan, tu uso de WhatsApp y los planes disponibles. - **Equipo:** desactivar a alguien o cambiarle el rol cierra su sesión en su siguiente acción. - **Liquidación inmediata activada por etapas:** hoy se aplica a pagos pequeños mientras terminamos las pruebas con dinero real. - **Modo prueba con simulador:** en un cobro de prueba, la clave `11111111` simula un rechazo del banco y `22222222` un pago `procesando` que se aprueba solo a los 30 segundos. Cualquier otra clave de 8 dígitos sigue aprobando. - **Nuevo `POST /links/:id/simular`** (sólo llave `sk_test_`): fuerza `pagado`, `rechazado` o `expirado` sin abrir la página de pago. En producción responde `403`. - **Los avisos `link.pagado` y `link.acreditado` traen `data.mode`** (`test` o `live`), para que tu servidor distinga un pago simulado de uno real. Es un campo nuevo: lo que ya leías no cambia. - **`failure_url` ya funciona:** tu cliente vuelve a esa dirección, con `?estado=expirado`, `cancelado` o `rechazado`, cuando el cobro venció, lo cancelaste o él elige **Cancelar y volver** después de un rechazo del banco. - **Nuevo `POST /links/:id/cancelar`** con tu llave: cancela un enlace sólo si sigue `pendiente` (si alguien ya está pagando, `409`). El SDK trae `cancelarEnlace` y `simularEnlace`. - **Página de estado pública:** [/estado](https://docs.pagaconquickpay.com/estado) muestra en vivo la API, la base de datos, la página de pago, las operaciones con el banco de la última hora y la liquidación inmediata. ## 8 de octubre de 2026 (mañana) - **Portal de comercios renovado:** cobro con monto, página de pago, cobranza masiva, suscripciones, productos, equipo con roles. - **Llaves de API y webhooks desde el portal** (Integraciones): la llave y el secreto se muestran una sola vez. - **Liquidación inmediata (construida, todavía sin activar):** el neto de cada pago irá a tu cuenta y te avisaremos con `link.acreditado`. - **Firma v2 de los webhooks** con marca de tiempo (`x-quicklink-signature-v2` y `x-quicklink-timestamp`) para rechazar avisos reenviados. La firma anterior sigue llegando. - **Enlaces:** `success_url` (con `estado` y `referencia` al volver), `metadata` e `idempotency_key`. - **Documentación verificada contra el código:** se corrigieron "Enlaces de pago" y "Cobrar desde tu bot" (la idempotencia va en el cuerpo, el aviso trae `link_id` y no tus `metadata`, el listado devuelve una lista) y el glosario ahora explica todos los campos. - **Página de pago nueva:** iconos de los bancos, teléfono por prefijo, clave de 8 dígitos y comprobante para guardar o compartir. - **Documentación nueva** con este esquema y el SDK renombrado a `QuickPay` (el nombre `QuickLink` sigue funcionando). ## 16 de septiembre de 2026 - Dominio propio: `pay.pagaconquickpay.com` y `docs.pagaconquickpay.com`. ## 6 de septiembre de 2026 - **Cobro por lote:** hasta 500 enlaces en una llamada, con estado por ítem y cancelación de los pendientes. --- # Conecta QuickPay a tu IA (MCP) Con el servidor MCP de QuickPay, tu asistente de IA (Claude, ChatGPT, Claude Code, Cursor u otro compatible con MCP) crea y consulta tus enlaces de cobro cuando se lo pides con tus palabras: *"Cobra Bs 1.500 por el pedido 1024"*, *"¿Qué cobros tengo pendientes?"*. No copias ninguna llave: pegas la dirección del servidor, entras con el correo de tu comercio y autorizas. ```text https://mcp.pagaconquickpay.com/mcp ``` Para leerlo o compartirlo: [Guía esencial del MCP en PDF](https://docs.pagaconquickpay.com/developers/mcp.pdf). ## Qué puede hacer tu IA Casi todo lo de la [API pública](https://docs.pagaconquickpay.com/developers/referencia): lo que no puede está en la sección siguiente. | Herramienta | Qué hace | Prueba | Producción | |---|---|---|---| | `crear_link_cobro` | Crea un enlace de cobro con monto y concepto (opcional: `moneda`, `expira_horas`, `expira_en`, `idempotency_key`, `success_url`, `metadata`). Crearlo no mueve dinero: el cobro ocurre sólo si alguien lo paga. | Sí | Sí | | `listar_cobros` | Lista tus enlaces, los más recientes primero (20 por omisión, hasta 50 por página). Filtra por estado, fechas, montos o texto (concepto, nombre de quien pagó, referencia bancaria o id). | Sí | Sí | | `ver_cobro` | Muestra un enlace por su id: monto, estado, cuándo se pagó y el código del comprobante. | Sí | Sí | | `cancelar_link` | Cancela un enlace que sigue pendiente. Uno pagado o en proceso de pago no se cancela. | Sí | Sí | | `simular_cobro` | Fuerza el resultado de un enlace de prueba (`pagado`, `rechazado` o `expirado`). → [Modo prueba](https://docs.pagaconquickpay.com/developers/datos-de-prueba) | Sí | No | | `crear_lote` | Crea hasta 500 enlaces de una vez. → [Cobro por lote](https://docs.pagaconquickpay.com/developers/cobro-por-lote) | Sí | Sí | | `listar_lotes` · `ver_lote` | Tus lotes con su resumen, o uno con el estado de cada enlace. | Sí | Sí | | `cancelar_lote` | Cancela los enlaces de un lote que siguen pendientes. | Sí | Sí | | `verificar_comprobante` | Comprueba un comprobante por su código `QP-XXXXX-XXXXX`. | Sí | Sí | | `consultar_estado` | Dice si un pago está confirmado, por el id de la transacción (el `txn_id` de un enlace pagado): `LIQUIDADA`, `ACEPTADA` (en proceso) o `RECHAZADA`. | Sí | Sí | | `listar_liquidaciones` | Tus liquidaciones. | Sí | Sí | | `listar_bancos` | Los bancos desde los que tus clientes pueden pagarte (código y nombre). | Sí | Sí | | `mi_conexion` | Con qué comercio y en qué modo está conectada. | Sí | Sí | | `listar_llaves` | Tus llaves de API, enmascaradas. | Sí | Sí | | `crear_llave` · `revocar_llave` | Crea o revoca una llave de prueba (`sk_test`). La llave completa se muestra una sola vez. → [Llaves y entornos](https://docs.pagaconquickpay.com/developers/llaves-y-entornos) | Sí | No: desde el portal | | `listar_webhooks` · `ver_webhook` · `ver_entregas_webhook` | Tus webhooks (sin el secreto) y sus últimas entregas. | Sí | Sí | **Webhooks: tu IA sólo los ve.** Registrarlos, cambiarlos o borrarlos se hace desde el portal › Integraciones. → [Webhooks](https://docs.pagaconquickpay.com/developers/webhooks-referencia) **En producción, las llaves también sólo se ven:** crearlas o revocarlas se hace desde el portal › Integraciones. Si se lo pides a tu IA, QuickPay responde `403` `solo_desde_el_portal` y tu IA te lo dice. Las herramientas que cambian algo (cancelar, simular, llaves) van marcadas para que tu IA te pida confirmación antes de usarlas. ## Qué no puede hacer **Tu IA no puede enviar, pagar, transferir ni devolver dinero**, ni sacar dinero de ninguna cuenta. Tampoco puede ver tus movimientos o tu saldo, cambiar tus datos o tu cuenta bancaria, registrar o cambiar webhooks, ni, en producción, crear o revocar llaves (eso se hace en el portal). Esas herramientas no existen en el servidor MCP y, además, QuickPay rechaza (`403`) cualquier otra operación hecha con el acceso de una IA, aunque alguien intente usarlo fuera del MCP. ## Cómo se conecta 1. Agregas QuickPay en tu IA con la dirección de arriba (los pasos de cada una están más abajo). 2. Tu IA abre una página de QuickPay en el navegador. Escribe el **correo de tu comercio**, el mismo con el que entras al portal, y te llega un enlace de acceso. 3. Abre el enlace **en el mismo navegador** donde empezaste. Expira en 15 minutos y es de un solo uso. 4. Revisa qué podrá hacer la IA, elige el comercio (si tienes varios) y el modo, y toca **Autorizar**. ### Modo prueba o producción | Modo | Qué pasa | |---|---| | **Prueba** (por omisión) | Los enlaces son de prueba: nadie paga dinero real. Igual que con tu llave `sk_test`. → [Modo prueba](https://docs.pagaconquickpay.com/developers/datos-de-prueba) | | **Producción** | Los enlaces cobran dinero real a quien los pague. Llaves y webhooks sólo se ven (se manejan desde el portal). Sólo se puede elegir si tu cuenta ya está aprobada y la aplicación es conocida (Claude, ChatGPT, Cursor o una de línea de comandos como Claude Code). | Si la página dice **Aplicación no verificada**, la aplicación que pidió el acceso no vuelve a una de las conocidas: sólo se puede conectar en modo prueba. Autoriza sólo si reconoces la dirección que aparece en "Volverá a". Para cambiar de modo, quita el conector y vuelve a conectarlo eligiendo el otro. ## Claude En Claude (web o escritorio), agrega un **conector personalizado** con la dirección `https://mcp.pagaconquickpay.com/mcp`, ponle de nombre *QuickPay* y conéctalo: se abre la página de QuickPay para entrar y autorizar. ## ChatGPT En la configuración de ChatGPT, en **Conectores**, crea un conector con la dirección `https://mcp.pagaconquickpay.com/mcp` y autenticación **OAuth**. Al conectarlo se abre la página de QuickPay para entrar y autorizar. Los conectores personalizados dependen de tu plan de ChatGPT. ## Claude Code ```bash claude mcp add --transport http quickpay https://mcp.pagaconquickpay.com/mcp ``` Luego, dentro de Claude Code, escribe `/mcp`, elige **quickpay** y autentícate: se abre el navegador para entrar y autorizar. ## Cursor Agrega esto a `~/.cursor/mcp.json` (si ya tienes otros servidores, suma sólo `quickpay` dentro de `mcpServers`): ```json { "mcpServers": { "quickpay": { "url": "https://mcp.pagaconquickpay.com/mcp" } } } ``` Cuando Cursor lo pida, entra y autoriza en el navegador. ## Ejemplos Lo que le pides a tu IA y lo que hace. Tu IA redacta la respuesta a su manera; los datos salen de QuickPay. | Le dices | Usa | Te responde | |---|---|---| | *"Cobra Bs 1.500 por el pedido 1024"* | `crear_link_cobro` | El enlace (`https://pay.pagaconquickpay.com/l/…`) para mandárselo a tu cliente, con el monto, el concepto y hasta cuándo vale (24 horas si no le dices otra cosa). | | *"¿Qué cobros tengo pendientes?"* | `listar_cobros` | Tus enlaces pendientes, del más reciente al más viejo, con monto y concepto. | | *"¿Ya pagaron el pedido 1024?"* | `listar_cobros` / `ver_cobro` | Busca el enlace por el concepto y te dice su estado: `pendiente`, `procesando`, `pagado`, `expirado` o `cancelado`; si está pagado, cuándo. | | *"Cancela el enlace del pedido 1024"* | `cancelar_link` | Que quedó `cancelado` y ya no se puede pagar. Si alguien ya lo pagó o lo está pagando, te dice que no se puede. | | *"¿Con qué bancos me pueden pagar?"* | `listar_bancos` | La lista de bancos desde los que tus clientes pueden pagarte. | | *"¿Qué liquidaciones tengo?"* | `listar_liquidaciones` | Tus liquidaciones con su estado y monto. | | *"¿Estás en modo prueba?"* | `mi_conexion` | Tu comercio y si la conexión es de prueba o de producción. | | *"Crea un lote con estas 3 facturas: …"* | `crear_lote` | El lote con un enlace por factura. | | *"Simula que pagaron el enlace de prueba"* | `simular_cobro` | Que el enlace de prueba quedó `pagado` (en producción no se puede). | | *"¿Qué webhooks tengo?"* | `listar_webhooks` | Tus webhooks con su URL, eventos y estado. | | *"Crea una llave de prueba para mi servidor"* | `crear_llave` | La llave `sk_test_…` completa, una sola vez. | | *"¿Es auténtico el comprobante QP-…?"* | `verificar_comprobante` | Si es válido, con el monto y la fecha del pago. | ## Seguridad - **Para quitarle el acceso a tu IA**, quita el conector en tu IA (en Claude Code: `claude mcp remove quickpay`). Para volver a conectarla tienes que entrar y autorizar de nuevo. - El acceso de la IA vale para un solo comercio y un solo modo, los que elegiste al autorizar. - **Una llave de prueba creada desde tu IA sigue funcionando aunque quites el conector.** Revócala con `revocar_llave` o en tu portal › Integraciones › Llaves de API cuando ya no la uses. - QuickPay no guarda los accesos en claro: guarda una huella que sólo sirve para comprobarlos. - Si tu comercio se suspende, o el correo deja de ser el contacto verificado del comercio, el acceso se corta en el acto. - Si alguien intenta conectarse con tu correo, el enlace te llega a ti y sólo funciona en el navegador donde se empezó la conexión: abierto en el tuyo, no le da acceso a nadie. Si no fuiste tú, ignora el correo. ## Con tu llave, sin iniciar sesión Si tu herramienta no soporta el inicio de sesión de MCP (OAuth), puedes mandar tu llave en un header. La IA tiene entonces el modo de la llave (`sk_test` = prueba, `sk_live` = producción) y las mismas herramientas de arriba. ```bash claude mcp add --transport http quickpay https://mcp.pagaconquickpay.com/mcp --header "x-switch-key: :" ``` > Con este método la llave queda guardada en la configuración de tu herramienta. Usa la de prueba mientras pruebas y revócala en tu portal › Integraciones › Llaves de API si se expone. Con el inicio de sesión no hay llave que cuidar. ## Detalles técnicos Para quien construye su propio cliente MCP. El servidor sigue la especificación de autorización de MCP (2025-06-18): | | | |---|---| | Recurso protegido (RFC 9728) | `https://mcp.pagaconquickpay.com/.well-known/oauth-protected-resource` | | Servidor de autorización (RFC 8414) | `https://mcp.pagaconquickpay.com/.well-known/oauth-authorization-server` | | Registro de clientes (RFC 7591) | `POST /oauth/register` | | Autorización | `GET /oauth/authorize`: código de autorización con PKCE `S256` **obligatorio** | | Tokens | `POST /oauth/token`: `authorization_code` y `refresh_token` | | Revocación (RFC 7009) | `POST /oauth/revoke` | - `/mcp` sin token responde `401` con `WWW-Authenticate: Bearer resource_metadata="…"`. - Las `redirect_uri` tienen que ser `https://`, o `http://localhost` / `http://127.0.0.1` para aplicaciones de línea de comandos (en esas el puerto puede cambiar). Sin fragmento. Con una que no sea de `claude.ai`, `claude.com`, `chatgpt.com`, Cursor o loopback, sólo se autoriza modo prueba. - Scope: `cobros` (el único). - El token de acceso dura **1 hora**; el `refresh_token` dura 30 días y cambia en cada uso. Si un `refresh_token` ya usado se presenta otra vez, se revoca la autorización completa. - Si tu comercio se suspende, o el correo deja de ser el contacto verificado del comercio, el acceso se corta en el acto. Si el correo deja de ser el contacto verificado del comercio, se corta al vencer el token de acceso (a más tardar en una hora). - Un enlace de acceso por intento de conexión, y hasta 5 por correo cada 10 minutos. - Hasta 60 llamadas a herramientas por minuto por conexión y 120 por comercio; los listados devuelven hasta 50 resultados por página. - Las herramientas devuelven sólo los campos documentados de cada respuesta ([glosario](https://docs.pagaconquickpay.com/developers/glosario)); un error llega como `error` (código) y `mensaje`. # Usar la documentación con tu IA o sin conexión Si prefieres no navegar página por página, descarga toda la documentación en un solo archivo. Son las mismas guías de este sitio, en el mismo orden, y se actualizan con ellas. | Para | Descarga | |---|---| | Lo esencial, con índice, para leer o compartir | [Guía esencial en PDF](https://docs.pagaconquickpay.com/developers/quickpay-docs.pdf) (unas 30 páginas) | | Toda la documentación junta | [En una sola página](https://docs.pagaconquickpay.com/developers/todo) (se puede imprimir) | | Dársela a Claude, ChatGPT, Cursor u otra IA | [quickpay-docs.md](https://docs.pagaconquickpay.com/developers/quickpay-docs.md) | | Herramientas que leen el estándar `llms.txt` | `https://docs.pagaconquickpay.com/llms.txt` (índice) y `https://docs.pagaconquickpay.com/llms-full.txt` (todo el texto) | Cada guía tiene además su propio botón **Descargar .md** arriba a la derecha. ## Cómo usarla con una IA 1. Descarga `quickpay-docs.md`. 2. Súbelo a la conversación (o a tu proyecto) y pídele lo que necesitas, por ejemplo: *"Con esta documentación, escribe en Node el endpoint que recibe el webhook `link.pagado` y verifica la firma"*. 3. Prueba lo que te entregue con tu llave de prueba `sk_test_…` antes de pasar a producción. → [Modo prueba](https://docs.pagaconquickpay.com/developers/datos-de-prueba) > **Tu llave no va en la conversación.** La IA no la necesita para escribir el código: déjala en tu servidor, en una variable de entorno. Si alguna vez la pegaste en un chat, revócala en tu portal › Integraciones › Llaves de API y crea otra. La referencia técnica de cada endpoint (OpenAPI) está en [Referencia de la API](https://docs.pagaconquickpay.com/docs).