Pagos

Visión general de Pagos

Visión general El módulo de Pagos convierte a ConversaLabs en un mostrador de cobro dentro de la propia atención. Con él conectas una pasarela (Asaas o Mercado Pago), creas cobros únicos, recurrentes o a partir de un negocio del CRM, y envías el enlace de pago directo en la conversación — con PIX (QR + copiar y pegar), boleto y tarjeta (checkout alojado). Todo ocurre sin salir de la plataforma: el cliente recibe el cobro en la misma ventana en la que habla contigo, paga, y el estado se actualiza automáticamente cuando la pasarela confirma el pago. No necesitas entrar al panel del banco para hacer seguimiento — ConversaLabs refleja pagado, vencido, reembolsado y cancelado en tiempo real. Requisitos previos - El módulo Pagos debe estar habilitado para tu cuenta. Es opcional y viene desactivado por defecto — pide a un administrador o al operador de la plataforma que lo active. - Una cuenta activa en una pasarela compatible: Asaas o Mercado Pago. - Permiso de administrador para conectar la pasarela y configurar webhooks. - Para cobrar desde el CRM o la Agenda, esos módulos también deben estar habilitados. Paso a paso 1. Asegúrate de que el módulo de Pagos esté habilitado para la cuenta. 2. Conecta una pasarela (Asaas o Mercado Pago) con tus credenciales y entorno — consulta Conectar pasarela. 3. Crea tu primer cobro (único, desde el catálogo o desde un negocio) y envíalo en la conversación. 4. Sigue el estado del cobro: pendiente, esperando pago, pagado, vencido o reembolsado. 5. Para ingresos recurrentes, configura suscripciones y planes. 6. Sigue los resultados en los informes (facturación, ticket medio, MRR y churn). Configuración y opciones Planes de cobro y talonario de pagos Un plan de cobro reúne las cuotas de una sola venta. El total contratado y el importe recibido son distintos: pagar una cuota no liquida todo el plan. Cada cuota mantiene su vencimiento, pago e historial. - Pasarelas: conecta una o varias pasarelas; cada conexión tiene su propio entorno (producción o sandbox) y credenciales. - Métodos de pago: PIX, boleto y tarjeta vía checkout alojado. La disponibilidad de cada método depende de la pasarela elegida. - Cobros: únicos, con ítems (líneas de cobro), descuentos y ajuste de valor. - Suscripciones y planes: cobro recurrente delegado a la pasarela y reflejado en la plataforma. - Reembolsos: total o parcial, según el soporte de la pasarela. - Informes: facturación por estado, por pasarela y por moneda, ticket medio, MRR y churn. Condiciones del contacto en automatizaciones de pago En una regla de automatización disparada por un evento de pago (cobro, suscripción o plan de cobro), además de los campos del pago puedes usar los campos del contacto del pago — correo, teléfono, tipo de contacto, ciudad, dirección — y los atributos personalizados de contacto (por ejemplo, status_lead). La regla es siempre conservadora: si el pago no tiene contacto, o el contacto no tiene valor en el atributo, una condición "distinto de" o "no contiene" no se cumple. Así, "status_lead distinto de pagado" solo se dispara para contactos con el estado completado y diferente de "pagado". Para actuar cuando el campo está vacío, usa "no está presente". Casos de uso - Cerrar una venta en WhatsApp y enviar el PIX al instante, con QR y copiar y pegar. - Cobrar un servicio a partir de un negocio ganado en el CRM, sin volver a teclear valores. - Crear una suscripción mensual para un cliente recurrente. - Aplicar un descuento puntual a un cobro antes de enviarlo. - Exigir pago anticipado de una reserva en la Agenda (agendamiento pago). Consejos, límites y buenas prácticas - El módulo solo funciona con checkout alojado — la plataforma nunca captura datos de tarjeta, lo que te mantiene fuera del alcance PCI. - Los valores se tratan en unidades mayores (reales, no centavos): R$ 49,90 es 49.90. - El webhook es la fuente de verdad del estado: confía en él, no en la pantalla de "éxito" del checkout. - Mantén las credenciales de la pasarela al día; los tokens vencidos interrumpen nuevos cobros. Solución de problemas - No veo Pagos en el menú: el módulo no está habilitado para tu cuenta o tu perfil — habla con un administrador. - No puedo crear un cobro: verifica que haya una pasarela conectada y válida. - El estado no se actualiza: revisa la configuración del webhook en Reembolsos, webhooks e informes. Ver también - Conectar pasarela: Asaas y Mercado Pago - Crear un cobro y enviarlo en la conversación - Suscripciones y planes recurrentes - Descuentos y ajuste de valor - Agendamiento pago - Reembolsos, webhooks e informes - Planes de cobro y talonario de pagos

Conectar pasarela: Asaas y Mercado Pago

Visión general Antes de cobrar a alguien, necesitas conectar una pasarela de pago. ConversaLabs admite Asaas y Mercado Pago. Cada conexión guarda las credenciales de la pasarela, define el entorno (producción o prueba) y registra un webhook — el canal por el que la pasarela avisa a la plataforma cuando un cobro se paga, vence o se reembolsa. Puedes tener más de una conexión (por ejemplo, un Asaas de producción y un Mercado Pago para otro flujo). Cada cobro se crea en una conexión específica. Requisitos previos - Módulo Pagos habilitado y permiso de administrador. - Una cuenta en la pasarela elegida: - Asaas: una clave de API (API Key) del panel de Asaas. - Mercado Pago: un Access Token y Client Secret de tus credenciales de aplicación. - Definir el entorno: producción (cobros reales) o sandbox (pruebas). Paso a paso 1. Abre la configuración de Pagos y elige agregar una nueva conexión. 2. Selecciona la pasarela: Asaas o Mercado Pago. 3. Ingresa las credenciales: - Asaas: pega la API Key. - Mercado Pago: pega el Access Token (y el secreto de firma usado para validar el webhook). 4. Elige el entorno: producción o sandbox. 5. Guarda. La plataforma valida las credenciales con la pasarela. 6. Configura el webhook: la plataforma genera la URL de notificación y el secreto de verificación. En muchos casos el registro es automático; cuando no lo sea, copia la URL indicada y regístrala en el panel de la pasarela. 7. Haz una prueba en sandbox (un cobro PIX, por ejemplo) y confirma que el estado cambia solo cuando se simula el pago. Configuración y opciones Planes de cobro y talonario de pagos Activa Pagos, conecta una pasarela compatible y revisa los datos del pagador. Las opciones dependen de la conexión, el método y el ciclo. Asaas ofrece cuotas nativas mensuales de boleto/Pix; otros ciclos usan recurrencia limitada cuando está disponible. Esta entrega no incorpora integraciones directas con nuevos bancos. - Entorno: producción o sandbox por conexión. No mezcles credenciales de entornos distintos. - Webhook: la URL es única por conexión y la pasarela autentica cada notificación: - Asaas envía un token propio en el encabezado de la solicitud, comparado de forma segura con el que la plataforma guardó. - Mercado Pago firma cada notificación; la plataforma valida la firma antes de procesar. - Diagnóstico de la última conciliación: la comprobación programada compara cobros y suscripciones con la pasarela para cubrir notificaciones perdidas. Si falla algún registro, la tarjeta de la conexión en Configuración → Pagos → Conexiones permanece roja con la cantidad total y hasta los tres primeros identificadores externos y motivos. Los demás registros siguen procesándose; las respuestas brutas, los datos del cliente y las credenciales nunca aparecen en este diagnóstico. - Protecciones de entrada: son ajustes de la conexión, no de la importación, y también rigen lo que llega por webhook. - Fecha de corte: no entra nada anterior a ella. Es el freno que impide que un historial entero aparezca como si fuera de hoy. - Adopción automática de cobros huérfanos: desactivada de forma predeterminada. Un cobro que llega de la pasarela sin correspondencia local solo se adopta si lo permites; con "solo desde la fecha de corte", una fecha ausente o inválida hace que la operación falle de forma segura en lugar de adivinar. - Ambas están en Importar historial → Ajustes de ingesta y se guardan en la conexión, así que la próxima importación y el próximo webhook ya las respetan. - Métodos admitidos por pasarela: | Capacidad | Asaas | Mercado Pago | |---|---|---| | PIX | Sí | Sí | | Boleto | Sí | Sí | | Tarjeta (checkout alojado) | Sí | Sí | | Cuotas con tarjeta | Sí | Sí | | Suscripciones | Sí | Sí | | Planes reutilizables | — | Sí | | Reembolso parcial | Sí | Sí | Certificado de la conexión Cuando la conexión requiera certificado, usa su área de certificado para cargar el archivo y los datos solicitados. Después, revisa titular, emisor, huella y vencimiento. La edición muestra metadatos; no devuelve clave, certificado ni contraseña. Los estados son ausente, válido, próximo a vencer y vencido. Renueva antes del plazo y revisa los metadatos; los avisos de vencimiento ayudan a planificarlo. La fundación permite probar esta interfaz en un laboratorio con certificado ficticio. Esto no habilita un banco nuevo ni convierte un certificado de prueba en credencial de producción. Casos de uso - Un operador que ya usa Asaas conecta la clave y empieza a cobrar por WhatsApp sin cambiar de sistema. - Una empresa que vende en América Latina conecta Mercado Pago. - Un equipo que quiere probar antes de cobrar de verdad usa el entorno sandbox primero. Consejos, límites y buenas prácticas - Trata las credenciales como secreto: se almacenan cifradas y nunca vuelven a mostrarse en pantalla después de guardarlas. - Usa sandbox para validar todo el flujo antes de pasar a producción. - La autenticación de Asaas usa un encabezado access_token (no Authorization: Bearer). - Mercado Pago notifica solo el identificador del pago; la plataforma consulta la pasarela para leer el estado completo — esto es normal. Solución de problemas - Credenciales inválidas: verifica que copiaste la clave/token correctos y que el entorno coincide con el de la pasarela (un token de prueba solo funciona en sandbox). - El estado no se actualiza: el webhook no está llegando. Confirma que la URL esté registrada en la pasarela y que el secreto de verificación coincida. - Notificación rechazada (401): la firma/token del webhook no coincide — vuelve a registrar el webhook. - La última conciliación tuvo fallos: anota el identificador y el motivo mostrados en la tarjeta, valida la conexión y el entorno y confirma que el registro todavía existe en la pasarela. Un fallo permanece visible y nunca modifica silenciosamente el registro local. La siguiente comprobación sustituye el diagnóstico; la alerta desaparece solo después de una ejecución sin fallos. Ver también - Visión general de Pagos - Crear un cobro y enviarlo en la conversación - Reembolsos, webhooks e informes - Planes de cobro y talonario de pagos - Página pública de cobro

Crear un cobro y enviarlo en la conversación

