Central de Ajuda Quaza Provedores

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

Homologación Asaas (Gateway) — Quaza

Cómo conectar Quaza a la API de Asaas y validar la integración — lo que llamamos homologar.

En esta wiki:

Qué es el gateway Asaas

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

Homologar es validar tu credencial (la Clave de API) con Asaas: informás la clave, 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. Mirá la diferencia en Diferencia entre Gateway (API) y Remesa/Retorno .

Cómo funciona la homologación

Informás la Clave de API, Quaza pide autorización a Asaas y, si la clave es correcta, 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 tu credencial con Asaas. En Quaza, es el botón Probar gateway.
Ambiente	Homologación = ambiente de pruebas (Sandbox) de Asaas; Producción = valiendo de verdad.
Clave de API	La credencial de acceso que Asaas genera para tu cuenta. Es el único campo que usa el gateway Asaas (va en la Clave Principal).
Tarea "Financiero - Gateway"	Rutina automática que sincroniza los pagos de las cobranzas del gateway.

Antes de empezar

Vas a necesitar:

• Una cuenta en Asaas (de Sandbox para pruebas o de Producción).
• La Clave de API generada en el panel de Asaas.

Paso a paso

Abrí la configuración para cobranza y andá a la pestaña Gateway:

Configuración para cobranza → pestaña Gateway

1 En Integración con gateway, seleccioná Gateway - Asaas.

2 En Ambiente, elegí Homologación (Sandbox) para probar o Producción.

3 En Clave Principal, pegá la Clave de API de Asaas.

Guardá y hacé clic en Probar gateway.

Pestaña Gateway: (1) Integración con gateway = Gateway - Asaas, (2) Ambiente, (3) Clave Principal (Clave de API) y el botón Probar gateway.

El botón "Probar gateway"

El botón Probar gateway pide una autorización a Asaas usando tu Clave de API. Si la clave es correcta, aparece Conectado con éxito — la integración está homologada.

¿Dio error al probar? Verificá la Clave de API (sin espacios) y el Ambiente. La clave de Sandbox no funciona 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.

Errores frecuentes

1. Sandbox no es Producción. La Clave de API de Sandbox de Asaas solo funciona en el ambiente de pruebas. Generá y usá la clave de Producción al entrar en operación.

2. Es una sola clave. Asaas usa únicamente la Clave de API (Clave Principal). Dejá los demás campos en blanco.

3. Clave exacta. Pegá la Clave de API exactamente como Asaas la generó, sin espacios al inicio o al final.

4. Guardá la clave con cuidado. La Clave de API da acceso a tu cuenta Asaas — tratala como una contraseña.

Preguntas frecuentes

¿Quién puede configurar la homologación?

El operador del área financiera con acceso a la Configuración para cobranza.

¿Dónde consigo la Clave de API?

En el panel de Asaas, en Configuraciones / Integraciones. Quaza no genera esa clave.

¿Necesito completar Clave Secreta o Token?

No. Asaas usa únicamente la Clave de API, en el campo Clave Principal.

¿El pago se da de baja solo?

Sí. La tarea Financiero - Gateway sincroniza los pagos automáticamente.

¿Puedo probar antes de poner en producción?

Sí. Usá el ambiente Homologación (Sandbox) con la clave de prueba de Asaas.

"Probar gateway" dio error. ¿Qué hago?

Verificá la Clave de API y el ambiente. 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é la clave. ¿Debo probar de nuevo?

Sí. Cada vez que cambiés la Clave de API o el ambiente, guardá y hacé clic en Probar gateway.

¿La clave de Sandbox sirve en Producción?

No. Son claves diferentes; generá la de Producción al ir al aire.