Cómo conectar Quaza a la API de Sicoob para cobrar con boleto bancario y validar la integración — lo que llamamos homologar.
Qué es el gateway Sicoob
El gateway Sicoob conecta Quaza directamente a la API de Sicoob. Con él, las cobranzas se generan por internet y el pago vuelve confirmado automáticamente.
Homologar es validar tus credenciales con Sicoob: 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 Sicoob 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 Sicoob. 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 Sicoob |
| Clave Secreta |
el Client Secret de tu cuenta en Sicoob |
| Certificado |
Archivo digital exigido por Sicoob en Producción, enviado por el botón Importar certificado. |
| Tarea "Financiero - Gateway" |
Rutina automática que sincroniza los pagos de las cobranzas del gateway. |
Antes de empezar
Vas a necesitar:• Una cuenta en Sicoob con la API de cobranza/integración habilitada.
• Las credenciales de API: Clave Principal, Clave Secreta.
• Para el ambiente de Producción: el certificado digital provisto por Sicoob.
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 - Sicoob.
2 Em Ambiente, elegí Homologación para probar ou Producción.
3 Em Clave Principal, pegá el Client ID de tu cuenta en Sicoob.
4 Em Clave Secreta, pegá el Client Secret de tu cuenta en Sicoob.
Guardá y hacé clic en Probar gateway.
Pestaña Gateway: (1) Integración con gateway, (2) Ambiente, (3) Clave Principal, (4) Clave Secreta y el botón Probar gateway.
En Producción, importá el certificado. Antes de probar, usá el botón Importar certificado para enviar el certificado digital de Sicoob. Sin él, la conexión en Producción falla. En Homologación normalmente no se exige.
El botón "Probar gateway"
El botón Probar gateway pide una autorización a Sicoob usando las credenciales informadas. Si son correctas (y, en Producción, con el certificado importado), 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. En Producción, verificá también el certificado importado y la contraseña. 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 2 credenciales. Sicoob exige todas completas — si falta una, la prueba falla.
3. Producción exige certificado. Importá el certificado digital por el botón Importar certificado; en Homologación normalmente no hace falta.
4. Credenciales exactas. Pegá cada valor exactamente como Sicoob 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 Sicoob — con tu gerente de cuenta o en el portal de desarrolladores de Sicoob. 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, y — en Producción — el certificado importado. 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, el certificado 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.
Documentos relacionados