Visión general El cobro es el corazón del módulo. Creas un cobro con valor, descripción e ítems, eliges el método (PIX, boleto o tarjeta vía checkout alojado) y lo envías directo en la conversación. El cliente recibe una tarjeta de pago en la propia ventana — con el QR y el copiar y pegar del PIX, la línea del boleto o el enlace del checkout — y el estado se actualiza cuando la pasarela confirma. Hay tres formas de iniciar un cobro: único (tecleas los valores), desde el catálogo (eliges productos listos) o desde un negocio del CRM (reutilizas el valor ya registrado). Requisitos previos - Una pasarela conectada y válida (consulta Conectar pasarela). - Para cobrar desde el catálogo, el módulo de Catálogo habilitado con productos registrados. - Para cobrar desde un negocio, el módulo de CRM habilitado y un negocio con valor. - Un contacto con datos mínimos (nombre y, idealmente, correo y teléfono) para el cliente de la pasarela. Paso a paso 1. En una conversación, abre la acción de crear cobro (o créalo desde el área de Pagos). 2. Elige el origen del valor: - Único: ingresa valor, descripción y, si quieres, ítems (líneas de cobro). - Catálogo: selecciona los productos; el valor se suma automáticamente. - Negocio: selecciona un negocio del CRM; el valor se reutiliza. 3. Selecciona el método de pago: PIX, boleto o tarjeta (checkout alojado). 4. (Opcional) Aplica un descuento o ajusta el valor — consulta Descuentos y ajuste de valor. 5. Define el vencimiento, cuando aplique. 6. Crea el cobro. La plataforma genera el PIX (QR + copiar y pegar), el boleto (línea) o el enlace del checkout, según el método. 7. Envíalo en la conversación: la tarjeta de pago aparece para el cliente en la misma ventana. En pagos PIX, la etiqueta y el código aparecen separados para facilitar la lectura; incluso un código largo permanece dentro de la tarjeta. Usa la acción de copiar para llevar el código completo. 8. Observa el estado pasar de pendiente a pagado automáticamente cuando la pasarela confirme. Configuración y opciones Cobrar a una empresa 1. Elige el contacto responsable. En una conversación, este contacto conserva el contexto de atención. 2. En Pagador, elige Empresa y selecciona una empresa vinculada al contacto. Es una elección explícita: un vínculo del CRM o un producto del catálogo no determina por sí solo quién paga. 3. Revisa el registro de la empresa: razón social y documento fiscal, además del correo, teléfono y dirección exigidos por la pasarela y el método. Los datos fiscales del pagador proceden de la empresa elegida; los datos personales del contacto no sustituyen ese registro. 4. Si la lista está cargando o falla, espera o usa Reintentar. Un fallo de carga no se trata como ausencia de empresas. No cobres a una empresa incompleta como contacto para evitar el error. La creación en una conversación sigue requiriendo el contacto responsable. Una suscripción importada o registrada sin contacto no equivale a un flujo completo de conversación. En Asaas, no supongas que editar la empresa en la plataforma sincroniza automáticamente todos los campos de un cliente ya existente: comprueba también la razón social, el correo y la dirección en la pasarela. Planes de cobro y talonario de pagos Un plan de cobro reúne las cuotas de una sola venta. El total contratado y el importe recibido son distintos: pagar una cuota no liquida todo el plan. Cada cuota mantiene su vencimiento, pago e historial. - Métodos: PIX (QR + copiar y pegar), boleto (línea/PDF) y tarjeta vía checkout alojado — la plataforma nunca pide el número de tarjeta. - Ítems (líneas de cobro): describe cada producto/servicio con cantidad y valor; el total es la suma de las líneas. - Vencimiento: fecha límite para PIX/boleto. - Opciones avanzadas de Asaas: puedes definir multa e interés en porcentaje y descuento por pago anticipado en el cobro; el envío impreso por correo aparece solo para boleto. Esta condición de pago no sustituye al descuento comercial aplicado al importe. Dejar un campo en blanco no envía una sustitución explícita. Revisa el valor de la conexión y el panel de la pasarela. Cero es un valor explícito; confirma el resultado antes de prometer exención de multas o intereses. - Retorno de Asaas: introduce una URL HTTPS pública para devolver al pagador a tu sitio. La redirección automática solo se envía cuando existe una URL válida. - Checkout de Mercado Pago: en tarjeta alojada, elige el límite de cuotas y, si hace falta, URLs HTTPS públicas separadas para pagos aprobados, rechazados y pendientes. El retorno automático requiere la URL de aprobado. - Control por conexión: la pantalla solo muestra capacidades anunciadas por la pasarela elegida. La API también rechaza opciones incompatibles; ocultar un control no es la única protección. - Marcar como pagado manualmente: registra pagos recibidos por fuera (cuando la pasarela lo admita) para mantener el historial coherente. - Reenviar: puedes reenviar la tarjeta de pago en la conversación en cualquier momento. - Datos del pagador automáticos: cuando el pagador es Persona/Contacto, el documento y la dirección vienen de los datos nativos del contacto (el documento viene precargado para que lo verifiques; la dirección de facturación tiene prioridad sobre la principal). Complétalos una vez en el contacto y no los vuelvas a escribir — mira Datos fiscales y dirección del contacto. Ver detalles e historial En la lista de cobros, haz clic en el cliente para abrir el detalle, incluso para cobros Pix o registrados manualmente que no tienen una página de pago alojada. La acción principal sigue lo que el cobro realmente permite: copiar el código Pix, abrir el boleto/checkout o, cuando Asaas lo permita y el cobro esté abierto, marcarlo como pagado manualmente con una justificación. El historial muestra primero los eventos más recientes, identifica al operador o al sistema/gateway y presenta la justificación registrada. Los historiales largos están paginados; cambiar de página no modifica el cobro. Usa esta línea de tiempo para revisar creación, actualización, pago, vencimiento, cancelación y reembolso sin depender solamente del estado actual. Pedido nativo de WhatsApp (WhatsApp Pay) Cuando la conexión del gateway tiene activado el pago nativo de WhatsApp, el cobro llega al cliente por la API oficial como un pedido de WhatsApp que paga sin salir de la app. Ese pedido acompaña al cobro: - cuando se confirma el pago, la plataforma actualiza el pedido en el WhatsApp del cliente, que pasa a mostrar la etiqueta pagado; - cuando el cobro se cancela antes del pago, el pedido pasa a cancelado y deja de ofrecer el pago. La actualización solo se envía con la ventana de atención de 24 horas abierta, porque WhatsApp no acepta este tipo de mensaje fuera de ella. Fuera de la ventana, la tarjeta del cobro en la conversación sigue mostrando el estado correcto. El cliente recibe un aviso de pago, nunca dos: cuando el pedido se actualiza a pagado, esa actualización reemplaza el mensaje de confirmación de pago. El mensaje de confirmación sale en su lugar cuando el pedido no se puede actualizar (cobro sin pedido de WhatsApp, conversación por WhatsApp Web o ventana cerrada) y también cuando WhatsApp rechaza la actualización del pedido. Si el resultado del envío queda incierto (WhatsApp no confirmó si la actualización llegó), la plataforma no envía el mensaje de confirmación, para que el cliente no reciba el aviso dos veces. Fuera de la ventana de 24 horas, si la plantilla configurada para enviar cobros es una plantilla de detalles del pedido, la plataforma completa el pedido de la plantilla con los mismos ítems, importes y formas de pago. Casos de uso - Cerrar la venta en WhatsApp y mandar el PIX al instante. - Armar un cobro con varios ítems desde el catálogo. - Cobrar un negocio ganado en el CRM sin volver a teclear el valor. - Ofrecer al cliente elegir entre PIX y tarjeta. Consejos, límites y buenas prácticas - Si la red falla después del envío, vuelve a intentarlo desde el mismo formulario abierto: conserva la clave de la operación y recupera el cobro existente en lugar de cobrar dos veces al cliente. - Los valores van en unidades mayores (R$ 49,90 = 49.90); el total es la suma de precio × cantidad de las líneas — nunca dividas por 100. - La tarjeta siempre pasa por el checkout alojado de la pasarela: cero datos de tarjeta en la plataforma. - Confirma el nombre y el contacto del cliente antes de crear — la pasarela usa esos datos para identificar al pagador. - No confíes en la pantalla de "éxito": el estado real llega por el webhook. - Usa solo URLs HTTPS públicas para el retorno. No incluyas tokens, contraseñas ni otros secretos. Solución de problemas - Error al crear el cobro: verifica que la pasarela esté conectada y que el contacto tenga los datos mínimos. - El cliente no recibió el PIX: reenvía la tarjeta de pago en la conversación. - Pagado pero sigue pendiente: revisa la configuración del webhook (consulta Reembolsos, webhooks e informes). - Recurso no disponible (p. ej., tarjeta): puede ser una limitación de la pasarela elegida — consulta la matriz de capacidades en Conectar pasarela. - Cambiar la forma de pago de un cobro pendiente: usa Editar en la lista de cobros y elige la nueva forma en Método de pago. En Asaas, el Pix, el boleto o el enlace de tarjeta se actualizan y el código anterior deja de enviarse. En Mercado Pago, cancela y créalo de nuevo. - El cobro se creó, pero no llegó a la conversación: la plataforma avisa cuando solo falló el envío. No crees otro cobro; reenvía el existente desde la lista. Ver también - Visión general de Pagos - Conectar pasarela: Asaas y Mercado Pago - Descuentos y ajuste de valor - Suscripciones y planes recurrentes - Reembolsos, webhooks e informes - Planes de cobro y talonario de pagos

Suscripciones y planes recurrentes

