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
- 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. Deja multa e interés vacíos para
conservar los valores predeterminados de la cuenta; introduce
0para desactivarlos explícitamente en ese cobro. - 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: 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.
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.