Docs · Referencia Descargar .md
Novedades
19 de noviembre de 2026
- Cuentas personales: Cobranza masiva. Una cuenta personal ya puede enviar un cobro a muchas personas, ahora o programado, desde un Excel o desde sus Contactos (Carga masiva y Enviar cobranza), y bajar el reporte de Cobranza masiva. Funciona igual que en un negocio: mismo monto mínimo de WhatsApp, mismo tope de envíos y mismos límites de la cuenta. La API no cambia. → Portal
14 de noviembre de 2026
- Más margen para cobrar: US$ 5.000 por día. El máximo por día y el tope de lo que recibes por día de las cuentas activas quedan en US$ 5.000, en dólares. Las cuentas activas ya no tienen tope en total. Si tu cuenta ya tenía más por día, se mantiene; el máximo por cobro no cambia. Las cuentas nuevas nacen con US$ 5.000 por día, sin tope en total ni por cobro. La API no cambia. → Límites y reglas
13 de noviembre de 2026
- Página de pago: tu cliente puede pegar la clave. Si copia la clave de 8 dígitos del mensaje de su banco, la pega en cualquier casilla y se llenan las 8; si su navegador lo permite, también puede usar el botón «Pegar clave». Si lo copiado trae más de un número de 8 dígitos, no se llena nada para no poner una clave equivocada, y la escribe a mano. Antes había que escribirla dígito por dígito. La API no cambia.
- Página de pago: tu cliente sabe enseguida cuando el banco no completa el pago. Si el banco rechaza la operación en la liquidación, la página se lo dice en segundos («El banco no completó tu pago»), en vez de quedarse en «El banco está tardando en confirmar». Y si a los 10 minutos el banco no confirma, la página le dice que no pudimos confirmar su pago y que, si necesita resolver su compra ya, se comunique contigo o con nosotros con la referencia de la página (los 8 primeros caracteres del
iddel enlace, en mayúsculas). En los dos casos le pide que no vuelva a pagar. Mientras el enlace siga enprocesando, no le cobres por otro medio: el pago todavía puede confirmarse. El estado del cobro y la API no cambian: sigue enprocesandohasta que el banco confirme o lo confirmemos cancelado contra nuestro estado de cuenta (desde hoy también los que el banco rechazó con el código VE01; puede tardar varias horas). Sólo con pagos reales. → Enlaces de pago
- Un pago en curso ya no se muestra «vencido». Si tu cliente vuelve a abrir un enlace cuyo pago sigue en
procesandoorevisiony ya pasó suexpires_at, ve el estado de su pago en vez de «Este cobro venció», y ya no vuelve a tufailure_urlconestado=expirado(que podía hacerte creer que no pagó). Ya lo decía Estados de un cobro: un cobro en curso no vence por suexpires_at. El estado del cobro y la API no cambian.
9 de noviembre de 2026
- Banco Plaza: si la conexión con el banco no llega a abrirse, el cobro o el envío queda
RECHAZADA, noDESCONOCIDA. En ese caso la operación nunca llegó al banco y no se movió dinero: quedaRECHAZADAconmotivo_rechazo: "BANCO_NO_DISPONIBLE"y se puede reintentar más tarde con unaidempotency_keynueva (repetir la misma devuelve la mismaRECHAZADA). Antes, en algunos de esos casos, quedabaDESCONOCIDAy había que consultarla. Si la conexión se abrió y el banco no contestó, sigue quedandoDESCONOCIDA: consulta antes de reintentar. → Estados de un cobro
8 de noviembre de 2026
- Aviso de falla general en la página de pago. Si el banco que procesa los cobros falla para todos, tu cliente ve antes de pedir la clave: "Estamos teniendo fallas para procesar pagos en este momento. Si tu pago falla, no se te cobra nada. Intenta de nuevo en unos minutos." No le impide intentarlo y no le ofrece cambiar de banco. Se quita solo. Sólo con pagos reales. → Una falla general para procesar pagos
- Aviso en el portal y por correo. Mientras dure la falla, el portal lo muestra arriba de las pantallas. Si dura más de 15 minutos, te escribimos al correo de tu cuenta, y otra vez cuando se resuelve. Sólo si tuviste cobros reales en los últimos 7 días. → Si hay una falla general
/estado.jsonpara mostrar el aviso en tu pantalla. Documentamos cómo leer los incidentes abiertos (incidentes[].estado: "en_curso") desde tu integración. La respuesta no cambia. → Si hay una falla general
31 de octubre de 2026
- Cobros con BNC: un error técnico del banco ya no se da por rechazado. Si BNC responde a un cobro con un error técnico o con un código que no podemos clasificar, el cobro queda
DESCONOCIDA(conmotivo_rechazo, p. ej.RECHAZO_TECNICO) en vez deRECHAZADA, como ya pasaba con Banco Plaza: el banco pudo debitar. Por la API directa, consulta el estado antes de reintentar y nunca lo reintentes con unaidempotency_keynueva. En un enlace de pago, el cobro queda enrevisionen vez de volver apendiente, así que no se le pide a tu cliente pagar otra vez. → Estados de un cobro - Cobro por WhatsApp Flow en tu propio WhatsApp (kit T2), versión 2. Si el banco rechaza el pago por un motivo que pide otros datos, otra cuenta u otro banco, tu cliente vuelve a la pantalla de sus datos con el motivo y lo que ya había escrito, en vez de quedarse pidiendo otro código. La lista de bancos la manda ePlaza, ordenada por código. Los errores al pedir el código salen arriba del formulario sólo cuando hay uno. La pantalla del código dice «Código de tu banco» y el campo del documento, «Cédula o RIF». Para tenerlo hay que publicar en tu WABA el
kit/flow_cobro.jsonnuevo (como un Flow nuevo) y lanzar ese desde tu bot; el Flow que ya tienes publicado sigue cobrando igual que antes. La API no cambia. - Página de pago: el motivo del rechazo y qué hacer, en palabras. Si el banco rechaza el pago, tu cliente lee por qué y qué le conviene: corregir sus datos (vuelve al paso de sus datos), pagar con otra cuenta o banco, pedir una clave nueva o intentar más tarde; si el rechazo es del banco y ese banco tiene fallas ahora, también lo ve. Ya no se le pide «una clave nueva» cuando no sirve (por ejemplo, con saldo insuficiente). «No se te cobró» sólo sale cuando es seguro: el banco rechazó el pago en el momento por algo del pago o de la cuenta, el pago no llegó a enviarse al banco, o el banco no pudo mandar la clave. El estado del cobro y la API no cambian. → Si el banco rechaza el pago
29 de octubre de 2026
- Webhooks: la URL tiene que tener dominio. Registrar o cambiar un webhook con un servidor sin punto responde
422conurl_invalida. Antes se aceptaba, y una URL con elhttps://escrito dos veces (https://https//tu-dominio.com/…) quedaba registrada sin que le llegara ningún aviso. Los webhooks ya registrados no cambian. → Webhooks
27 de octubre de 2026
- Donaciones (piloto). Un enlace puede incluir
donacion: { donataria, monto }: tu cliente paga un solo débito (montodel enlace, con la donación incluida) y nosotros le transferimos la donación completa a la fundación cuando el banco confirma el pago. La donación no paga comisión (la comisión se calcula sobremontomenos la donación) y no entra en lo que te acreditamos. Las fundaciones las registra y habilita ePlaza para tu cuenta: tú sólo mandas su código.GET /links/:id,link.pagadoylink.acreditadotraendonacioncon suestado. Errores nuevos:donacion_no_disponible,donacion_invalida,donacion_excede_netoydonacion_no_disponible_ahora; en reintegros,409 cobro_con_donacion_pagada; repetir la creación con la mismaidempotency_keyy otra donación,409 idempotency_key_reutilizada. Una donación en revisión que nuestro equipo da por transferida (con su referencia) o cierra con una nota queda cerrada y no vuelve a revisión sola. Los enlaces sindonacionno cambian. → Donaciones
26 de octubre de 2026
- Página de pago: la cédula es la del dueño de la cuenta. El campo ahora se llama Cédula del dueño de la cuenta y aclara: «Si pagas con la cuenta de otra persona, pon la cédula de esa persona, no la tuya.» Si el banco rechaza el pago porque los datos no corresponden a la cuenta (
motivo_rechazo: "BENEFICIARIO_NO_COINCIDE"), tu cliente lo lee, sabe que no se le cobró y vuelve a sus datos con la cédula marcada para revisarla, en vez de pedir otra clave con los mismos datos. Los demás motivos de rechazo también salen en palabras, no como código. El estado del cobro y la API no cambian. → Enlaces de pago
22 de octubre de 2026
- Página de pago: aviso cuando un banco está cancelando intentos de pago. Si un banco acepta y luego, al liquidarlos, cancela por tiempo de espera 3 o más intentos de pago en la última hora (de todos los comercios), y son el 40 % o más de los intentos con ese banco en esa hora, quien lo elige ve antes de pedir la clave: "Tu banco está presentando fallas ahora; puedes usar otra cuenta o intentar más tarde." No le impide pagar. El aviso se quita solo cuando en la última hora quedan menos de 3 cancelados. Sólo con pagos reales. → Enlaces de pago
- Página de pago: qué ve tu cliente cuando el banco tarda o cancela. Si el banco no confirma el pago en 3 minutos, o avisa que canceló la operación por tiempo de espera, la página deja el «Procesando tu pago» y le explica a tu cliente qué pasa, que no vuelva a pagar y que puede cerrar la página y abrir el mismo enlace más tarde. Antes seguía pidiéndole que no cerrara la página. Sólo con pagos reales; en modo prueba no aparece. El estado del cobro no cambia: sigue en
procesandohasta que el banco confirme (pagado) o lo confirmemos cancelado: entonces vuelve apendiente(oexpirado, si ya venció). → Enlaces de pago - Un cobro que el banco cancela en la liquidación se puede liberar desde los 30 minutos. Antes la confirmación esperaba al menos 6 horas y el estado de cuenta del día siguiente. Ahora, si el aviso del banco y sus consultas repiten la cancelación y nuestro estado de cuenta, ya con movimientos posteriores al pago, no muestra el dinero, el cobro vuelve a
pendiente(oexpirado, si ya venció) a partir de los 30 minutos y tu cliente puede pagar otra vez; por la API directa, la operación pasa aRECHAZADA(motivo_rechazo: "RECHAZO_TECNICO") y llegatransaccion.rechazada, como antes. Si falta alguna señal, se sigue esperando como antes. Sólo con pagos reales. → Estados de un cobro
20 de octubre de 2026
- Un cobro
RECHAZADApor el banco ya no vuelve aPENDIENTEal consultarlo. Si el banco rechazó el débito por un motivo del pago (por ejemplo, la clave estaba mal:motivo_rechazo: OTP_INVALIDO),POST /switch/v1/consultarrespondeRECHAZADAaunque el banco conteste después «pendiente de liquidación». Sólo cambia si el banco confirma que el dinero entró (LIQUIDADA). Un rechazo técnico (RECHAZO_TECNICO) sigue pudiendo avanzar como antes. → Estados de un cobro - Portal: persona de contacto en Ajustes e Inicio. La persona de contacto que deja un negocio al registrarse se ve y se cambia en Ajustes › Persona de contacto (Propietario y Administradores). Los negocios que se registraron antes de que el registro la pidiera ven en Inicio el aviso ¿A quién le escribimos? con Agregar contacto; no bloquea nada. Sólo en el portal: no está en la API. → Persona de contacto
19 de octubre de 2026
- Un cobro que el banco cancela en la liquidación ya no se queda en
procesando. Si el banco cancela el débito después de recibirlo (por ejemplo, porque se agotó su tiempo de espera) y lo confirmamos contra nuestro estado de cuenta, el cobro vuelve apendiente(o quedaexpirado, si ya venció) y tu cliente puede pagar otra vez; por la API directa, la operación pasa deACEPTADAaRECHAZADA(motivo_rechazo: "RECHAZO_TECNICO") y llegatransaccion.rechazada. La confirmación puede tardar varias horas. Antes, ese cobro quedaba enprocesandosin cerrarse. → Estados de un cobro - Los cobros vencidos se ven
expirado. Un enlacependientecuyoexpires_atya pasó saleexpiradoenGET /switch/v1/links/:id, enGET /switch/v1/links(el filtroestado=pendienteya no lo trae yestado=expiradosí), en los lotes y en tu portal («Vencido»). Antes seguíapendientehasta que alguien abría la página de pago. Cancelar un enlace vencido responde409no_cancelablecon"estado": "expirado". En los lotes, un item vencido ya no cuenta enabiertos, así quecompletopuede pasar atrueantes. Un cobro que ya estaba en curso al vencer no cambia: sigue hastapagado. Vencer no envía webhook. → Estados de un cobro - Portal: las cuentas personales tienen Integraciones. Quien abrió su cuenta con Para mí ve Integraciones en el menú, con Botón web, Llaves de API, Webhooks, y crea sus llaves y sus webhooks igual que un negocio: la llave de producción, sólo con la cuenta aprobada; los cobros por la API tienen los mismos límites y topes de la cuenta. Estadísticas sigue siendo sólo para negocios. → Cuentas personales
- Un reintegro que no llegó puede pasar de
LIQUIDADAaRECHAZADA, también a una cuenta del mismo banco. El0000del envío dice que el dinero salió hacia el banco, no que llegó. Si, cerrado el día en Venezuela, el banco no confirmó la liquidación y el débito no aparece en el estado de cuenta de ePlaza, el reintegro pasa aRECHAZADAconmotivo_rechazo: SIN_DEBITO_EN_EXTRACTOy llegatransaccion.rechazadacon el mismodata.id. Se puede reintentar conretry_noncecuando ePlaza lo da por firme (no antes del tercer día y sólo si el débito sigue sin aparecer); antes responde409 reintegro_intento_ambiguo, y lo mismo si no se puede dar por firme (queda agotado) hasta que una persona lo revise. Un rechazo por un dato de la cuenta no se reintenta. ePlaza no lo re-paga solo. Aplica a reintegros de cobros hechos desde la activación. → Referencia de webhooks
18 de octubre de 2026
- En un pago a otro banco,
LIQUIDADApuede volverseRECHAZADA. Si el banco receptor rechaza la transferencia (por ejemplo, la cuenta no está a nombre de la cédula o el RIF indicados), la operación pasa aRECHAZADAy llegatransaccion.rechazadacon el mismodata.id, aunque antes haya llegadotransaccion.liquidada. No se re-paga sola. Los cobros no cambian. → Referencia de webhooks - Tu cuenta bancaria queda verificada sólo cuando tu banco confirma que el Bs 1 llegó. Antes bastaba con que el Bs 1 saliera. Si tu banco lo rechaza (por ejemplo, porque la cuenta no está a nombre de tu cédula o del RIF de tu empresa), la cuenta queda no verificada: te decimos el motivo en el registro, en tu portal (Inicio y Ajustes › Dónde recibes tu dinero) y por correo, con los pasos para registrar la cuenta correcta. → Tu portal
- Portal: cobros por WhatsApp gratis desde el mínimo del día (US$ 8 a tasa BCV, redondeado hacia arriba a Bs 500); el botón Cobrar por WhatsApp se enciende al llegar al mínimo. 5 envíos de prueba bajo el mínimo (últimos 30 días) para enviar a mano. Plan WhatsApp sin mínimo (US$ 4,99): hasta 150 bajo el mínimo, encabezado personalizado y bot propio. Se retiran los planes Gratis, Emprendedor y Negocio. → Cobros por WhatsApp y tu plan
- Registro: persona de contacto del negocio. Al abrir una cuenta de negocio nos dejas con quién hablar para seguimiento (nombre, cargo opcional, celular y correo); se cambia en Ajustes. → Cómo se abre la cuenta
- Bancos no disponibles por ahora en la página de pago. Si con un banco los pagos casi nunca se completan (10 % o menos de las claves aprobadas en 90 días, con al menos 50) y ePlaza lo revisó, ese banco sigue en la lista pero deshabilitado, con la etiqueta «no disponible por ahora», y tu cliente elige otro. Vuelve a estar disponible cuando pasa del 15 %. Pedir la clave con él responde
409banco_no_disponible, sin pedirle nada al banco. No aplica a enlaces de prueba. → Enlaces de pago - Página de pago: cómo llega la clave en cada banco. Antes de pedir la clave, tu cliente ve cómo se la manda su banco (Bancaribe por correo electrónico, Mercantil por SMS, Banesco en su app, Banco Plaza con una notificación; los demás: por SMS, notificación o correo) y, en el paso de la clave, el mismo recordatorio. → Enlaces de pago
- Página de pago: cambiar de banco sin perderse. El paso de la clave tiene ← Cambiar banco, el botón atrás del teléfono vuelve al paso anterior sin salir de la página, y la espera de un minuto entre claves cuenta por banco: quien se equivocó de banco pide la clave del correcto sin esperar. → Límites y reglas
17 de octubre de 2026
- Rutas obsoletas:
/switch/v1/facturas,/suscripciones,/productos,/propinas,/equipoy/cartera. Guardaban esos datos aparte de los que usa tu portal, así que lo que se creaba por ahí no aparecía en el portal (una suscripción creada así no cobraba). Siguen respondiendo igual, pero ahora traen las cabecerasDeprecation,Sunset(16 de diciembre de 2026) yLinka la guía donde vive hoy cada función. Si las usas, escríbenos a [email protected] antes de esa fecha. Para tus cifras usaGET /switch/v1/estadisticas. → Estadísticas - La página de pago (
/l/<id>) ya no se puede mostrar dentro de uniframede otro sitio (X-Frame-Options: DENY,frame-ancestors 'none'), para que nadie la disfrace dentro de una página ajena. El botón para tu web y el widget la abren en una ventana o pestaña nueva, así que no cambian. Si la incrustabas en uniframe, ábrela con un enlace o con el botón. GET /switch/v1/resumenqueda obsoleta; usaGET /switch/v1/estadisticas./resumenagrupa por día UTC (un cobro de las 9 de la noche en Venezuela cae en el día siguiente) y mezcla en el total y en la tasa de éxito pasos que no son cobros. Su respuesta no cambia: desde hoy trae las cabecerasDeprecation: true,Sunset: Wed, 16 Dec 2026 00:00:00 GMTy unLinka su reemplazo. Desde el 16 de diciembre de 2026 puede dejar de responder. → Estadísticas
- Estadísticas por la API. Nuevo
GET /switch/v1/estadisticas?desde=&hasta=: cobros pagados, volumen, ticket promedio, propinas, comisión, neto, tasa de éxito ante el banco y la serie por día, en hora de Venezuela (por omisión, los últimos 30 días). Son las mismas cifras del portal › Estadísticas. → Estadísticas
16 de octubre de 2026
- Respuestas sin datos internos. Con tu llave,
POST /switch/v1/cobrar,/cobrar/token,/pagar,/consultary/reversoya no traenbanco_usadoniraw. Para saber qué pasó sigueestado, y si fue rechazada,motivo_rechazo, que es igual para todos los bancos. El listado y la exportación deGET /switch/v1/transaccionesya no traen la columnabanco,GET /switch/v1/configya no traerielesy los avisostransaccion.*ya no traenbanco. Si leías alguno de esos campos, deja de hacerlo; lo demás no cambia. → API directa GET /switch/v1/bancosyGET /switch/v1/politica-dineropasan a uso interno: responden403solo_uso_internoa las llaves de comercio. Para comprobar que tu llave funciona usaGET /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.txtyllms-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 ePlaza (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 tusuccess_urlno cambian. Quien paga con tarjeta (piloto) ahora también vuelve a tusuccess_url: Credicard lo regresa a la página de pago y de ahí a tu web, con la operación ePlaza comoreferencia. → Volver a tu web - Avisos
transaccion.*: campo nuevooperacion. Dice de qué es la transacción:cobro,pago,reverso,devolucion_debito,devolucionodevolucion_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 contransaccion.liquidada, entrega sólo cuandooperacionseacobro. → Webhooks - Aviso nuevo
link.devuelto(piloto). Devoluciones de cobros desde el portal: llega cuando una devolución llegó a tu cliente, conmonto(esta devolución) ymonto_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/reintegrocon una llave de comercio en vivo (sk_live) responde 403reintegro_no_habilitado: el reintegro sale de la cuenta de ePlaza, 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 ePlaza 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 ePlaza 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(oMONTO_INVALIDOpor 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
409dePOST /cobrar/tokensigue trayendotopeyusadoen Bs y agregatopes_moneda,tope_usdytasa_bcv. Los topes en bolívares no cambian. → Límites - Tope de lo que recibes, por día y en total. ePlaza 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/tokenresponde409tope_diario_excedidootope_acumulado_excedido. Quien ya tenía su clave termina su pago. → Límites link.pagadosólo con el pago confirmado por el banco. Antes, un cobro pasaba apagadoy te llegabalink.pagadoapenas 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 enprocesandoylink.pagadollega 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 apendientey no llega aviso. Sigue llegando una sola vez por cobro y con los mismos campos. Si tu sistema entrega conlink.pagadoo con el estadopagado, no tienes que cambiar nada; no entregues conprocesando. 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.aprobadasólo con la operación confirmada por el banco. Antes llegaba conACEPTADA, 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 quedaLIQUIDADA, una sola vez, junto contransaccion.liquidada, y sudata.estadoes"LIQUIDADA"(antes"ACEPTADA"). Si entregabas contransaccion.aprobada, ahora entregas con la confirmación del banco; si comparabasdata.estadocon"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
ACEPTADAya era exitoso. No lo es:ACEPTADAes "enviada a BCV"; el cobro está confirmado conLIQUIDADA. → 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. ePlaza 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
pagadosólo cuando Credicard confirma el cobro. El avisolink.pagadode esos pagos trae"metodo": "tarjeta"yrecargo_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 ePlaza 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
503con{ "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-timestampyx-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
splital 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,splitresponde400split_no_disponible. → Pago dividido GET /links/:idde un enlace con reparto traesplityreparto; el avisolink.acreditadotraerepartoy llega cuando todo el reparto terminó. Los enlaces sinsplitno 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
400split_cuenta_no_preaprobada; una que un control de seguridad frena o que pasa el tope diario por beneficiario,400split_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.estadosumacerradoy cada beneficiario puede quedardescartado(se cerró sin pagarle, con una nota). → Pago dividido - Modo prueba: más desenlaces forzados. Además de
11111111(rechazo) y22222222(pendiente y luego aprueba), ahora11111112rechaza por fondos insuficientes,11111113por clave inválida,11111114simula banco no disponible y33333333tarda unos 8 segundos en confirmar y luego aprueba. Los rechazos no envían webhook y las aprobaciones envíanlink.pagadocon"mode": "test", igual que en producción. Sólo existen con una llavesk_test_; en producción no hacen nada especial. → Modo prueba - Botón de pago en una línea:
<script src="https://eplaza-qa-pay.pagaconquickpay.com/boton.js" data-link="ID_O_SLUG"></script>pinta el botón Pagar con ePlaza y abre el pago en una pestaña (o en una ventana condata-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,canceladoyrechazado), 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
ACEPTADAse confirma con el banco antes de devolverlo.POST /switch/v1/reintegrosobre un cobro enACEPTADAconsulta al banco en ese momento y sólo devuelve si quedaLIQUIDADA. Si el banco todavía no lo confirma, responde 409cobro_no_confirmado_banco: no es definitivo, vuelve a intentarlo más tarde. - Un reintento a la vez por cobro: si llega un
retry_noncemientras otro intento de reintegro del mismo cobro está en curso, responde 409reintegro_en_cursoy 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
procesandosin mandar el cobro a revisión. - Webhooks:
POST,PATCHyDELETE /switch/v1/webhooksexigen unask_live_(consk_test_,403requiere_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/deliveriessólo lista las entregas de avisos de prueba (data.mode: "test"). Las de producción, y los avisostransaccion.*, sólo se ven con unask_live_. → Webhooks - Flows:
POST /switch/v1/flow/configyPUT /switch/v1/flows/definicionexigen siempresk_live_(antes sólo si ya tenías un Flow de producción). → Llaves y entornos - Lotes de dispersión:
GET /switch/v1/dispersiones/:idyPOST /switch/v1/dispersiones/:id/cancelarresponden 404 si el lote es de otro modo que tu llave. - Llaves: al crear una llave por API, el
labelno puede empezar porservice-key:nipartner:; responde400conlabel_reservado. → Llaves y entornos - Cobro por WhatsApp Flow: un binding con
monto_fijoya no cobra si el Flow manda otro monto (antes cobraba el fijo sin avisar). Nuevo modo opcionalexigir_monto_firmado: tu bot firma el monto de cada orden en elflow_tokencon unmonto_secretque 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/consultaryPOST /switch/v1/reintegroresponden 404 si elides de otro modo que tu llave (una llave de prueba no consulta ni devuelve un cobro real, y al revés). retry_noncedel reintegro sólo reintenta lo que el banco rechazó sin mover dinero. Si un intento anterior quedó sin respuesta clara (DESCONOCIDA,PENDIENTE,ERRORo un código técnico), responde 409reintegro_intento_ambiguoy no se emite otro pago hasta conciliarlo. Si ningún intento anterior existe, 409reintegro_sin_intento_previo: el primer intento va sinretry_nonce. Si alguno ya pagó, sigue siendo 409reintegro_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/pagaryPOST /switch/v1/dispersionesdebitan una cuenta de ePlaza: con una llave de comercio sin habilitación responden403con{ "error": "pagar_no_habilitado" }. → API directaGET /switch/v1/saldoyGET /switch/v1/movimientospasan a uso interno: responden403cuenta_no_permitidaa las llaves de comercio. Lo tuyo lo ves en Transacciones y Cartera.- Verificar un comprobante trae
concepto,referencia_externay 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
500responden{ "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 unask_live_; si no,403conrequiere_llave_live. → Llaves y entornos - Webhooks: la URL tiene que llegar a una dirección pública (una de red interna responde
422condestino_bloqueado), no seguimos redirecciones (una3xxcuenta como no entregada) y hay un máximo de 10 webhooks por comercio (409conlimite_webhooks). El historial de entregas trae el campoerror. → 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 consk_live_(responde404), y al revés.GET /linkssinmodetrae sólo los del modo de tu llave. → Llaves y entornos idempotency_keypor modo: la misma llave en prueba y en producción crea dos objetos distintos; consk_live_nunca recibes un enlace, lote u orden de prueba. Nuevo409 idempotency_key_en_usosi 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
revisionque 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/salientey/conciliar/multiplepasan a uso interno: responden 403 a las llaves de comercio. Para saber si te pagaron, usa el estado del enlace o el avisolink.pagado.ya_conciliado: trueya no cuenta como pagado: el banco la responde aunque el monto no coincida. Sóloconciliado: trueautoriza entregar, y exige el monto exacto y una referencia que no se haya usado antes. Nuevo camporevisionpara 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 ePlaza 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. → Cobros por WhatsApp y 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 /linksahora acepta varios estados separados por coma (estado=pagado,procesando),desdeyhasta(fecha del pago o, si no se pagó, de creación),q(concepto, nombre de quien pagó, referencia,ido código de verificación),minymaxen Bs,con_propina,modeyorigen. Sigue devolviendo una lista y lo que ya usabas no cambia. Un valor que no se entiende en uno de los filtros nuevos responde400conparametro. → Listar tus enlaces codigo_verificaciontambién al listar (antes sólo al consultar un enlace). Esnullsi el enlace no está pagado. El SDK traelistarEnlaces.- Pago confirmado más rápido: cuando el banco nos notifica que un pago en
procesandose completó, el enlace pasa apagadoy salelink.pagadoen 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 endatadel avisolink.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
propinaytotalal consultar o listar un enlace y endatadel avisolink.pagado.montono cambia: es el del cobro. Sin propina,propinaes0ytotales igual amonto. 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 eplaza-qa-pay.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 enlacepagadoy endatadel avisolink.pagado; lo que ya leías no cambia. NuevoGET /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
403concomercio_suspendido, y un enlacependientemuestra "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
11111111simula un rechazo del banco y22222222un pagoprocesandoque se aprueba solo a los 30 segundos. Cualquier otra clave de 8 dígitos sigue aprobando. - Nuevo
POST /links/:id/simular(sólo llavesk_test_): fuerzapagado,rechazadooexpiradosin abrir la página de pago. En producción responde403. - Los avisos
link.pagadoylink.acreditadotraendata.mode(testolive), para que tu servidor distinga un pago simulado de uno real. Es un campo nuevo: lo que ya leías no cambia. failure_urlya funciona: tu cliente vuelve a esa dirección, con?estado=expirado,canceladoorechazado, cuando el cobro venció, lo cancelaste o él elige Cancelar y volver después de un rechazo del banco.- Nuevo
POST /links/:id/cancelarcon tu llave: cancela un enlace sólo si siguependiente(si alguien ya está pagando,409). El SDK traecancelarEnlaceysimularEnlace. - 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-v2yx-quicklink-timestamp) para rechazar avisos reenviados. La firma anterior sigue llegando. - Enlaces:
success_url(conestadoyreferenciaal volver),metadataeidempotency_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_idy no tusmetadata, 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 nombreQuickLinksigue funcionando).
16 de septiembre de 2026
- Dominio propio:
pay.pagaconquickpay.comyeplaza-qa-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.