Cómo conectar Quaza a la API de Cielo para cobrar con tarjeta de crédito y validar la integración — lo que llamamos homologar.
Qué es el gateway Cielo
El gateway Cielo conecta Quaza directamente a la API de pagos de Cielo. Con él, las cobranzas con tarjeta de crédito se autorizan en tiempo real y la confirmación vuelve automáticamente.
Homologar es validar tus credenciales (MerchantId y MerchantKey) con Cielo: informás las dos claves, hacés clic en Probar gateway y Quaza confirma la conexión.
Cómo funciona la homologación
Configurás las dos claves, Quaza pide autorización a Cielo y, si las claves son correctas, la integración queda conectada:
Glosario
| Término |
Qué significa |
| Gateway |
Integración vía API: la cobranza y la confirmación ocurren en tiempo real, por internet. |
| Homologar |
Validar tus credenciales con Cielo. En Quaza, es el botón Probar gateway. |
| Ambiente |
Homologación = ambiente de pruebas (Sandbox) de Cielo; Producción = valiendo de verdad. |
| MerchantId |
El identificador de tu tienda en Cielo. Va en el campo Clave Principal. |
| MerchantKey |
La clave secreta de tu tienda en Cielo. Va en el campo Clave Secreta. |
| Tarea "Financiero - Gateway" |
Rutina automática que sincroniza el estado de las cobranzas del gateway. |
Antes de empezar
Vas a necesitar:• Una cuenta en Cielo con la API e-commerce habilitada.
• El MerchantId y el MerchantKey de tu tienda (en el registro de Cielo).
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 - Cielo.
2 En Ambiente, elegí Homologación (Sandbox) para probar o Producción.
3 En Clave Principal, pegá el MerchantId.
4 En Clave Secreta, pegá el MerchantKey.
Guardá y hacé clic en Probar gateway.
Pestaña Gateway: (1) Integración con gateway = Gateway - Cielo, (2) Ambiente, (3) Clave Principal (MerchantId), (4) Clave Secreta (MerchantKey) y el botón Probar gateway.
El botón "Probar gateway"
El botón Probar gateway pide una autorización a Cielo usando el MerchantId y el MerchantKey. Si las dos claves son correctas, aparece Conectado con éxito — la integración está homologada.
¿Dio error al probar? Verificá el MerchantId y el MerchantKey (sin espacios) y el Ambiente. Las claves de Sandbox no funcionan en Producción y viceversa.
Tareas automáticas
Una vez homologado, Quaza acompaña las cobranzas 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 (pago) |
Procesa los pagos por tarjeta de las carteras con cobranza recurrente — es la tarea que efectiviza el cobro en la tarjeta. |
| Financiero - Gateway (aviso) |
Genera los avisos y notificaciones relacionados a las cobranzas del gateway. |
Errores frecuentes
1. Sandbox no es Producción. Las claves de Homologación (Sandbox) de Cielo solo funcionan en el ambiente de pruebas. Cambiá a las claves de Producción al entrar en operación.
2. Son dos claves. Cielo exige MerchantId (Clave Principal) y MerchantKey (Clave Secreta). Si falta una, la prueba falla.
3. Cielo es tarjeta de crédito. Este gateway procesa cobranzas con tarjeta (incluso recurrentes), no boleto.
4. Claves exactas. Pegá el MerchantId y el MerchantKey exactamente como aparecen en el panel de Cielo, sin espacios.
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 el MerchantId y el MerchantKey?En el registro de tu tienda en Cielo (API e-commerce). Quaza no genera esas claves.
¿Cielo cobra boleto?No. Este gateway es para tarjeta de crédito. Para boleto, usá un gateway bancario.
¿Puedo probar antes de poner en producción?Sí. Usá el ambiente Homologación (Sandbox) con las claves de prueba de Cielo.
"Probar gateway" dio error. ¿Qué hago?Verificá el MerchantId y el MerchantKey (sin espacios) y el ambiente. Corregí, guardá y probá de nuevo.
¿La confirmación del pago es automática?Sí. La tarea Financiero - Gateway sincroniza y la Financiero - Gateway (pago) procesa las cobranzas en la tarjeta.
¿Necesito importar archivo de retorno?No. El gateway es en tiempo real; no hay archivo de retorno.
Cambié las claves. ¿Debo probar de nuevo?Sí. Cada vez que cambiés el MerchantId, el MerchantKey o el ambiente, guardá y hacé clic en Probar gateway.
¿Las claves de Sandbox sirven en Producción?No. Son credenciales diferentes; cambialas al ir a Producción.
Documentos relacionados