Integración de Hubsoft con Iugu

Acerca de iugu

iugu es una plataforma de infraestructura financiera para empresas, con tecnología para cobranza, gestión de cobros y operaciones financieras mediante API. Para el proveedor, funciona como gateway de cobranza: el boleto bancario se emite en iugu desde Hubsoft, sin archivo de remesa.

Qué hace la integración

• Emisión de boletos bancarios: Hubsoft registra los boletos bancarios en iugu.
• Boleto bancario con Pix: con la opción activa, cada boleto bancario incluye un código QR de Pix con los mismos datos.
• Cancelación: los boletos bancarios cancelados en Hubsoft se cancelan en iugu.
• Baja automática: iugu notifica a Hubsoft mediante webhook cuando se paga el boleto bancario, y la rutina de verificación de cobranza del gateway comprueba los pagos.

Qué necesita

• Una cuenta en iugu.
• Un token de producción, creado en el panel de iugu en Configuraciones > Desarrollador > Integraciones vía API.
• La recepción mediante Pix activa en el panel de iugu, para el boleto bancario con Pix.
• Un correo electrónico predeterminado para clientes sin correo registrado, porque iugu exige un correo electrónico para registrar el boleto bancario.
• El Módulo Financiero de Hubsoft, incluido en la licencia.

Cómo activar

1. En el panel de iugu, cree el token de producción y copie el valor. Permanecerá visible durante una hora.
2. En Hubsoft, en Configuración > Integraciones > Pago, agregue iugu con el token y el correo electrónico predeterminado.
3. Copie la URL de callback generada por Hubsoft.
4. En el panel de iugu, en Configuraciones > Desarrollador > Comunicación mediante gatillos, registre la URL y seleccione el evento indicado en la wiki.
5. Cree el método de cobranza en Configuración > Finanzas > Método de cobranza, con el banco Iugu y la integración registrada.
6. Registre la rutina Verifica Cobrança Gateway para que ningún pago quede sin baja.

Las instrucciones paso a paso con las pantallas están en la página de iugu en la wiki de Hubsoft.

Limitaciones

• La integración con iugu no modifica la fecha de vencimiento del boleto bancario en la plataforma.
• El token solo se puede copiar durante una hora después de crearlo. Si lo pierde, genere otro.

Preguntas frecuentes

No apareció el boleto bancario con Pix. ¿Qué debo verificar?

Compruebe que la recepción mediante Pix esté activa en el panel de iugu y que la opción de boleto bancario con Pix esté habilitada en la integración.

¿Necesito el webhook si tengo la rutina de verificación?

Sí. El webhook realiza la baja poco después del pago, y la rutina garantiza que ningún boleto bancario quede sin baja si alguna notificación falla.

¿Un cliente sin correo electrónico puede recibir un boleto bancario de iugu?

Sí. Hubsoft utiliza el correo electrónico predeterminado informado en la integración cuando el cliente no tiene correo electrónico.

Revisado el 10/10/2026.