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
- En una conversación, abre la acción de crear cobro (o créalo desde el área de Pagos).
- 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.
- Selecciona el método de pago: PIX, boleto o tarjeta (checkout alojado).
- (Opcional) Aplica un descuento o ajusta el valor — consulta Descuentos y ajuste de valor.
- Define el vencimiento, cuando aplique.
- 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.
- 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.
- Observa el estado pasar de pendiente a pagado automáticamente cuando la pasarela confirme.
Configuración y opciones
Cobrar a una empresa
- Elige el contacto responsable. En una conversación, este contacto conserva el contexto de atención.
- 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.
- 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.
- 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.