Visión general Para ingresos que se repiten (mensualidades, planes de servicio, retainers), usa suscripciones. Defines el valor y el ciclo (semanal, mensual, anual, etc.), y la pasarela genera los cobros recurrentes automáticamente. ConversaLabs refleja cada cobro generado y el estado de la suscripción (activa, pausada, cancelada), además de alimentar los indicadores de MRR y churn en los informes. También puedes usar planes locales reutilizables: guardan conexión, importe, moneda y ciclo para varios suscriptores. Al crear cada suscripción, la plataforma envía la recurrencia a la pasarela; tener un plan local no significa que ya exista una entidad de plan en el panel de la pasarela. Requisitos previos - Una pasarela conectada que admita suscripciones (Asaas y Mercado Pago las admiten). - Para usar un plan reutilizable, mantén activa su conexión vinculada. La moneda del plan debe coincidir con la moneda de liquidación de esa conexión. - Un contacto/cliente con datos válidos en la pasarela. Paso a paso 1. En el área de Pagos, elige crear una suscripción. 2. Selecciona la pasarela (la conexión) y el cliente (contacto). 3. Define el valor y el ciclo de cobro (por ejemplo, mensual). 4. Define la fecha del próximo cobro y el método (PIX, boleto o tarjeta, según la pasarela). 5. (Opcional, según la conexión) Define un número máximo de cobros o una fecha final. El ciclo cada dos meses también aparece cuando la conexión lo admite. 6. (Opcional) Selecciona un plan local. La conexión, el importe, la moneda y el ciclo se completan y bloquean para mantener la suscripción coherente con la plantilla elegida. 7. Guarda. La pasarela empieza a generar los cobros en el ciclo definido. 8. Sigue cada cobro generado y el estado de la suscripción en la plataforma; el cliente recibe el cobro normalmente. Configuración y opciones Cobrar a una empresa 1. Elige el contacto responsable. En una conversación, este contacto conserva el contexto de atención. 2. En Pagador, elige Empresa y selecciona una empresa vinculada al contacto. Es una elección explícita: un vínculo del CRM o un producto del catálogo no determina por sí solo quién paga. 3. Revisa el registro de la empresa: razón social y documento fiscal, además del correo, teléfono y dirección exigidos por la pasarela y el método. Los datos fiscales del pagador proceden de la empresa elegida; los datos personales del contacto no sustituyen ese registro. 4. Si la lista está cargando o falla, espera o usa Reintentar. Un fallo de carga no se trata como ausencia de empresas. No cobres a una empresa incompleta como contacto para evitar el error. La creación en una conversación sigue requiriendo el contacto responsable. Una suscripción importada o registrada sin contacto no equivale a un flujo completo de conversación. En Asaas, no supongas que editar la empresa en la plataforma sincroniza automáticamente todos los campos de un cliente ya existente: comprueba también la razón social, el correo y la dirección en la pasarela. Planes de cobro y talonario de pagos Las cuotas nativas mensuales se emiten en la pasarela. La recurrencia limitada tiene una cantidad final, pero emite cobros progresivamente: el calendario previsto no es un boleto emitido. El plan de cobro también difiere de la plantilla reutilizable de suscripción de Planes. En Condiciones de pago, revisa los valores de la conexión y cambia solo lo necesario para el cobro. Un campo vacío no envía una sustitución explícita. La API de Asaas no permite consultar las multas e intereses configurados en la cuenta; revisa el panel del proveedor cuando sea necesario. - Ciclo: semanal, quincenal, mensual, cada dos meses (Asaas), trimestral, semestral o anual. La pantalla solo muestra los ciclos admitidos por la conexión. - Límites de recurrencia: número máximo de cobros termina tras una cantidad de ciclos; fecha final (Asaas) termina en el límite elegido y no puede ser anterior al primer cobro. También puedes ajustar la fecha final después en Editar suscripción; el máximo de cobros se define al crearla. - Una suscripción no es un pago en cuotas: la pasarela cobra el importe una vez por ciclo. Para dividir una compra única en cuotas, usa un plan de cobro compatible con el método. - Estado de la suscripción: activa, pausada, cancelada — reflejado desde las notificaciones de la pasarela. - Planes locales: crea una plantilla una vez y reutilízala en suscripciones compatibles. La pasarela sigue recibiendo y ejecutando cada suscripción. - Cancelación: cancela la suscripción en la plataforma; la pasarela detiene los próximos cobros. - Cobros generados: cada ciclo se convierte en un cobro reflejado, con su propio estado. Sin cliente vinculado Una suscripción que vino del gateway puede llegar sin cliente vinculado: el pagador que informa no coincidió con exactitud con ningún contacto de esta cuenta. Se registra así a propósito, con un distintivo Sin cliente, en lugar de desaparecer — el dinero sigue visible y el vínculo puede hacerse después. Usa el filtro de vínculo en la lista para ver solo estas. Mientras no tenga cliente, la suscripción no abre negocio, no puntúa el lead y no dispara ninguna acción que dependa de una persona. En las reglas de automatización, usa la condición Contacto vinculado a la suscripción con "está presente" para actuar solo cuando haya alguien del otro lado. Corregir cliente y vínculos 1. En la fila de la suscripción, usa Corregir cliente y vínculos cuando el contacto falte o sea incorrecto. 2. Elige un contacto existente o propón uno nuevo con nombre y al menos correo, teléfono o documento. Revisa también la organización y el plan alcanzados por la misma suscripción. 3. Para sustituir un vínculo que ya está completo, confirma la sustitución — la plataforma la pide de forma explícita para no sobrescribir por error un vínculo correcto. 4. Esta acción nunca cambia importe, ciclo, estado, próximo cobro ni identificador del gateway. Para esos datos, usa Editar suscripción o corrígelos en el origen. Casos de uso - Mensualidad de un servicio de suscripción. - Plan recurrente de soporte o consultoría (retainer). - Club/suscripción de contenido con renovación automática. Consejos, límites y buenas prácticas - Si la red falla durante la creación, vuelve a intentarlo sin cerrar el formulario: se retoma la misma operación y una respuesta incierta de la pasarela nunca crea otra suscripción a ciegas. - La recurrencia se delega a la pasarela — ella genera y cobra cada ciclo; la plataforma refleja el resultado. - Usa planes locales cuando muchos clientes se suscriben a la misma oferta: facilita mantener conexión, precio, moneda y ciclo consistentes. - El MRR de los informes normaliza cada suscripción activa a un valor mensual equivalente; el churn considera las canceladas en el período. - Comunica claramente al cliente el ciclo y el valor antes de activar la suscripción. Solución de problemas - El próximo cobro no se generó: confirma el estado de la suscripción (puede estar pausada o cancelada) y la configuración del webhook. - Los planes no aparecen: confirma que el plan no está archivado, que su conexión está activa y admite suscripciones, y que la moneda coincide con la moneda de liquidación. - Cancelé y aún cobró: verifica que la cancelación fue confirmada por la pasarela; el efecto aplica a los próximos ciclos. Ver también - Visión general de Pagos - Conectar pasarela: Asaas y Mercado Pago - Crear un cobro y enviarlo en la conversación - Descuentos y ajuste de valor - Reembolsos, webhooks e informes - Planes de cobro y talonario de pagos

Gestionar planes y ofertas de pago

Visión general El módulo Pagos ofrece dos catálogos reutilizables: - Planes guardan conexión, importe, moneda y ciclo para nuevas suscripciones. - Ofertas guardan precio, método de pago, tipo y vínculos opcionales con una conexión y un producto. La pantalla de Ofertas es administrativa. Nunca acepta una oferta ni crea un cobro sin el contexto de un contacto o una compra. Requisitos previos - Pagos debe estar habilitado para la cuenta. - Ten al menos una conexión activa de Asaas o Mercado Pago para crear planes. - Para vincular una oferta, crea primero el producto en Catálogo. - La eliminación permanente requiere permiso de administración de pagos. Paso a paso 1. Abre Pagos en el menú lateral. 2. Entra en Planes u Ofertas. 3. Usa búsqueda, filtros y ordenación para encontrar registros. La página y los filtros permanecen en la URL. 4. Haz clic en Nuevo plan o Nueva oferta, completa los campos y guarda. 5. Archiva un registro para retirarlo del uso. Abre Archivados para restaurarlo o, con el permiso necesario, eliminarlo definitivamente. 6. Para varias filas, selecciona los registros de la página y usa la barra de acciones masivas. Si una fila falla, revisa los IDs mostrados y corrige solo esas filas. 7. Al crear una suscripción, selecciona el plan opcional. La pantalla completa y bloquea conexión, importe, moneda y ciclo para que la suscripción coincida con la plantilla. 8. Usa Exportar CSV para descargar el resultado filtrado actual o, si hay una selección, solo los registros seleccionados, incluidos los conservados al cambiar de página. Configuración y opciones Planes Un plan es una plantilla local; no afirma que ya exista como entidad en la pasarela. La recurrencia real se crea en la pasarela solo cuando comienza una suscripción. La moneda debe coincidir con la moneda de liquidación de la conexión, y los ciclos visibles respetan sus capacidades; por ejemplo, el ciclo de cada dos meses aparece únicamente cuando la pasarela lo admite. Ofertas Elige order bump, upsell o downsell. La conexión puede usar la predeterminada de la cuenta y el producto es opcional. Al archivar una oferta se desactiva; al restaurarla permanece inactiva hasta que se revise y habilite de nuevo. Casos de uso - Reutilizar una cuota en varias suscripciones. - Ofrecer instalación, soporte prioritario o un complemento durante el checkout. - Mantener ofertas estacionales inactivas sin perder su configuración. - Separar ofertas por producto, conexión, tipo o estado. Consejos, límites y buenas prácticas - Confirma la moneda de liquidación de la conexión antes de publicar precios. - Archiva antes de eliminar definitivamente. La eliminación permanente no se puede deshacer. - Restaurar una oferta no la activa automáticamente; revisa primero precio, producto y conexión. - Una acción masiva se procesa registro por registro. Es normal obtener un resultado parcial si una fila incumple una regla de ciclo de vida. Solución de problemas - No aparece el ciclo de cada dos meses: la conexión seleccionada no anuncia esa capacidad. - No aparece un método de pago: la conexión elegida no lo admite. - No puedo eliminar: archiva primero el registro y confirma que tu perfil permite la eliminación permanente. - La lista quedó vacía tras filtrar: usa Limpiar filtros; también puedes quitar el estado de la URL. - La oferta restaurada está inactiva: es el comportamiento seguro. Edítala y actívala después de revisarla. Ver también - Crear cobros y enviarlos en una conversación - Suscripciones y planes

Planes de cobro y libreta de pagos

Visión general Un plan de cobro reúne las cuotas de una sola venta. El total contratado y el importe recibido son distintos: pagar una cuota no liquida todo el plan. Cada cuota mantiene su vencimiento, pago e historial. Requisitos previos Activa Pagos, conecta una pasarela compatible y revisa los datos del pagador. Las opciones dependen de la conexión, el método y el ciclo. Asaas ofrece cuotas nativas mensuales de boleto/Pix; otros ciclos usan recurrencia limitada cuando está disponible. Los planes de boleto/Pix y la recurrencia limitada solo aparecen cuando ese flujo está habilitado para la conexión. Las cuotas mensuales con tarjeta de crédito son un único cobro que la pasarela divide y siguen disponibles incluso sin planes de cobro. Esta entrega no incorpora integraciones directas con nuevos bancos. Paso a paso 1. Abre Nuevo cobro en Pagos o en una conversación y selecciona cliente, conexión y método. 2. Elige cuotas, informa el total, la cantidad, el primer vencimiento y el ciclo disponible. 3. Revisa el resumen y las condiciones antes de crear. 4. Abre el plan para seguir las cuotas emitidas y el progreso. 5. Usa Descargar libreta para obtener el PDF y Enviar libreta en la conversación para entregarlo al cliente; comprueba el destinatario antes de enviar. 6. En el menú de cada cuota, Ver cobro siempre está disponible. Enviar esta cuota a la conversación solo aparece en cuotas abiertas (pendiente, esperando pago o vencida). Configuración y opciones Las cuotas nativas mensuales se emiten en la pasarela. La recurrencia limitada tiene una cantidad final, pero emite cobros progresivamente: el calendario previsto no es un boleto emitido. El plan de cobro también difiere de la plantilla reutilizable de suscripción de Planes. En Condiciones de pago, revisa los valores de la conexión y cambia solo lo necesario para el cobro. Un campo vacío no envía una sustitución explícita. La API de Asaas no permite consultar las multas e intereses configurados en la cuenta; revisa el panel del proveedor cuando sea necesario. En el detalle del plan, configura los avisos de cuota pagada y de plan completado. Por defecto, el aviso de cada cuota pagada está desactivado y el de finalización está activado. La elección se aplica a ese plan; los canales de correo y push siguen sujetos a las preferencias de notificación del usuario. Activar un aviso no vuelve a enviar eventos que ya ocurrieron. Casos de uso Usa boleto mensual para una venta en 12 cuotas. Para un servicio trimestral con final definido, usa la recurrencia limitada disponible. Una suscripción sin límite sigue siendo un cobro recurrente, sin representar una venta en cuotas con total finito. Consejos, límites y buenas prácticas La libreta del cliente es el PDF de la plataforma con la marca de la cuenta. El PDF de Asaas sirve para comprobación interna. Boleto usa la línea digitable y el código de barras de la pasarela. En Pix, cada cuota sale en una tarjeta propia con el QR y el código Pix copia y pega completo, sin campos de boleto como agencia, cartera o ficha de compensación. No se deben inventar datos que la pasarela aún no haya proporcionado. La libreta muestra la situación actual de cada cuota. Cuando una cuota se paga, se cancela, se reembolsa o vence, y cuando el plan se cancela o se completa, la plataforma vuelve a generar la libreta automáticamente, en pocos segundos. Una cuota pagada sale con Pagada el y la fecha; una cuota cancelada o reembolsada sale con la situación destacada. En esos casos la libreta no incluye QR, código para copiar y pegar, línea digitable ni código de barras, para que el cliente no pague dos veces. Mientras se actualiza, el plan muestra Actualizando la libreta y el envío espera la nueva versión; el archivo anterior sigue disponible para descargar. Un plan cancelado o completado ya no tiene cuotas pendientes de pago. La libreta sigue disponible para consulta, pero Enviar libreta en la conversación y Notificaciones de este plan dejan de aparecer. Cancelar interrumpe lo que permita la pasarela; archivar organiza la vista y no devuelve dinero. Eliminar un acuerdo de cuotas nativo de Asaas es irreversible. Al cancelar un cobro en cuotas con tarjeta, se cancelan juntas todas las cuotas que siguen abiertas en la pasarela; las cuotas ya pagadas se conservan. Las cuotas liquidadas requieren el flujo de reembolso correspondiente; no las elimines para corregir un ingreso. Solución de problemas Faltan cuotas futuras: en recurrencia limitada, consulta el calendario previsto y espera su emisión por la pasarela. La libreta aún no está disponible: revisa la generación y vuelve a intentar después de actualizar las cuotas. La libreta muestra una cuota pagada como pendiente: espera unos segundos mientras el plan muestra Actualizando la libreta y vuelve a descargar el PDF. Si el aviso no desaparece, o si aparece que no se pudo actualizar, usa Volver a generar la libreta en el plan; el archivo anterior sigue disponible mientras tanto. Enviar libreta en la conversación no aparece: el plan se canceló o se completó, o la libreta se está actualizando. Para cobrar una cuota concreta que sigue abierta, usa Enviar esta cuota a la conversación en el menú de esa cuota. Método o ciclo no disponible: elige una combinación ofrecida por la conexión. Pix recurrente de Mercado Pago no está disponible. Las cuotas con este método aún no están habilitadas: la conexión todavía no tiene habilitado el flujo de planes para boleto o Pix. Usa un pago único o cuotas con tarjeta de crédito. Las cuotas 2 en adelante no aparecen en la plataforma: en las cuotas con tarjeta, la venta se registra como un único cobro y la pasarela gestiona las cuotas. La conciliación muestra esas cuotas como no vinculadas, sin tratarlas como fallos. Libreta no disponible en un plan con tarjeta: la libreta solo existe para boleto y Pix. En un plan con tarjeta, cada cuota tiene su propia página de pago. Aviso "Prueba · el pago no es real": el cobro o el plan se creó en una conexión de prueba (sandbox). Todo se crea y se envía normalmente, pero el pago no mueve dinero. Usa la conexión de producción para cobrar a clientes reales. El total difiere de lo recibido: revisa pagos, reembolsos y reversiones por cuota. Lo recibido crece al liquidarse cada cuota. Ver también - Crear y enviar un cobro - Condiciones de pago - Suscripciones y planes

