Cómo conectar Quaza a la API de Mercado Pago y validar la integración — lo que llamamos homologar.
Qué es el gateway Mercado Pago
El gateway Mercado Pago conecta Quaza directamente a la API de Mercado Pago. Con él, las cobranzas se generan por internet y el pago vuelve confirmado automáticamente.
Homologar es validar tus credenciales (Client ID y Client Secret) con Mercado Pago: informás las dos, 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 Mercado Pago 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 Mercado Pago. En Quaza, es el botón Probar gateway. |
| Ambiente |
Homologación = ambiente de pruebas; Producción = valiendo de verdad. |
| Client ID |
El identificador de tu aplicación en Mercado Pago. Va en el campo Clave Principal. |
| Client Secret |
La clave secreta de tu aplicación en Mercado Pago. Va en el campo Clave Secreta. |
| Tarea "Financiero - Gateway" |
Rutina automática que sincroniza los pagos de las cobranzas del gateway. |
Antes de empezar
Vas a necesitar:• Una cuenta en Mercado Pago con una aplicación creada en el panel de desarrolladores.
• El Client ID y el Client Secret de esa aplicación.
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 - Mercado Pago.
2 En Ambiente, elegí Homologación para probar o Producción.
3 En Clave Principal, pegá el Client ID.
4 En Clave Secreta, pegá el Client Secret.
Guardá y hacé clic en Probar gateway.
Pestaña Gateway: (1) Integración con gateway = Gateway - Mercado Pago, (2) Ambiente, (3) Clave Principal (Client ID), (4) Clave Secreta (Client Secret) y el botón Probar gateway.
El botón "Probar gateway"
El botón Probar gateway pide una autorización a Mercado Pago usando el Client ID y el Client Secret. Si las credenciales son correctas, aparece Conectado con éxito — la integración está homologada.
¿Dio error al probar? Verificá el Client ID y el Client Secret (copiados de tu aplicación en Mercado Pago) y el Ambiente. Las credenciales de prueba no funcionan en Producción.
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. Homologación no es Producción. Las credenciales de prueba de Mercado Pago solo valen en el ambiente de pruebas. Cambiá a las de Producción al entrar en operación.
2. Son dos credenciales. Mercado Pago exige Client ID (Clave Principal) y Client Secret (Clave Secreta).
3. Usá las credenciales de la aplicación correcta. Cada aplicación de Mercado Pago tiene sus propias credenciales; usá las de la aplicación ligada a tu cuenta de cobranza.
4. Credenciales exactas. Pegá el Client ID y el Client Secret exactamente como aparecen en el panel, sin espacios.
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 el Client ID y el Client Secret?En el panel de desarrolladores de Mercado Pago, en las credenciales de tu aplicación. 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á el Client ID y el Client Secret y el ambiente. Corregí, guardá y probá de nuevo.
¿Necesito importar archivo de retorno?No. En el gateway el pago vuelve confirmado automáticamente.
¿En cuánto tiempo aparece el pago?En la próxima ejecución de la tarea de sincronización, dentro de la ventana "Verificación de cobros".
Cambié las credenciales. ¿Debo probar de nuevo?Sí. Cada vez que cambiés el Client ID, el Client Secret o el ambiente, guardá y hacé clic en Probar gateway.
¿Las credenciales de prueba sirven en Producción?No. Son diferentes; cambialas al ir a Producción.
Documentos relacionados