Inicio / Documentación / Integraciones
doc://integracoes/cielo
En la integración con Cielo, registras las credenciales de tu tienda en el sistema — a diferencia de Stripe y Mercado Pago, donde no se entrega ninguna clave. Y el error más común no es escribir mal: es usar la credencial de una versión de la plataforma Cielo en la otra.
| Webservice 1.5 (SOAP/XML) | API E-commerce 3.0 (REST/JSON) | |
|---|---|---|
| Credenciales | Afiliación + Clave de Producción | MerchantId + MerchantKey |
| Qué es el 1.er campo | código de identificación del registro de la tienda en Cielo | número de afiliación |
| Por dónde transita la credencial | en el cuerpo de la solicitud | en el encabezado (header) |
| Si falta/está mal | transacción rechazada | la API bloquea la transacción y devuelve error |
| Sandbox | — | público, sin acreditación |
¿Qué versión usa mi oficina? Depende de la configuración de tu proyecto en MMNWEB. Ante la duda, abre un ticket con soporte antes de tocar credenciales — te informamos la versión activa y qué campos completar.
La propia Cielo equipara MerchantId + MerchantKey a usuario y contraseña de tu e-commerce. No los compartas por e-mail, WhatsApp, captura o ticket — ni con nuestro soporte (cuando necesitemos validar algo, te indicamos el camino seguro).
Según el PDF oficial de Cielo (2023): acceso al sitio de Cielo → elegir el establecimiento → pestaña E-commerce → API E-commerce Cielo → ambiente Braspag → Cielo → Credenciales → Visualizar Merchant Key → código de confirmación por e-mail → Confirmar.
Atención — el panel cambia: fuentes más recientes describen otro flujo (Gestión API e-commerce → Credencial API), en el que el MerchantKey se muestra una única vez en la generación y solo puede obtenerse de nuevo por revocación (que tarda ~15 min en reflejarse e invalida la clave anterior — riesgo real si la tienda está en producción; nunca lo hagas como paso estándar). Si la pantalla que ves difiere del PDF, consulta docs.cielo.com.br o el soporte de Cielo antes de actuar.
Producción (API 3.0): https://api.cieloecommerce.cielo.com.br/1/sales/
Sandbox (API 3.0): https://cadastrosandbox.cieloecommerce.cielo.com.br/
Acreditación e-commerce: credenciamentoecommerce@cielo.com.br · Soporte: cieloecommerce@cielo.com.br · 4002 9700 · 0800 570 1700
docs.cielo.com.br (documentación actual) · FAQ 1.5 × 3.0 y guía de migración (el manual developercielo.github.io está descontinuado desde el 14/08/2024 — citado aquí como legado).
Relacionados: Visión general de las integraciones · Stripe · Mercado Pago · Conceptos del motor
¿Checkout detenido o credencial en duda?