Docs · Referencia Descargar .md

Novedades

16 de octubre de 2026

Conecta QuickPay a tu IA, sin copiar llaves. Agrega https://mcp.pagaconquickpay.com/mcp en Claude, ChatGPT, Claude Code o Cursor, entra con el correo de tu comercio (el del portal) y autoriza. Empiezas en modo prueba; producción se elige al autorizar si tu cuenta está aprobada. Tu IA puede crear, listar, ver y cancelar enlaces de cobro, consultar una transacción y ver tus liquidaciones y los bancos; no puede enviar, devolver ni sacar dinero. Quien ya usaba el MCP con su llave en el header x-switch-key no tiene que cambiar nada. → Conectar por MCP · Guía del MCP en PDF
Menú «IA y MCP» en la documentación, con el MCP, la documentación para tu IA, las guías en PDF y llms.txt.
Respuestas sin datos internos. Con tu llave, POST /switch/v1/cobrar, /cobrar/token, /pagar, /consultar y /reverso ya no traen banco_usado ni raw. Para saber qué pasó sigue estado, y si fue rechazada, motivo_rechazo, que es igual para todos los bancos. El listado y la exportación de GET /switch/v1/transacciones ya no traen la columna banco, GET /switch/v1/config ya no trae rieles y los avisos transaccion.* ya no traen banco. Si leías alguno de esos campos, deja de hacerlo; lo demás no cambia. → API directa
GET /switch/v1/bancos y GET /switch/v1/politica-dinero pasan a uso interno: responden 403 solo_uso_interno a las llaves de comercio. Para comprobar que tu llave funciona usa GET /switch/v1/transacciones?limit=1. La referencia interactiva (/docs, /openapi.json) ya no lista rutas de uso interno.
Toda la documentación en un archivo. Descarga la guía esencial en PDF (portada, índice y lo necesario para empezar), lee todo en una sola página o baja el .md para tu IA (Claude, ChatGPT, Cursor). También publicamos llms.txt y llms-full.txt. → Con tu IA o en PDF

14 de octubre de 2026

Página de pago con success_url: llegada y vuelta más claras. Al abrir el enlace, una pantalla de 2,5 segundos muestra tu comercio, el concepto y el monto, y avisa que el pago lo procesa QuickPay (se salta con Continuar). Al pagar, en vez de un aviso pequeño al final del comprobante, aparece arriba "Volviendo a <tu comercio> en 3 s" con la cuenta regresiva y el botón Volver ahora. Los datos que llegan a tu success_url no cambian. Quien paga con tarjeta (piloto) ahora también vuelve a tu success_url: Credicard lo regresa a la página de pago y de ahí a tu web, con la operación QuickPay como referencia. → Volver a tu web
Avisos transaccion.*: campo nuevo operacion. Dice de qué es la transacción: cobro, pago, reverso, devolucion_debito, devolucion o devolucion_retorno. Así un envío de dinero (la transferencia del neto a tu cuenta, un reintegro o una devolución) ya no llega con la misma forma que un pago que recibiste. Los demás campos no cambian; si entregas con transaccion.liquidada, entrega sólo cuando operacion sea cobro. → Webhooks
Aviso nuevo link.devuelto (piloto). Devoluciones de cobros desde el portal: llega cuando una devolución llegó a tu cliente, con monto (esta devolución) y monto_devuelto (el total devuelto de ese cobro). Las devoluciones están en piloto con algunas cuentas; si no están activas para la tuya, este aviso no llega. → Webhooks
Reintegro con llave en vivo. POST /switch/v1/reintegro con una llave de comercio en vivo (sk_live) responde 403 reintegro_no_habilitado: el reintegro sale de la cuenta de QuickPay, no de la tuya. Con tu llave de prueba (sk_test) sigue funcionando igual.
Página de pago, «Pedir otra clave»: después de pedir una clave nueva, la página le dice a tu cliente que escriba sólo la última que le llegó, porque las anteriores pueden no servir.

13 de octubre de 2026

