Central de Ajuda Quaza Provedores

Homologación Santander (Gateway) (ES-PY)

Homologación Santander (Gateway) — Quaza

Cómo conectar Quaza a la API de Santander para cobrar con boleto bancario y validar la integración — lo que llamamos homologar.

En esta wiki:

Qué es el gateway Santander

El gateway Santander conecta Quaza directamente a la API de Santander. Con él, las cobranzas se generan por internet y el pago vuelve confirmado automáticamente.

Homologar es validar tus credenciales con Santander: las informás, hacés clic en Probar gateway y Quaza confirma la conexión.

El gateway no es lo mismo que Remesa/Retorno. En el gateway todo ocurre por internet, en tiempo real, sin archivos. Mirá la diferencia en Diferencia entre Gateway (API) y Remesa/Retorno .

Cómo funciona la homologación

Configurás las credenciales, Quaza pide autorización a Santander 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 Santander. 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 Santander
Clave Secreta	el Client Secret de tu cuenta en Santander
Token Privado	la contraseña del certificado digital
Certificado	Archivo digital exigido por Santander 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 Santander con la API de cobranza/integración habilitada.
• Las credenciales de API: Clave Principal, Clave Secreta, Token Privado.
• Para el ambiente de Producción: el certificado digital provisto por Santander.

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 - Santander.

2 Em Ambiente, elegí Homologación para probar ou Producción.

3 Em Clave Principal, pegá el Client ID de tu cuenta en Santander.

4 Em Clave Secreta, pegá el Client Secret de tu cuenta en Santander.

5 Em Token Privado, pegá la contraseña del certificado digital.

Guardá y hacé clic en Probar gateway.

Pestaña Gateway con Santander seleccionado

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.

En Producción, importá el certificado. Antes de probar, usá el botón Importar certificado para enviar el certificado digital de Santander. 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 Santander 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 3 credenciales. Santander 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 Santander 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 Santander — con tu gerente de cuenta o en el portal de desarrolladores de Santander. 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.

¿Cuál es la diferencia con Remesa/Retorno?

El gateway es vía API, en tiempo real; la remesa/retorno intercambia archivos. Mirá Diferencia entre Gateway (API) y Remesa/Retorno .

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.