Pagos
Por Conversa Labs
Por Conversa Labs
Conectar pasarela (Asaas/Mercado Pago), crear cobros (PIX/boleto/tarjeta), suscripciones, descuentos, agendamiento pago e informes.
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 - 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. 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
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 - 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. - Métodos admitidos por pasarela: | Capacidad | Asaas | Mercado Pago | |---|---|---| | PIX | Sí | Sí | | Boleto | Sí | Sí | | Tarjeta (checkout alojado) | Sí | Sí | | Cuotas | Sí | Sí | | Suscripciones | Sí | Sí | | Planes reutilizables | — | Sí | | Reembolso parcial | Sí | Sí | 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. Ver también - Visión general de Pagos - Crear un cobro y enviarlo en la conversación - Reembolsos, webhooks e informes
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. 8. Observa el estado pasar de pendiente a pagado automáticamente cuando la pasarela confirme. Configuración y opciones - 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. - 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. 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 - 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. 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. 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
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. En Mercado Pago también puedes usar planes reutilizables (una plantilla de suscripción que sirve a varios clientes). En Asaas, la recurrencia se configura directamente en la suscripción. Requisitos previos - Una pasarela conectada que admita suscripciones (Asaas y Mercado Pago las admiten). - Para planes reutilizables, usa Mercado Pago (Asaas no expone planes como entidad separada). - 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, Mercado Pago) Vincúlala a un plan ya creado. 6. Guarda. La pasarela empieza a generar los cobros en el ciclo definido. 7. Sigue cada cobro generado y el estado de la suscripción en la plataforma; el cliente recibe el cobro normalmente. Configuración y opciones - Ciclo: semanal, quincenal, mensual, trimestral, semestral o anual (la oferta exacta depende de la pasarela). - Estado de la suscripción: activa, pausada, cancelada — reflejado desde las notificaciones de la pasarela. - Planes (Mercado Pago): crea un plan una vez y reutilízalo en varias suscripciones. - 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. 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 - La recurrencia se delega a la pasarela — ella genera y cobra cada ciclo; la plataforma refleja el resultado. - Usa planes (Mercado Pago) cuando muchos clientes se suscriben a la misma oferta — es más fácil de mantener. - 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: los planes reutilizables son una función de Mercado Pago; en Asaas configura la recurrencia en la propia suscripció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
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 - 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. 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
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 - 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