Cuentas nuevas con aprobación automática nacen con tope. Mientras una persona de QuickPay no revisa el alta, la cuenta puede recibir hasta US$ 300 por día y US$ 1.000 en total (en bolívares, con la tasa oficial del BCV en el momento de cada cobro). Cuando la revisamos, subimos o quitamos el tope. Las cuentas que ya tenían topes, o que aprobó una persona, no cambian. → Límites
Máximo diario por cuenta: cuenta sólo lo que recibes en cobros (antes sumaba también los pagos que te hacemos a tu cuenta, así que el tope se llenaba a la mitad) y el día va de medianoche a medianoche hora de Venezuela (antes cortaba a las 8:00 p. m.). → Límites
Monto máximo por cobro y por día, también en dólares. El monto mínimo y máximo por cobro y el máximo por día que QuickPay le fija a una cuenta pueden estar en dólares; en ese caso se convierten a bolívares con la tasa oficial del BCV en el momento de cada operación. Los que están en bolívares no cambian, y el error sigue siendo EXCEDE_LIMITE (o MONTO_INVALIDO por debajo del mínimo). → Límites
Topes en dólares. El tope de lo que recibes por día y en total también puede estar en dólares. En ese caso se convierte a bolívares con la tasa oficial del BCV en el momento de cada cobro, así que no pierde valor cuando sube el dólar. Los errores y mensajes son los mismos; con tu llave, el 409 de POST /cobrar/token sigue trayendo tope y usado en Bs y agrega topes_moneda, tope_usd y tasa_bcv. Los topes en bolívares no cambian. → Límites
Tope de lo que recibes, por día y en total. QuickPay puede fijarle a una cuenta un tope de lo que recibe por día (hora de Venezuela) y otro en total. Si no tienes, nada cambia. Con el tope lleno, tu cliente no puede pedir la clave de pago: la página de pago y el WhatsApp Flow le muestran el mensaje, y POST /cobrar/token responde 409 tope_diario_excedido o tope_acumulado_excedido. Quien ya tenía su clave termina su pago. → Límites
link.pagado sólo con el pago confirmado por el banco. Antes, un cobro pasaba a pagado y te llegaba link.pagado apenas el banco recibía la orden de débito, aunque todavía no confirmara que el dinero se movió. Ahora espera la confirmación: según el banco de tu cliente, puede llegar en el mismo momento del pago, como antes, o el cobro queda en procesando y link.pagado llega cuando el banco confirma (suele tardar menos de un minuto, pero a veces bastante más). Si el banco termina rechazándolo, el cobro vuelve a pendiente y no llega aviso. Sigue llegando una sola vez por cobro y con los mismos campos. Si tu sistema entrega con link.pagado o con el estado pagado, no tienes que cambiar nada; no entregues con procesando. Los cobros de prueba no cambian. → Estados de un cobro
Página de pago: quien paga desde otro banco ve "Procesando tu pago" hasta que el banco confirma, y luego el comprobante con la referencia bancaria.
transaccion.aprobada sólo con la operación confirmada por el banco. Antes llegaba con ACEPTADA, cuando el banco recibía la orden de débito ("enviada a BCV") y todavía no confirmaba que el dinero se movió. Ahora llega cuando la operación queda LIQUIDADA, una sola vez, junto con transaccion.liquidada, y su data.estado es "LIQUIDADA" (antes "ACEPTADA"). Si entregabas con transaccion.aprobada, ahora entregas con la confirmación del banco; si comparabas data.estado con "ACEPTADA", compáralo con "LIQUIDADA". Con llave de prueba no cambia: el cobro simulado avisa en el acto. → Webhooks
WhatsApp Flow del switch: el mismo cambio. El Flow ya no muestra el pago como hecho apenas el banco recibe la orden: según el banco de quien paga, se confirma en ese momento o ve "Tu pago se está procesando" y el pago se confirma cuando el banco lo liquida. Los Flows de prueba no cambian.
API directa: la guía decía que un cobro ACEPTADA ya era exitoso. No lo es: ACEPTADA es "enviada a BCV"; el cobro está confirmado con LIQUIDADA. → API directa

12 de octubre de 2026

