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
- Abre Nuevo cobro en Pagos o en una conversación y selecciona cliente, conexión y método.
- Elige cuotas, informa el total, la cantidad, el primer vencimiento y el ciclo disponible.
- Revisa el resumen y las condiciones antes de crear.
- Abre el plan para seguir las cuotas emitidas y el progreso.
- Usa Descargar libreta para obtener el PDF y Enviar libreta en la conversación para entregarlo al cliente; comprueba el destinatario antes de enviar.
- 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.