Cómo conectar Quaza a la API de Juno para cobrar con boleto, Pix y tarjeta y validar la integración — lo que llamamos homologar.
Qué es el gateway Juno
El gateway Juno conecta Quaza directamente a la API de Juno. Con él, las cobranzas se generan por internet y el pago vuelve confirmado automáticamente.
Homologar es validar tus credenciales con Juno: las informás, hacés clic en Probar gateway y Quaza confirma la conexión.
Cómo funciona la homologación
Configurás las credenciales, Quaza pide autorización a Juno y, si son correctas, la integración queda conectada:
Glosario
| Término |
Qué significa |
| Gateway |
Integración vía API: la cobranza y la baja del pago ocurren en tiempo real, por internet. |
| Homologar |
Validar tus credenciales con Juno. En Quaza, es el botón Probar gateway. |
| Ambiente |
Homologación = ambiente de pruebas; Producción = valiendo de verdad. |
| Clave Principal |
el Client ID de tu cuenta en Juno |
| Clave Secreta |
el Client Secret de tu cuenta en Juno |
| Token Privado |
el Private Token (clave privada) de tu integración Juno |
| Tarea "Financiero - Gateway" |
Rutina automática que sincroniza los pagos de las cobranzas del gateway. |
Antes de empezar
Vas a necesitar:• Una cuenta en Juno con la API de cobranza/integración habilitada.
• Las credenciales de API: Clave Principal, Clave Secreta, Token Privado.
Paso a paso
Abrí la configuración para cobranza y andá a la pestaña Gateway:
Configuración para cobranza → pestaña Gateway
1 Em Integración con gateway, seleccioná Gateway - Juno.
2 Em Ambiente, elegí Homologación para probar ou Producción.
3 Em Clave Principal, pegá el Client ID de tu cuenta en Juno.
4 Em Clave Secreta, pegá el Client Secret de tu cuenta en Juno.
5 Em Token Privado, pegá el Private Token (clave privada) de tu integración Juno.
Guardá y hacé clic en Probar gateway.
Pestaña Gateway: (1) Integración con gateway, (2) Ambiente, (3) Clave Principal, (4) Clave Secreta, (5) Token Privado y el botón Probar gateway.
El botón "Probar gateway"
El botón Probar gateway pide una autorización a Juno usando las credenciales informadas. Si son correctas, aparece Conectado con éxito — la integración está homologada.
¿Dio error al probar? Verificá las credenciales (sin espacios de más) y el Ambiente seleccionado. Las credenciales de Homologación no funcionan en Producción y viceversa.
Tareas automáticas
Una vez homologado, no necesitás dar de baja el pago manualmente — Quaza lo hace con tareas que corren solas:
| Tarea |
Qué hace |
| Financiero - Gateway |
Sincroniza el estado de pago de las cobranzas del gateway, dentro de la ventana de días configurada (campos "Verificación de cobros"). Es la tarea principal de la integración. |
| Financiero - Gateway (aviso) |
Genera los avisos y notificaciones relacionados a las cobranzas del gateway. |
Manual o automático. La baja ocurre sola por la tarea; también podés forzar la reverificación abriendo la cobranza en la pantalla cuando necesités una confirmación inmediata.
Errores frecuentes
1. Homologación no es Producción. Las credenciales de prueba solo valen en el ambiente de Homologación. Cambiá a las de Producción al entrar en operación.
2. Son 3 credenciales. Juno exige todas completas — si falta una, la prueba falla.
3. Credenciales exactas. Pegá cada valor exactamente como Juno lo entregó, sin espacios al inicio o al final.
Preguntas frecuentes
¿Quién puede configurar la homologación?El operador del área financiera con acceso a la Configuración para cobranza. Como involucra credenciales, suele hacerlo quien administra la cobranza de la empresa.
¿Dónde consigo las credenciales?Las provee Juno — las obtenés en el panel/portal de integración de Juno. Quaza no genera esas credenciales.
¿El pago se da de baja solo?Sí. La tarea Financiero - Gateway sincroniza los pagos automáticamente, dentro de la ventana de días configurada.
¿Puedo probar antes de poner en producción?Sí. Seleccioná el ambiente Homologación, validá la conexión y recién después cambiá a Producción.
"Probar gateway" dio error. ¿Qué hago?Verificá las credenciales y el ambiente. Corregí, guardá y probá de nuevo.
¿Necesito importar archivo de retorno?No. En el gateway el pago vuelve confirmado automáticamente.
Cambié las credenciales. ¿Debo probar de nuevo?Sí. Cada vez que cambiés una credencial o el ambiente, guardá y hacé clic en Probar gateway.
¿En cuánto tiempo aparece el pago como pagado?En la próxima ejecución de la tarea de sincronización, siempre que el vencimiento esté dentro de la ventana "Verificación de cobros (Días anteriores/posteriores)".
¿Para qué sirven los campos "Verificación de cobros"?Definen la ventana de días (anterior y posterior al vencimiento) que la tarea revisa al buscar pagos. El valor por defecto suele ser 60 y 60.
¿Y la clave Pix de Juno?Para recibir por Pix, informá también la clave Pix receptora en el campo Clave PIX de la pestaña Gateway.
Documentos relacionados