Página pública de cobro

Visión general La página pública de ConversaLabs presenta un cobro al pagador sin acceso al panel. El enlace permite consultar ese cobro; no concede acceso a la cuenta ni a otras ventas. Requisitos previos El cobro debe estar disponible y tener un enlace válido. El método debe proporcionar los instrumentos necesarios. Los certificados y las credenciales de la pasarela nunca se muestran al pagador. Paso a paso 1. Abre el detalle del cobro en Pagos. 2. Revisa importe, vencimiento, método y estado. 3. Comparte el enlace solo con el destinatario correcto. 4. El pagador lo abre y usa los instrumentos mostrados para pagar. 5. Comprueba la confirmación en el panel antes de dar el ingreso por concluido. Configuración y opciones La página muestra importe, moneda, vencimiento y estado. Cuando están disponibles, presenta línea digitable y PDF del boleto o código Pix para copiar y pegar y QR. Los campos ausentes no se inventan. La página solo consulta el cobro; no emite, cancela ni reembolsa pagos. Casos de uso Comparte acceso sencillo a boleto o Pix sin permisos del panel. Cada cuota mantiene sus propios datos de pago; el talonario reúne las cuotas a medida que se emiten. Consejos, límites y buenas prácticas El estado refleja la última actualización recibida por la plataforma y puede demorarse respecto del banco. La hora mostrada corresponde a la actualización local. Quien posee el enlace puede consultar el cobro: evita publicarlo en grupos o páginas abiertas. Los enlaces archivados, revocados, vencidos o invalidados por privacidad quedan indisponibles. Solución de problemas Enlace no disponible: pide al operador que revise si el cobro sigue disponible. Falta PDF, línea o QR: revisa los instrumentos proporcionados por la pasarela. Pagado pero pendiente: espera el procesamiento y verifica el ingreso en la pasarela; reabrir la página no fuerza una consulta financiera al banco. Ver también - Gestionar cobros - Planes de cobro y talonario

Descuentos y ajuste de valor

Visión general Puedes reducir el valor de un cobro o suscripción aplicando descuentos. El descuento puede ser por línea de cobro (en un ítem específico) o sobre el total de la transacción. El valor enviado a la pasarela es siempre el valor neto — es decir, el subtotal menos el descuento. Los proveedores de pago no se modifican; solo reciben el valor final ya calculado. Opcionalmente, tu cuenta puede exigir un motivo al aplicar un descuento, para mantener historial y control de quién otorgó cada reducción. Requisitos previos - Módulo Pagos habilitado y una pasarela conectada. - Permiso para crear/editar cobros y suscripciones. - Si tu conexión exige motivo del descuento, ten la justificación a mano. Paso a paso 1. Al crear (o editar) un cobro o suscripción, ubica el campo de descuento. 2. Elige dónde aplicarlo: - Por ítem: ingresa el descuento en la línea de cobro correspondiente. - Sobre el total: ingresa el descuento sobre la suma de las líneas. 3. Define el valor del descuento. 4. Si se solicita, ingresa el motivo del descuento. 5. Revisa el valor final (subtotal − descuento) antes de guardar. 6. Guarda y, en el caso de un cobro, envíalo en la conversación normalmente. Configuración y opciones Planes de cobro y talonario de pagos Un plan de cobro reúne las cuotas de una sola venta. El total contratado y el importe recibido son distintos: pagar una cuota no liquida todo el plan. Cada cuota mantiene su vencimiento, pago e historial. - Descuento por ítem vs. descuento sobre el total: combina ambos cuando lo necesites — el total refleja la suma de las reducciones. - Exigir motivo del descuento: una opción por conexión; cuando está activa, el descuento solo se acepta con justificación. - Valor neto: la pasarela siempre recibe el valor con el descuento ya aplicado; no hay cálculo posterior del lado del proveedor. - Informes: el total de descuentos otorgados aparece en los informes de Pagos. El descuento comercial reduce el total de la venta antes de dividirlo en cuotas. Es distinto del descuento por pago anticipado de la pasarela. Revisa el total y el resumen después de aplicarlo; un cambio no debe reescribir cuotas liquidadas. Casos de uso - Otorgar un descuento puntual para cerrar una venta. - Aplicar una reducción a un ítem específico de un cobro con varios productos. - Ofrecer un valor promocional en una suscripción. - Mantener trazabilidad de quién otorgó cada descuento exigiendo un motivo. Consejos, límites y buenas prácticas - El descuento reduce el valor neto enviado a la pasarela — revisa el total antes de enviar. - Estandariza los motivos de descuento para facilitar el análisis en los informes. - Para seguir el impacto, usa la métrica de descuentos otorgados y el ticket medio en los informes. - Recuerda: los valores van en unidades mayores (R$ 10,00 = 10.00). Solución de problemas - No puedo guardar sin motivo: tu conexión exige justificación — completa el motivo del descuento. - El total no cuadró: verifica si hay descuentos por ítem y sobre el total al mismo tiempo; el valor final es el subtotal menos la suma de los descuentos. - El descuento no aparece en la pasarela: el proveedor solo recibe el valor neto; el detalle del descuento queda en la plataforma. Ver también - Crear un cobro y enviarlo en la conversación - Suscripciones y planes recurrentes - Reembolsos, webhooks e informes - Visión general de Pagos - Planes de cobro y talonario de pagos

Condiciones de pago y simulación de cuotas

Visión general Un cobro tiene más decisiones que solo el importe. Condiciones de pago reúne todo lo que cambia cuánto paga el cliente y cuánto recibe tu empresa: - Multa por demora — se cobra una vez, cuando el cobro vence sin pagarse. - Intereses mensuales — se acumulan mientras el cobro sigue vencido. - Descuento por pago anticipado — una reducción si el cliente paga antes de una fecha. - Cuotas y quién paga los intereses — la empresa asume el costo, o lo paga el cliente. Y la simulación responde, antes de cobrar, las dos preguntas que importan: ¿cuánto paga el cliente por mes? y ¿cuánto recibes? Requisitos previos - Una conexión de pasarela activa en Pagos → Configuración. - Las condiciones dependen de la pasarela. Asaas acepta multa, intereses y descuento por pago anticipado; Mercado Pago no expone esos campos, así que no aparecen en una conexión Mercado Pago. - Tarjeta, boleto y Pix tienen modalidades distintas de cuotas según la conexión. Una suscripción cobra un importe por ciclo; la recurrencia limitada tiene una cantidad final. Paso a paso Definir el valor predeterminado de la cuenta 1. Ve a Pagos → Configuración → Conexiones y edita la conexión. 2. En Intereses de las cuotas, elige quién paga: - La empresa los asume — el cliente paga el importe del cobro dividido en cuotas y la comisión de la pasarela sale de tu neto. Es el comportamiento predeterminado. - Los paga el cliente — se añaden intereses a cada cuota para que recibas el importe completo. 3. Si eliges Los paga el cliente, indica la tasa mensual. En blanco, usamos la tabla de comisiones de la propia pasarela — y la ayuda debajo del campo muestra a cuánto equivale por mes en la cantidad de cuotas elegida, antes de que decidas sobrescribirla. 4. Guarda. Cada cobro nuevo nace con esa elección — y cada cobro puede cambiarla. Aplicar condiciones a un cobro 1. Abre Nuevo cobro y elige la forma de pago. 2. En el bloque Condiciones de pago, completa multa, intereses y descuento por pago anticipado. 3. Elige Porcentaje o Importe fijo junto al campo de multa y descuento. 4. Si es tarjeta de crédito, elige la cantidad de cuotas. El bloque Simulación aparece debajo. Leer la simulación El bloque muestra dos columnas: - El cliente paga — por ejemplo 12x de R$ 83,08 (última de R$ 83,12) y el total. La última cuota lleva el resto de la división; así es como la pasarela divide el importe. - Recibes — el neto después de la comisión de la pasarela, con la comisión detallada debajo. Cuando la pasarela confirma la simulación, aparece la etiqueta Confirmado por la pasarela. Configuración y opciones Planes de cobro y talonario de pagos Las cuotas nativas mensuales se emiten en la pasarela. La recurrencia limitada tiene una cantidad final, pero emite cobros progresivamente: el calendario previsto no es un boleto emitido. El plan de cobro también difiere de la plantilla reutilizable de suscripción de Planes. En Condiciones de pago, revisa los valores de la conexión y cambia solo lo necesario para el cobro. Un campo vacío no envía una sustitución explícita. La API de Asaas no permite consultar las multas e intereses configurados en la cuenta; revisa el panel del proveedor cuando sea necesario. | Condición | Asaas | Mercado Pago | |---|---|---| | Multa por demora (% o importe fijo) | Sí | No | | Intereses mensuales | Sí | No | | Descuento por pago anticipado | Sí | No | | Las tres en una suscripción | Sí | No | | Elegir quién paga los intereses de las cuotas | Sí | No — la empresa siempre los asume | | Máximo de cuotas con tarjeta | 21 | 36 | | Mostrar el neto antes del pago | Sí | No | Dejar un campo en blanco no envía una sustitución explícita. Revisa el valor de la conexión y el panel de la pasarela. Cero es un valor explícito; confirma el resultado antes de prometer exención de multas o intereses. Casos de uso - Servicio recurrente con demoras frecuentes: multa del 2% + 1% de interés mensual en la suscripción. Cada cobro que genere la recurrencia hereda la política. - Producto de ticket alto: 12x con los paga el cliente, para recibir el importe completo. - Incentivo a pagar antes: 5% de descuento hasta 3 días antes del vencimiento. - Multa en dinero: R$ 10,00 fijos en lugar de un porcentaje, en cobros de importes muy distintos. Consejos, límites y buenas prácticas - Una multa o descuento de importe fijo nunca puede superar el propio cobro. - Un porcentaje nunca pasa de 100. - Si eliges Los paga el cliente sin tasa mensual y sin la tabla de comisiones de la pasarela disponible, el cobro se rechaza con un mensaje que pide la tasa — en lugar de cobrarle a tu empresa en silencio. - Al editar un cobro pendiente, las condiciones también viajan a la pasarela. Vaciar todos los campos elimina la política del cobro. - La simulación es una estimación hasta que aparece la etiqueta de confirmación. Cuando la pasarela no informa el neto (Mercado Pago), la pantalla lo dice — nunca mostramos un número estimado ahí. Solución de problemas "No se pudo calcular la simulación en este momento." Una indisponibilidad momentánea de la pasarela. Usa Intentar de nuevo; el cobro se puede crear igualmente. "Esta pasarela no informa el importe neto antes del pago." Es lo esperado en Mercado Pago. Lo que paga el cliente sigue siendo correcto; el neto solo se conoce después de la liquidación. "No pudimos leer la tabla de comisiones de esta cuenta en la pasarela ahora mismo." La lectura falló: una credencial rechazada, una caída o una respuesta inesperada de la pasarela. Usa Leer las comisiones de nuevo ahí mismo: no se guarda nada cuando la lectura falla, así que el botón consulta la pasarela de verdad. Guardar la conexión de nuevo también fuerza una nueva lectura. No aparecen las opciones de multa e intereses. La conexión es Mercado Pago, que no ofrece esos campos. No aparece el campo de cuotas. Revisa la modalidad, el método y los límites ofrecidos por la conexión. Ver también - Descuentos y ajuste de importe - Crear un cobro y enviarlo en la conversación - Suscripciones y planes - Conectar una pasarela - Planes de cobro y talonario de pagos