Portal y página de pago: un cobro pagado dice siempre Pagado (antes, si ya se había acreditado, decía «En tu banco»); el detalle del pago sigue indicando si está acreditado o por acreditar. Abrir el enlace de un cobro ya pagado muestra el comprobante con el mismo diseño de cuando se paga, sin datos de quien pagó.
Pago con tarjeta, «No completé el pago»: si la tarjeta fue rechazada o la persona cerró la página de Credicard, en la pantalla «Estamos confirmando tu pago con tarjeta» puede tocar No completé el pago: pagar de otra forma. QuickPay le pregunta a Credicard: si no cobró, el enlace vuelve a estar disponible al instante (antes había que esperar unos minutos); si sí cobró, el enlace queda pagado.
La página de pago recuerda a quien paga: después del primer pago, el teléfono, la cédula y el nombre quedan guardados sólo en el navegador de esa persona, y la próxima vez vienen llenos. Si ya marcó «Quiero ser cliente» de ese comercio, en vez de la casilla ve «Ya eres cliente». «No soy yo» borra los datos guardados (por si el teléfono es compartido). Nada de esto se busca en el servidor.
Pagar con tarjeta (piloto, apagado): la página de pago de un enlace puede ofrecer, además del débito inmediato, Pagar con tarjeta de débito o crédito por Credicard, con la lista de bancos de débito aceptados y el total con el recargo por pago con tarjeta (lo paga tu cliente) antes del botón. Se enciende por comercio; si no está activo para tu cuenta, nada cambia. El enlace sigue pagándose una sola vez y queda pagado sólo cuando Credicard confirma el cobro. El aviso link.pagado de esos pagos trae "metodo": "tarjeta" y recargo_tarjeta; se te liquida lo mismo que con débito inmediato, cuando Credicard abona el pago. → Pagar con tarjeta
Cuenta aprobada al registrarte: al terminar el registro y la verificación con Bs 1, la cuenta queda lista para cobrar dinero real, sin esperar revisión. El equipo de QuickPay revisa cada alta después.
Portal: aviso de mantenimiento de los bancos en el encabezado (desde las 11:30 p. m.); en Estadísticas, tu mejor día y bloque pico en porcentaje y el ticket promedio por horario según tu tipo de negocio.
Bancos en mantenimiento en la página de pago: de 11:45 p. m. a 1:30 a. m. (hora de Venezuela) la página muestra arriba Bancos en mantenimiento y no deja pedir la clave de pago, en vez de dejar que tu cliente llene todo y falle al final. Desde 15 minutos antes avisa, sin bloquear, cuántos minutos faltan. La página se actualiza sola cada 30 segundos. Pedir la clave dentro de la franja responde 503 con { "error": "cierre_bancario", "motivo": "…", "reintentar_en": <segundos> }. Lo que ya estaba en curso termina normalmente y los enlaces de prueba no se afectan. → Cierre diario
Cobro por WhatsApp Flow: en esa misma franja, pedir la clave desde tu Flow de producción vuelve a la pantalla de datos con el mismo mensaje y no le pide nada al banco. Confirmar un pago con una clave ya pedida sigue igual.

11 de octubre de 2026

Nombre comercial en la página de pago: si escribes un nombre comercial en el portal (Ajustes › Tu cuenta), quien te paga lo ve en la página de pago y en el comprobante en lugar de la razón social. La razón social sigue siendo la que usan el banco y la verificación. → Portal
Webhooks, Probar: el aviso de prueba del portal (webhook.test) ahora va firmado igual que los reales: x-quicklink-event, x-quicklink-timestamp y x-quicklink-signature-v2. Antes llevaba sólo la firma anterior, así que un servidor que verifica la v2 como indica esta guía lo rechazaba y el portal decía que no llegó. → Webhooks
Webhooks, Eliminar: el portal permite borrar un webhook (Integraciones › Webhooks › Eliminar) sin llave de producción. → Webhooks
Pago dividido: un enlace puede repartir el neto de su pago entre hasta 5 cuentas además de la tuya, por porcentaje o monto fijo; el resto es tuyo. Se configura con split al crear el enlace, corre con la liquidación inmediata y sólo reparte cuando el banco confirma que el pago entró. Está en piloto detrás de una bandera: si no está activo para tu cuenta, split responde 400 split_no_disponible. → Pago dividido
GET /links/:id de un enlace con reparto trae split y reparto; el aviso link.acreditado trae reparto y llega cuando todo el reparto terminó. Los enlaces sin split no cambian.
Reintegro: si el reparto de un pago ya le pagó a algún beneficiario, responde 409 cobro_con_split_repartido.
Pago dividido, cuentas aprobadas: sólo se reparte a cuentas que apruebas en el portal (Ajustes → Cuentas para pago dividido); las cuentas aprobadas no se cambian con tu llave. Una cuenta sin aprobar responde 400 split_cuenta_no_preaprobada; una que un control de seguridad frena o que pasa el tope diario por beneficiario, 400 split_beneficiario_bloqueado. Antes de pagarle a cada cuenta se revisa otra vez: si ya no pasa, esa parte queda en revisión y no se paga sola. reparto.estado suma cerrado y cada beneficiario puede quedar descartado (se cerró sin pagarle, con una nota). → Pago dividido
Modo prueba: más desenlaces forzados. Además de 11111111 (rechazo) y 22222222 (pendiente y luego aprueba), ahora 11111112 rechaza por fondos insuficientes, 11111113 por clave inválida, 11111114 simula banco no disponible y 33333333 tarda unos 8 segundos en confirmar y luego aprueba. Los rechazos no envían webhook y las aprobaciones envían link.pagado con "mode": "test", igual que en producción. Sólo existen con una llave sk_test_; en producción no hacen nada especial. → Modo prueba
Botón de pago en una línea: <script src="https://pay.pagaconquickpay.com/boton.js" data-link="ID_O_SLUG"></script> 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
Página de estado de los cobros: /estado y /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 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
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
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
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
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
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
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
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
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

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

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

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

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

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

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

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

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

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