Cómo conectar Quaza a la API de Safe2Pay para cobrar con boleto, Pix y tarjeta y validar la integración — lo que llamamos homologar.
Qué es el gateway Safe2Pay
El gateway Safe2Pay conecta Quaza directamente a la API de Safe2Pay. Con él, las cobranzas se generan por internet y el pago vuelve confirmado automáticamente.
Homologar es validar tus credenciales con Safe2Pay: 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 Safe2Pay 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 Safe2Pay. En Quaza, es el botón Probar gateway. |
| Ambiente |
Homologación = ambiente de pruebas; Producción = valiendo de verdad. |
| Clave Principal |
el Token de API de Safe2Pay |
| Tarea "Financiero - Gateway" |
Rutina automática que sincroniza los pagos de las cobranzas del gateway. |
Antes de empezar
Vas a necesitar:• Una cuenta en Safe2Pay con la API de cobranza/integración habilitada.
• Las credenciales de API: Clave Principal.
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 - Safe2Pay Transacción Simple.
2 Em Ambiente, elegí Homologación para probar ou Producción.
3 Em Clave Principal, pegá el Token de API de Safe2Pay.
Guardá y hacé clic en Probar gateway.
Pestaña Gateway: (1) Integración con gateway, (2) Ambiente, (3) Clave Principal y el botón Probar gateway.
El botón "Probar gateway"
El botón Probar gateway pide una autorización a Safe2Pay 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. Es una sola credencial. Safe2Pay usa únicamente la Clave Principal; dejá los demás campos en blanco.
3. Credenciales exactas. Pegá cada valor exactamente como Safe2Pay 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 Safe2Pay — las obtenés en el panel/portal de integración de Safe2Pay. 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.
Documentos relacionados