Agendamiento pago

Visión general El agendamiento pago conecta la Agenda con el módulo de Pagos: el cliente solo confirma una reserva después de pagar. Cuando alguien agenda un tipo de evento marcado como pago, la plataforma crea un cobro automáticamente (un PIX, por ejemplo), retiene el horario mientras el pago está pendiente y confirma la reserva sola cuando la pasarela avisa que se pagó. Es ideal para consultas, sesiones y servicios en los que quieres asegurar el compromiso del cliente con un pago anticipado — reduciendo ausencias y no-shows. Requisitos previos - Módulos Agenda y Pagos habilitados. - Una pasarela conectada y válida. - Un tipo de evento (en la Agenda) configurado para cobrar — con valor y modo de pago. Paso a paso 1. En la Agenda, abre el tipo de evento que debe exigir pago. 2. Define el modo de pago del tipo de evento (por ejemplo, un pago único para liberar la reserva). 3. Ingresa el valor de la reserva y el método (PIX, boleto o tarjeta, según la pasarela). 4. Guarda el tipo de evento. 5. Cuando un cliente agende ese tipo de evento, la plataforma crea el cobro y deja la reserva esperando pago. 6. El cliente paga; la pasarela notifica y la reserva pasa a confirmada automáticamente. 7. Sigue tanto el cobro (en Pagos) como la reserva (en la Agenda). Configuración y opciones - Modo de pago por tipo de evento: definido en la Agenda (por ejemplo, pago anticipado obligatorio). - Reserva esperando pago: el horario queda reservado/retenido hasta la confirmación; las reservas no pagadas pueden expirar según la regla configurada. - Confirmación automática: la reserva pasa a confirmada al recibir el evento de pago de la pasarela — sin acción manual. - Método de cobro: PIX, boleto o tarjeta, según la pasarela conectada. Casos de uso - Un consultorio que exige pago por adelantado de las consultas. - Un profesional que cobra una seña para reservar un horario. - Servicios de alta demanda donde el pago anticipado asegura el compromiso. Consejos, límites y buenas prácticas - Usa PIX para liberar la reserva más rápido (confirmación casi inmediata). - Deja claro en la descripción del tipo de evento que el horario solo se confirma tras el pago. - Define un plazo razonable para la reserva pendiente, evitando retener horarios demasiado tiempo. - La confirmación depende del webhook de la pasarela; mantenlo configurado correctamente. Solución de problemas - La reserva no se confirma tras el pago: verifica el webhook de la pasarela (consulta Reembolsos, webhooks e informes). - No aparece la opción de cobrar en el tipo de evento: confirma que los módulos Agenda y Pagos estén habilitados y que haya una pasarela conectada. - El horario se liberó sin pago: revisa el modo de pago del tipo de evento (debe exigir pago anticipado). Ver también - Visión general de Pagos - Crear un cobro y enviarlo en la conversación - Suscripciones y planes recurrentes - Reembolsos, webhooks e informes

Reembolsos, webhooks e informes

Visión general Este artículo cubre lo que ocurre después de enviar el cobro: cómo devolver dinero (reembolso), cómo el webhook mantiene los estados sincronizados sin que hagas nada y qué informes muestran la salud financiera de la operación. El webhook es el canal por el que la pasarela avisa a la plataforma de cada cambio (pagado, vencido, reembolsado, cancelado). Por eso es la fuente de verdad: la plataforma actualiza el estado del cobro a partir del webhook, no de la pantalla de "éxito" del checkout. Requisitos previos - Módulo Pagos habilitado y una pasarela conectada con el webhook configurado. - Permiso para emitir reembolsos. - Para los informes, tener cobros/suscripciones registrados en el período. Paso a paso Reembolsar un cobro 1. Abre el cobro que deseas reembolsar (ya pagado). 2. Elige reembolsar. 3. Selecciona total (devuelve el valor entero) o parcial (ingresa el valor a devolver). 4. Confirma. La plataforma solicita el reembolso a la pasarela. 5. Observa el estado cambiar a reembolsado (o parcialmente reembolsado) cuando la pasarela confirme. Verificar el webhook 1. En la configuración de la conexión de la pasarela, revisa la URL del webhook y el secreto de verificación. 2. Asegúrate de que la URL esté registrada en el panel de la pasarela. 3. Haz una prueba y observa el estado actualizarse automáticamente. Leer los informes 1. Abre los informes de Pagos. 2. Filtra por período. 3. Analiza los indicadores (facturación, ticket medio, MRR, churn) y los cortes por estado, pasarela y moneda. Configuración y opciones Planes de cobro y talonario de pagos Faltan cuotas futuras: en recurrencia limitada, consulta el calendario previsto y espera su emisión por la pasarela. El talonario aún no está disponible: revisa la generación y vuelve a intentar después de actualizar las cuotas. Método o ciclo no disponible: elige una combinación ofrecida por la conexión. Pix recurrente de Mercado Pago no está disponible. El total difiere de lo recibido: revisa pagos, reembolsos y reversiones por cuota. Lo recibido crece al liquidarse cada cuota. - Reembolso total vs. parcial: ambos admitidos por las pasarelas actuales. - Webhook: autenticado por cada pasarela (token en el encabezado en Asaas; firma en Mercado Pago); las notificaciones repetidas se manejan de forma segura (sin duplicar efectos). - Indicadores de los informes: | Indicador | Qué muestra | |---|---| | Facturación | Total recibido en el período | | Ticket medio | Valor medio por cobro pagado | | Descuentos otorgados | Suma de los descuentos aplicados | | Por estado | Distribución entre pagado, pendiente, vencido, etc. | | Por pasarela | Cuánto ingresó por Asaas / Mercado Pago | | Por moneda | Cortes cuando hay más de una moneda | | MRR | Ingreso recurrente mensual de las suscripciones activas | | Churn | Suscripciones canceladas en el período | Casos de uso - Devolver un valor a un cliente que desistió (reembolso total). - Revertir parte de un cobro (reembolso parcial). - Seguir el crecimiento del ingreso recurrente con el MRR. - Identificar la pérdida de suscriptores con el churn. Consejos, límites y buenas prácticas - Confía siempre en el webhook para el estado; la pantalla del checkout puede renderizar antes de la confirmación. - El reembolso lo procesa la pasarela — el plazo para que el dinero llegue al cliente sigue las reglas del proveedor/medio de pago. - Sigue MRR y churn juntos para tener la foto real de la recurrencia. - Mantén la URL del webhook accesible y el secreto de verificación correcto; sin eso, los estados no se actualizan. Solución de problemas - El estado nunca cambia a pagado: el webhook no está llegando o fue rechazado (firma/token incorrectos) — vuelve a configurar el webhook en la conexión. - El reembolso no concluye: confirma que el cobro estaba pagado y que la pasarela admite el tipo de reembolso solicitado. - Informe vacío: verifica el filtro de período y si hay cobros en el rango. - El MRR parece incorrecto: confirma los ciclos de las suscripciones; el MRR normaliza cada una al equivalente mensual. Ver también - Visión general de Pagos - Conectar pasarela: Asaas y Mercado Pago - Crear un cobro y enviarlo en la conversación - Suscripciones y planes recurrentes - Descuentos y ajuste de valor - Planes de cobro y talonario de pagos

Importar historial de la pasarela con seguridad

Visión general La importación de historial trae a ConversaLabs cobros, vínculos de clientes y suscripciones que ya existen en la pasarela. Los cobros crean eventos financieros, Pedidos e informes; las suscripciones aparecen en Pagos > Suscripciones; y un cliente importado solo crea un vínculo técnico con un contacto que ya existe en la cuenta. El proceso está gobernado: una vista previa no guarda cobros, vínculos ni suscripciones; solo persiste la ejecución auditada y la captura usada para revisar la selección. Una importación real incluye únicamente los registros que selecciones. La plataforma nunca crea contactos ni empresas silenciosamente: un cobro sin coincidencia exacta queda bloqueado hasta que elijas un contacto existente o propongas uno nuevo, que solo se crea tras la confirmación final. Cuando el cobro y la suscripción tienen el mismo identificador de suscripción de la pasarela, también se vinculan entre sí aunque los importes en un orden u otro. Los cobros históricos no envían mensajes al cliente, conversiones publicitarias, comisiones ni webhooks de salida. Requisitos previos - Debes ser administrador de la cuenta. - La conexión de Asaas o Mercado Pago debe estar activa y con credenciales verificadas. - Para cobros de Mercado Pago, elige una fecha inicial dentro de los últimos 12 meses. La búsqueda completa de ese recurso sigue esa ventana móvil. - Para clientes de Mercado Pago, informa el correo electrónico del cliente. Su API documentada no ofrece un barrido total de clientes. - Revisa la fecha de corte antes de permitir la adopción automática de cobros desconocidos por webhook. Paso a paso 1. Ve a Configuración > Pagos > Conexiones y elige Importar historial en la conexión necesaria. También puedes abrir la acción desde el estado vacío de Cobros. 2. En Recurso para importar, elige Cobros, Vínculos de clientes o Suscripciones. Las protecciones de entrada y la adopción automática se aplican solo a los cobros. 3. Para cobros, configura la fecha de corte y mantén la adopción automática desactivada salvo que tu operación tenga una regla clara. “Solo desde la fecha de corte” exige una fecha válida. 4. Indica el período y el límite de registros. Para un cliente de Mercado Pago, informa también el correo. Elige Generar vista previa. 5. Revisa la lista detallada. Cada cobro muestra los datos del cliente proporcionados por la pasarela, el contacto encontrado y la señal exacta usada para asociarlo. Busca por identificador, referencia o cliente; combina filtros; cambia el orden y recorre las páginas sin perder selecciones realizadas en otras páginas. 6. En un cobro marcado como Cliente pendiente, elige un contacto existente o propón uno nuevo con nombre y al menos un identificador (correo, teléfono o documento). La propuesta no crea nada durante la vista previa. Las coincidencias automáticas usan solo cliente de pasarela, correo, teléfono normalizado o documento exactos; un nombre parecido nunca basta. 7. Usa Seleccionar importables de esta página, Seleccionar todos los importables de estos filtros (cuando la vista previa supera una página) o marca cada fila. La selección global abarca todas las páginas del recorte actual, pero solo alcanza registros importables con cliente resuelto: una fila ignorada, ya sincronizada o pendiente nunca se marca. Cambiar un filtro limpia la selección intencionalmente; cambiar de página la conserva. La conexión, la ejecución, los filtros y el orden quedan en la URL, por lo que volver, avanzar o reabrir el enlace restaura la misma vista solo cuando la conexión pertenece a la cuenta actual. 8. Elige Importar seleccionados, revisa la cantidad exacta y las resoluciones de cliente en la confirmación y confirma. Una selección vacía nunca significa “importar todo”. Los contactos propuestos se crean dentro de la importación confirmada; si una validación falla, el cobro correspondiente no entra sin contacto. 9. Sigue el resultado y el historial de la conexión. Los registros con fallos muestran su identificador y motivo; el éxito nunca incluye una fila que falló. Configuración y opciones Fecha de corte y adopción automática La fecha de corte limita la entrada de historial. La adopción automática de cobros recibidos por webhooks está desactivada de forma predeterminada. Si habilitas la adopción desde la fecha de corte, la plataforma falla de forma segura cuando la fecha falta o es inválida. Lista de la vista previa La vista previa es una captura segura de la misma ejecución que importaría los datos, sin guardar cobros, vínculos ni suscripciones. La lista usa paginación y totales del servidor; el contador no se calcula solo con la página visible. En pantallas pequeñas, los filtros y el orden se abren en un panel propio y cada fila se convierte en una tarjeta legible. Los chips muestran los filtros activos. Limpiar filtros está disponible cuando una combinación no encuentra resultados. Si se alcanza el límite solicitado, la vista previa informa que fue truncada: genera otra ventana en lugar de asumir que se leyó todo el historial. Registros ignorados En una vista previa, usa el icono de bloqueo junto a un registro para ignorarlo permanentemente e indica el motivo. La decisión se separa por cobro, cliente o suscripción, incluso si la pasarela reutiliza un identificador. En Registros ignorados permanentemente, usa Permitir nuevamente para deshacerla. Vínculos con contactos y empresas La plataforma busca primero coincidencias exactas por cliente de pasarela, correo, teléfono normalizado, documento y CNPJ. Para un cobro sin contacto, debes elegir manualmente un contacto de la cuenta o proponer uno nuevo antes de seleccionarlo. La creación se aplaza hasta la confirmación y un vínculo manual nunca se sustituye silenciosamente. Una suscripción sin contacto sigue visible para una conciliación posterior; un cliente del directorio sin contacto se omite porque no hay propietario local seguro para el vínculo. Los cobros y las suscripciones se conectan solo por el identificador exacto informado por la pasarela, nunca por importe, fecha o nombre. Casos de uso - Recuperar cobros, Pedidos y suscripciones después de conectar una pasarela que ya tenía ventas. - Importar primero los vínculos de clientes de Asaas y después las suscripciones para aumentar la asociación exacta por identificador de la pasarela. - Reconstruir informes internos sin notificar a los clientes sobre transacciones antiguas. - Excluir permanentemente un cobro que pertenece a otra operación o que no es una venta. - Importar primero un período pequeño, validar la vista previa y continuar en ventanas menores. Consejos, límites y buenas prácticas - Empieza con una ventana corta y un límite bajo; amplía solo después de revisar la vista previa. - Cada vista previa/importación y cada selección explícita aceptan como máximo 5.000 registros. - Una importación confirmada debe usar exactamente el mismo tipo de recurso, período, límite y correo de la vista previa completada. Si cambia cualquier parámetro, genera una nueva vista previa; esto se aplica a cobros, clientes y suscripciones. - La selección es obligatoria. La plataforma nunca interpreta una selección vacía como “importar todo”. - La selección se conserva al paginar y Seleccionar todos abarca todas las páginas de los filtros actuales, pero se limpia al cambiar la búsqueda o los filtros para evitar importar por error una fila que ya no está visible. - Los cobros sin contacto resuelto no pueden seleccionarse. Resuelve cada uno manualmente; la API también bloquea intentos de omitir la vista previa. - La lista de registros ignorados se carga completa mediante páginas internas; más de 100 exclusiones nunca desaparecen silenciosamente. - Los clientes no usan filtros por fecha y solo pueden vincular un contacto existente. La búsqueda de clientes de Mercado Pago siempre se dirige por correo. - Los totales se muestran por moneda; no sumes monedas distintas como un único importe. - La reversión elimina solo registros locales creados por esa ejecución. Nunca cambia la pasarela. - Para revertir, abre una ejecución elegible en el historial, escribe undo y confirma. Si un movimiento posterior de un cobro, vínculo de cliente, suscripción, Pedido o evento cambió los datos, se rechaza toda la reversión para conservar la auditoría. La reversión elimina solo registros y vínculos creados por la ejecución; conserva contactos y organizaciones, incluido un contacto propuesto y confirmado manualmente. - Las ejecuciones antiguas realizadas antes del registro de reversión pueden no ser elegibles. Conserva su historial y usa la operación financiera normal para las correcciones. Solución de problemas Mercado Pago pide una fecha inicial Introduce una fecha dentro de la ventana de historial admitida por Mercado Pago. Una fecha anterior puede generar una vista incompleta y la plataforma la rechaza. No puedo importar sin seleccionar registros Es esperado. Genera una vista previa, selecciona los registros deseados y ejecuta la importación seleccionada. Un cobro no se puede seleccionar porque el cliente está pendiente Abre la resolución de cliente en esa fila. Elige un contacto existente o propón uno nuevo con nombre y correo, teléfono o documento. Guarda la decisión, selecciona el cobro y confirma la importación. El contacto propuesto no existe hasta esa confirmación. Mercado Pago pide el correo del cliente Es esperado. La búsqueda documentada de clientes de Mercado Pago exige correo y no permite una importación general de la agenda. Informa el correo del cliente existente que deseas vincular o importa suscripciones, que intentan asociar los datos de pagador entregados por la pasarela. Un cobro aparece como ignorado Abre Cobros ignorados permanentemente en la misma pantalla, revisa el motivo y usa Permitir nuevamente si puede considerarse otra vez. La reversión fue rechazada Hubo un movimiento posterior o el registro no fue creado por la ejecución elegida. No se eliminó ningún dato. Revisa la fila del historial y los eventos del cobro y usa la operación financiera normal adecuada. Ver también - Conectar una pasarela de pagos - Gestionar cobros - Reembolsos, webhooks e informes

Configurar los mensajes de pago

Visión general Los pagos envían al cliente dos mensajes: el cobro y la confirmación de pago. Aquí personalizas el cuerpo de cada uno por idioma, sin IA. Lo que no personalices sigue usando el mensaje incluido de ConversaLabs. Además del cuerpo, editas las etiquetas auxiliares del cobro (leyendas, textos de botón, las líneas de importe y vencimiento y las instrucciones para copiar el código) y configuras, por tipo de mensaje y por idioma, la plantilla aprobada de WhatsApp que se usa cuando la ventana de 24 h está cerrada. Requisitos previos - Pagos habilitado en la cuenta y permiso de administrador. - Para configurar el envío fuera de la ventana: una bandeja de WhatsApp Cloud con plantillas aprobadas por Meta. Paso a paso 1. Abre Configuración → Pagos → Mensajes. 2. Elige el idioma en el selector superior. Se abre en el idioma de la cuenta y lista todos los idiomas habilitados en la instalación (hasta 40), indicando cuántos ya tienen texto tuyo ("N de M idiomas con contenido"). 3. Escribe los cuerpos de cobro y confirmación en Markdown. Vacío = mensaje incluido del idioma (etiqueta Predeterminado). 4. Usa las variables ({x}) para insertar datos del contacto, la cuenta y el propio cobro. El selector ofrece solo las variables que realmente se resuelven en ese mensaje. 5. Abre el bloque Etiquetas auxiliares para ajustar las 12 etiquetas del cobro. 6. El bloque Fuera de la ventana de 24 h (WhatsApp Cloud) aparece abierto, justo debajo de cada tipo de mensaje. Elige la plantilla aprobada de ese tipo en ese idioma, mapea los parámetros {{1}}, {{2}}… y completa el botón de enlace, si lo hay. Si aún no existe una plantilla, usa Crear a partir de mi texto para generarla desde el cuerpo que escribiste. 7. Revisa la vista previa por canal, usa Enviar prueba para validarlo en una conversación real y haz clic en Guardar mensajes — también después de crear una plantilla, porque crear la plantilla no guarda la configuración. Restaurar predeterminado elimina la personalización en el servidor, no solo en la pantalla. Configuración y opciones Planes de cobro y talonario de pagos El talonario del cliente es el PDF de la plataforma con la marca de la cuenta. El PDF de Asaas sirve para comprobación interna. Boleto usa la línea digitable y el código de barras de la pasarela; Pix usa QR y código para copiar y pegar, sin línea digitable de boleto. No se deben inventar datos que la pasarela aún no haya proporcionado. Cancelar interrumpe lo que permita la pasarela; archivar organiza la vista y no devuelve dinero. Eliminar un acuerdo de cuotas nativo de Asaas es irreversible. Las cuotas liquidadas requieren el flujo de reembolso correspondiente; no las elimines para corregir un ingreso. Idiomas y respaldo El idioma es un selector con todos los idiomas habilitados en la instalación. Al enviar, ConversaLabs busca el texto en este orden: idioma del contacto → mismo idioma base (pt_BR ↔ pt) → idioma de la cuenta → mensaje predeterminado incluido. Etiquetas auxiliares Son 12 etiquetas: leyendas, textos de botón, las líneas de importe y vencimiento y las instrucciones para copiar el código. Están en un bloque plegable y siguen las mismas reglas de idioma y de restauración que el cuerpo. Título de los botones (opcional) Puedes escribir un título que aparece encima del mensaje con botones en WhatsApp Web. Déjalo vacío para enviar sin encabezado: la plataforma no añade texto genérico. El límite es de 60 bytes (los acentos y emojis cuentan más de uno); un título más largo no se guarda. El título puede ser distinto por idioma y no aparece en la vista previa del cuerpo. Confirmación de pago: qué reemplaza el cuerpo El cuerpo de la confirmación reemplaza solo la línea de título ("Pago confirmado ✅"). En un cobro único, la línea Monto pagado se sigue enviando justo debajo y se edita en Etiquetas auxiliares, no en el cuerpo. En la cuota de un plan de cobro, tu cuerpo abre el mensaje y la línea de abajo indica qué cuota se recibió (por ejemplo, "Recibimos la cuota 2/6"). Con el cuerpo vacío, la cuota recibe solo esa línea predeterminada. Fuera de la ventana de 24 h, se aplica la plantilla aprobada, como antes. Fuera de la ventana de 24 h (WhatsApp Cloud) El bloque aparece abierto e integrado justo debajo de cada tipo de mensaje — no es una sección que tengas que expandir. La plantilla es por tipo de mensaje y por idioma — cobro y confirmación tienen la suya, en lugar de una única plantilla para todo el módulo. Ahí tienes: - Elegir la plantilla aprobada del catálogo. - Sincronizar desde Meta y Crear a partir de mi texto están siempre visibles. Cuando la acción no está disponible, el botón aparece deshabilitado con el motivo escrito al lado: la bandeja no es WhatsApp Cloud, la cuenta no tiene el WhatsApp Inbox Suite, o tu perfil no gestiona bandejas de entrada. - Sincronizar desde Meta actualiza la lista de plantillas aprobadas. - Crear a partir de mi texto genera la plantilla desde el texto de ese tipo en ese idioma, enviándola a Meta como plantilla UTILITY, convirtiendo cada {{ variable }} en {{1}}, {{2}}… y dejando el mapeo listo. Sin texto del que generar, el botón queda deshabilitado y la pantalla pide escribir el texto primero. - Tras el envío, la plantilla todavía no está aprobada: aparece en el selector marcada como esperando aprobación y solo empieza a entregar cuando Meta la aprueba y tú sincronizas. Enviar de nuevo con el mismo nombre reemplaza el borrador pendiente, en lugar de fallar. - Crear la plantilla no guarda la configuración — haz clic en Guardar mensajes para almacenar el mapeo. - El mapeo de los parámetros {{n}} y el campo del botón de enlace. - Entrega: elige de qué bandeja de WhatsApp se consulta el catálogo de plantillas aprobadas. El envío sigue saliendo por la bandeja de la propia conversación. Las plantillas cuyo encabezado exige medios o una variable no se listan aquí — este envío no puede completar ese encabezado — y la pantalla indica cuántas quedaron fuera. Siguen disponibles desde la pestaña Plantillas de la propia bandeja, con enlace directo desde esta pantalla. Notas: WhatsApp Web (WazMeow) no tiene ventana de 24 h (el bloque ni aparece); 360dialog puede seleccionar una plantilla, pero no crearla; Meta empareja nombre + idioma + aprobada, así que una plantilla en el idioma equivocado se señala en pantalla y sería rechazada al enviar. Vista previa y envío de prueba La vista previa se renderiza en el servidor, por canal, y muestra solo los canales que la cuenta realmente tiene. También exhibe la plantilla resuelta para fuera de la ventana, con los valores que cargará cada parámetro. Enviar prueba manda el mensaje a la conversación elegida respetando la ventana de 24 h: con la ventana cerrada y sin plantilla configurada, la prueba se omite con el motivo escrito en pantalla. Variables de pago Además de contacto, cuenta, conversación, bandeja, agente, CRM y organización — que ahora se renderizan de verdad —, estos mensajes ofrecen los datos del propio cobro: | Variable | Se sustituye por | |---|---| | {{ payment.amount }} | Importe del cobro | | {{ payment.currency }} | Moneda | | {{ payment.description }} | Descripción del cobro | | {{ payment.status }} | Estado actual | | {{ payment.due_date }} | Fecha de vencimiento | | {{ payment.billing_type }} | Forma de cobro (PIX, boleto, tarjeta…) | | {{ payment.pay_url }} | Enlace de pago | | {{ payment.pix_payload }} | PIX copiar y pegar | | {{ payment.boleto_url }} | Enlace del boleto | | {{ payment.boleto_line }} | Línea digitable del boleto | | {{ payment.gateway }} | Pasarela usada | Casos de uso - Avisar a una persona de un cobro pendiente con un enlace y una orientación segura para completar el pago. Consejos, límites y buenas prácticas - Markdown por canal: los adjuntos se descartan en LINE/TikTok/X; el HTML sin procesar desaparece en el correo/widget; *negrita* en WhatsApp aparece como un par de asteriscos. - Configura la plantilla fuera de la ventana en el mismo idioma del cuerpo — son pares, no una configuración única. - Ofrece siempre una vía de pago en el texto: {{ payment.pay_url }}, {{ payment.pix_payload }} o {{ payment.boleto_line }}, según la forma de cobro. - Después de "Crear a partir de mi texto", la plantilla queda esperando aprobación en Meta — usa Sincronizar desde Meta para ver cuándo se aprueba y empieza a entregar. Solución de problemas - Salió como el predeterminado: el tipo estaba vacío (etiqueta Predeterminado) en ese idioma, o el idioma del contacto no tiene texto y el respaldo llegó al predeterminado incluido. - Fuera de la ventana no se envió: confirma la plantilla aprobada de ese tipo en ese idioma. - La plantilla aparece señalada: está en un idioma distinto del mensaje — cámbiala por una aprobada en el idioma correcto. - "Crear a partir de mi texto" está deshabilitado: el motivo aparece escrito al lado del botón — la bandeja no es WhatsApp Cloud (en 360dialog eliges una plantilla ya aprobada), la cuenta no tiene el WhatsApp Inbox Suite, tu perfil no gestiona bandejas de entrada, o no hay texto en ese tipo e idioma para generar la plantilla. - Creé la plantilla, pero no aparece / no se usa: justo tras el envío queda esperando aprobación — solo entrega cuando Meta la aprueba y usas Sincronizar desde Meta. Y confirma que hiciste clic en Guardar mensajes: crear la plantilla no guarda la configuración. - No encuentro una plantilla en la lista: las plantillas con encabezado de medios o con variable en el encabezado no se listan aquí; úsalas desde la pestaña Plantillas de la propia bandeja. - El envío de prueba se omitió: la conversación estaba fuera de la ventana de 24 h y el mensaje no tenía plantilla configurada — la pantalla informa el motivo. Ver también - Conectar pasarelas de pago (Asaas / Mercado Pago) - WhatsApp Inbox Suite: plantillas, flows y llamadas - Planes de cobro y talonario de pagos

Gestionar y conciliar cobros

Visión general El área de Cobros es donde haces seguimiento y administras todo lo que se ha cobrado. Tiene una lista paginada con búsqueda (búsqueda, período de creación, estado, gateway/conexión, ordenación y un interruptor para mostrar los archivados), acciones por fila en cada cobro (ver, editar, corregir cliente y vínculos, enviar a la conversación, reembolsar, marcar como pagado, cancelar, archivar, restaurar, eliminar) y una barra flotante de acciones en lote que aparece cuando seleccionas varios cobros a la vez. El objetivo es la conciliación: mantener el estado de cada cobro coherente con la realidad — reflejando lo que el gateway confirmó y también los pagos recibidos por fuera de la plataforma. Requisitos previos - El módulo Pagos habilitado y al menos un gateway conectado (consulta Conectar gateway). - Cobros ya creados (consulta Crear un cobro y enviarlo en la conversación). - Para eliminar definitivamente y para las acciones en lote financieras se necesita permiso de administrador. Paso a paso 1. Filtrar y abrir un cobro 1. Abre Pagos → Cobros. 2. Busca por descripción, id del gateway/referencia externa, nombre/correo del cliente o nombre de la conexión. Combina la búsqueda con estado, conexión y el período de creación en la zona horaria de la cuenta. 3. Ordena por creación, vencimiento, importe, estado o descripción; activa archivados para ver la papelera. Cada control activo aparece como una etiqueta removible y la URL conserva página, filtros y ordenación para volver o compartir la misma vista. 4. Haz clic en el cobro para abrir sus detalles. La acción principal respeta el artefacto disponible: página alojada, boleto o PIX para copiar y pegar; un cobro manual sigue siendo auditable aunque no tenga enlace. La dirección pasa a incluir el cobro abierto: puedes llegar desde un atajo de Pedido o Comisión, recargar o compartir el detalle y conservar los filtros anteriores al cerrarlo. 5. Usa Exportar CSV para descargar todo el recorte filtrado, no solo la página visible. Si hay cobros seleccionados, el archivo contiene únicamente esa selección. En pantallas pequeñas, los controles pasan al panel Filtros y cada cobro se convierte en una tarjeta legible. 2. Ver la línea de tiempo de estado (auditoría) 1. En los detalles del cobro, abre la pestaña de línea de tiempo. 2. Cada evento (creado, pagado, reembolsado, cancelado, actualizado) se registra de forma inmutable, con el agente responsable, la hora y la justificación introducida — es el historial financiero auditable del cobro. 3. Corregir cliente y vínculos sin editar los hechos financieros 1. Desde la fila o los detalles, usa Corregir el cliente y los vínculos de la venta cuando falte el contacto o sea incorrecto, incluso en un cobro pagado cuyos campos financieros ya no se pueden editar. 2. Elige un contacto existente o propón uno nuevo con nombre y al menos correo, teléfono o documento. Revisa también el pedido, la recuperación, la organización, el negocio y la conversación alcanzados. 3. Genera la vista previa y comprueba conflictos, historial y cualquier impacto en vendedor/afiliado. Los cambios de crédito o comisión exigen confirmación explícita. La aplicación es transaccional y auditada. 4. Esta acción nunca cambia importe, estado, liquidación, vencimiento ni ID de pasarela. Para esos hechos, usa la operación financiera correspondiente o corrige el origen. 4. Marcar como pagado manualmente (y deshacer) 1. Para un pago recibido por fuera (efectivo, PIX directo a la cuenta), usa Marcar como pagado. 2. Introduce la justificación (obligatoria) — queda guardada en el evento de auditoría. 3. El cobro pasa a pagado. Disponible solo para cobros que siguen abiertos (pendiente, en espera de pago o vencido) y en gateways que admiten la liquidación manual. 4. Para revertirlo, usa Deshacer liquidación manual — solo funciona en un cobro que tú mismo liquidaste manualmente; vuelve a pendiente/vencido. La justificación también es obligatoria. 5. Cuando el registro de pedidos está habilitado, el cobro actualiza automáticamente su pedido vinculado. Un pedido procedente del gateway conserva el historial y debe gestionarse desde el cobro de origen. En pagos con tarjeta, el cobro puede seguir confirmado mientras el pedido ya figura como pagado: el cliente completó el pago y el saldo todavía no está disponible en el gateway. 5. Cancelar (abierto) vs reembolsar (pagado) 1. Usa Cancelar cobro mientras el cobro siga abierto (sin pagar): el cliente ya no podrá pagarlo. 2. Usa Reembolsar cuando el cobro ya esté pagado: elige total (devuelve todo) o parcial (introduce el importe). Puedes reembolsar parcialmente más de una vez, hasta el total. 3. El reembolso parcial mantiene en el pedido y los informes solo el ingreso neto restante; el total revierte todo el ingreso. En ambos casos puedes registrar un motivo, que queda en la auditoría. 6. Reenviar en la conversación 1. Usa Enviar a la conversación e indica la conversación de destino. 2. La tarjeta de pago vuelve a aparecer para el cliente en la propia ventana de la conversación. 7. Archivar → restaurar → eliminar definitivamente 1. Archivar quita el cobro de la lista predeterminada sin borrarlo (va a la papelera de archivados). 2. Restaurar devuelve el cobro archivado a la lista activa. 3. Eliminar definitivamente lo borra del todo — solo se permite en cobros archivados y no liquidados; los cobros pagados/reembolsados se conservan para auditoría y nunca pueden borrarse. 8. Acciones en lote 1. Selecciona varios cobros; aparece la barra flotante con el recuento. 2. En la lista activa (admin): marcar como pagado, cancelar y reembolsar (solo total), además de archivar. 3. En la lista de archivados: restaurar y eliminar definitivamente (admin). 4. Todas las acciones en lote son best-effort: el resultado indica cuántos se procesaron y lista los ids que fallaron. Solo los fallos permanecen seleccionados para revisar o reintentar; ningún elemento solicitado desaparece silenciosamente del resultado. Configuración y opciones Planes de cobro y talonario de pagos Un plan de cobro reúne las cuotas de una sola venta. El total contratado y el importe recibido son distintos: pagar una cuota no liquida todo el plan. Cada cuota mantiene su vencimiento, pago e historial. - Acción por fila vs en lote: la misma operación existe individualmente en cada cobro y en lote sobre la selección. - Permisos: eliminar definitivamente y las acciones financieras en lote (marcar como pagado, reembolsar, cancelar) y la eliminación en lote están restringidas a administradores. - Reembolso en lote = solo total: el reembolso parcial existe únicamente como acción por fila. - Eliminar exige archivar antes: la eliminación permanente es siempre una acción deliberada en dos pasos (archivar y solo entonces eliminar). - Exportación: respeta búsqueda, período, filtros y selección actual; los textos se protegen para que la hoja de cálculo no los interprete como fórmulas. - Editar vs corregir vínculos: editar sigue sujeto al estado y a las reglas de la pasarela. Corregir vínculos es una operación separada que actúa solo en asociaciones, incluso para cobros liquidados. Agendamiento local y estado del talonario El agendamiento local es una capacidad de la fundación disponible solo en el laboratorio con procesador ficticio en esta entrega. No está habilitado para Asaas ni Mercado Pago. Su calendario separa cuotas previstas y emitidas: solo una cuota con identificador confirmado se convierte en cobro. El talonario incluye los instrumentos existentes e identifica las cuotas previstas. El documento puede estar pendiente, listo, fallido (permite reintentar) o no disponible para la conexión. Un fallo no significa ingreso ni debe provocar un cobro duplicado. La página pública muestra los instrumentos de un cobro disponible; el estado puede demorarse hasta la próxima actualización de la plataforma. Casos de uso - Conciliar un PIX pagado por fuera: marca el cobro como pagado con la justificación, manteniendo el historial coherente. - Limpiar cobros de prueba: archívalos en lote y, después, elimina definitivamente los archivados. - Reembolsar en masa: selecciona los cobros pagados y reembólsalos en lote (total). Consejos, límites y buenas prácticas - Cancelar solo vale para cobros abiertos; para un cobro pagado, el camino es el reembolso. - Las cuotas se definen al crear el cobro. En un cobro ya emitido puedes cambiar el medio de pago, el vencimiento, el importe mediante el descuento, la descripción y las condiciones de pago; no puedes cambiar entre pago único y cuotas, ni el número de cuotas. Es un límite de los gateways: la actualización de cobro de Asaas no acepta la cantidad de cuotas y no existe un endpoint para modificar un plan ya creado, y Mercado Pago no edita cobros. Para cambiar las cuotas, cancélalo y crea otro. - En una cuota de un plan, la edición cambia solo la multa, los intereses y el descuento por pago anticipado, y se aplica a las cuotas abiertas del plan. - El reembolso depende del gateway — el tipo (total/parcial) y el plazo de devolución siguen las reglas del proveedor y del medio de pago. - El webhook sigue siendo la fuente de la verdad: la liquidación manual es para lo que se pagó por fuera; los pagos del propio gateway llegan y actualizan el estado solos. - Deshacer liquidación manual solo funciona sobre lo que tú liquidaste manualmente — no es la vía para revertir un pago real del gateway (para eso, usa el reembolso). - Si el importe es correcto pero el cliente, pedido o evento de recuperación está mal, usa Corregir cliente y vínculos; no canceles ni reembolses solo para arreglar una asociación. Solución de problemas - "No puedo eliminar": el cobro debe estar archivado primero; y los cobros pagados/ reembolsados nunca se eliminan (se conservan para auditoría). Archívalo en lugar de intentar borrarlo. - "Deshacer no disponible": una liquidación manual solo puede deshacerse por la misma vía — solo un cobro que tú marcaste como pagado manualmente (en un gateway compatible) puede revertirse. - "Marcar como pagado no disponible": el cobro no está abierto, o el gateway no admite la liquidación manual. - "Editar no está disponible en un cobro pagado": los hechos liquidados son inmutables. Para cambiar solo cliente, organización, negocio o conversación, usa Corregir el cliente y los vínculos de la venta. - Una acción en lote omitió cobros: es el comportamiento esperado — los no elegibles (estado incompatible o un gateway sin la función), ids ausentes y elementos fuera de la vista permitida aparecen como no procesados y permanecen seleccionados para revisión. - La lista no cargó: usa Intentar de nuevo; si continúa, revisa la conexión con el servidor. - El atajo abrió la lista pero no el detalle: confirma que el cobro pertenece a la misma cuenta y que tu perfil puede consultarlo. El parámetro de la dirección nunca amplía permisos. Ver también - Visión general de Pagos - Crear un cobro y enviarlo en la conversación - Reembolsos, webhooks e informes - Conectar gateway: Asaas y Mercado Pago - Planes de cobro y talonario de pagos - Página pública de cobro

Ofertas: order bump, upsell y downsell

Visión general Una oferta es un precio reutilizable que registras una vez y reaprovechas en varias ventas. Hay tres tipos: - Order bump: aparece en el checkout como un complemento rápido y, al aceptarse, entra como una línea extra en el cobro que se está creando. - Upsell: oferta de un clic tras la compra, normalmente un artículo de mayor valor, que genera un nuevo cobro para el contacto. - Downsell: también de un clic tras la compra, usada como alternativa más barata cuando el cliente rechaza el upsell — igualmente genera un nuevo cobro. En todos los casos la oferta guarda nombre, importe, moneda y método; solo la vinculas a una venta o a un contacto en el momento adecuado. Requisitos previos - Una pasarela conectada y válida (consulta Conectar pasarela). - Opcional: un producto del Catálogo vinculado a la oferta (catalog_product_id), para reaprovechar el registro del producto. - Define en la oferta la conexión (pasarela) y el método (billing_type) que se usarán cuando se convierta en cobro — sobre todo para upsell y downsell. - Para aceptar una oferta (upsell/downsell), el contacto necesita datos mínimos (nombre y, idealmente, correo/teléfono) para el pagador en la pasarela. Cómo funciona - Order bump en el checkout: la oferta se convierte en una línea de cobro (nombre, importe y moneda quedan "fotografiados" en ese momento). Suma al total agregando una nueva línea — nunca altera el importe de un cobro ya existente. La línea solo guarda la referencia de la oferta en sus metadatos. - Upsell / downsell tras la compra: al aceptar la oferta para un contacto, la plataforma crea un nuevo cobro reaprovechando la conexión, el importe y los datos del pagador ya conocidos — sin reescribir nada. Ese cobro sigue el flujo normal (pasarela → webhook → tarjeta de pago en la conversación), igual que cualquier otro cobro. - La oferta nunca se modifica al aceptarse: es una plantilla; cada aceptación crea un cobro nuevo e independiente. - La aceptación poscompra solo funciona para una oferta activa y no archivada. Un order bump pertenece al checkout y esta acción lo rechaza. Repetir el mismo intento de red recupera el mismo cobro. Paso a paso 1. En el área de Pagos, abre Ofertas y crea una nueva oferta. 2. Indica el nombre, elige el tipo (order bump, upsell o downsell), el importe y la moneda. 3. Define el método y la conexión (pasarela) que se usarán al generar el cobro. 4. (Opcional) Vincula un producto del catálogo y escribe una descripción. 5. Guarda. La oferta está disponible mientras esté activa. 6. Para aplicar un order bump, usa la oferta en el checkout: si el cliente la acepta, se convierte en una línea extra del cobro. 7. Para aceptar un upsell/downsell, una integración autorizada llama a la API de aceptación para el contacto, con empresa y conversación explícitas cuando corresponda. La operación genera un nuevo cobro; crear la oferta en el catálogo no ejecuta esa aceptación. 8. Para retirar una oferta, archívala — desaparece de las ofertas disponibles, pero el precio se conserva (nunca borramos un precio que un embudo activo pueda referenciar). Configuración y opciones Catálogo, aceptación y pagador son decisiones distintas Crear o guardar una oferta solo registra una opción en el catálogo; no crea un cobro ni inicia una suscripción. La pantalla de Ofertas administra ese catálogo. Esta versión no tiene un botón de aceptación poscompra en esa pantalla. Una integración autorizada puede aceptar un upsell/downsell mediante la API. La aceptación requiere el contacto responsable y puede indicar organization_id explícitamente para cobrar a una empresa vinculada a ese contacto; conversation_id conserva el contexto de la conversación cuando se indica. El registro fiscal de la empresa debe cumplir los requisitos de la pasarela y el método elegidos. Sin una elección explícita de empresa, no deduzcas el pagador del producto o negocio. El intento debe conservar su clave de idempotencia; aceptar es una operación financiera, no una consulta al catálogo. Un order bump es solo una línea adicional en el checkout que se está componiendo. Guardar la oferta o añadir esa línea no emite un cobro por sí solo. El endpoint de aceptación poscompra rechaza order bump; no lo uses para iniciar un cobro implícito. Emitir el cobro y cualquier envío en la conversación siguen siendo acciones propias del flujo de cobro. Campos de una oferta: | Campo | Para qué sirve | |---|---| | Nombre | Identifica la oferta y se convierte en la descripción del cobro/línea. Obligatorio. | | Tipo (kind) | order_bump, upsell o downsell. | | Importe | Precio de la oferta (unidades mayores, p. ej. 49.90). Debe ser mayor que cero. | | Moneda | Código de 3 letras (p. ej. BRL). | | Método (billing_type) | PIX, boleto o tarjeta usado cuando la oferta se convierta en cobro. | | Conexión | La pasarela (conexión de pago) usada para cobrar. | | Producto del catálogo | Vínculo opcional a un producto del Catálogo. | | Descripción | Texto auxiliar de la oferta. | | Activa / inactiva | Las ofertas inactivas no se presentan. | Casos de uso - Aumentar el ticket con un order bump en el checkout ("agrega la garantía extendida por $19,90"). - Ofrecer un upsell justo después de la compra ("lleva la versión Pro con un clic"). - Recuperar la venta con un downsell cuando el cliente rechaza el upsell más caro. - Reutilizar la misma oferta en varias conversaciones y checkouts, sin volver a crear el precio. Consejos, límites y buenas prácticas - El order bump no altera un cobro ya creado — solo agrega una línea al total en el momento del checkout. - Aceptar un upsell/downsell siempre crea un cobro nuevo e independiente; la oferta original permanece intacta. - Las ofertas se archivan, no se borran — así no se rompe ningún embudo o historial que dependa de ese precio. - Define conexión y método en la oferta de upsell/downsell: sin ellos, la aceptación no puede generar el cobro correctamente. - Los importes están en unidades mayores ($49,90 = 49.90); el total del checkout es la suma de las líneas — nunca dividas por 100. Solución de problemas - La oferta no aparece: comprueba que esté activa y no archivada (las ofertas inactivas o archivadas no se presentan). - La aceptación falló: verifica que el contacto tenga los datos mínimos y que la conexión (pasarela) de la oferta sea válida — la aceptación crea un cobro real y necesita esos datos. - El importe del order bump salió mal: recuerda que agrega una línea al total; no reemplaza ni reduce las demás líneas. - No puedo eliminar una oferta: las ofertas se archivan (reversible), no se eliminan — usa archivar. Ver también - Crear un cobro y enviarlo en la conversación - Conectar pasarela: Asaas y Mercado Pago - Catálogo nativo de productos y servicios