Integrar Cielo con Kubo para su uso en el Marketplace
Para utilizar Cielo como medio de pago en el Marketplace, es necesario integrarlo con Kubo.
Requisitos previos
Antes de comenzar, compruebe que:
Su empresa tiene un contrato activo con Cielo.
El registro de la cuenta Cielo está completo y aprobado.
Instrucciones
Paso 1: obtener las credenciales Merchant ID y Merchant Key
Acceda al Portal Cielo e-Commerce o entre directamente en el Backoffice Cielo con su nombre de usuario
Haga clic en Mi cuenta o Credenciales API (el nombre puede variar)
Seleccione el entorno Producción
Copie los valores de Merchant ID y Merchant Key
Guarde esta información en un lugar seguro y nunca la comparta públicamente.
Paso 2: configurar las credenciales Merchant ID y Merchant Key en Kubo
Acceda al menú Marketplace > Configuraciones
Haga clic en la pestaña Pago
En Medio de pago, habilite la opción Activar de Cielo
Rellene los campos Merchant ID y Merchant Key con las credenciales obtenidas en el Paso 1
Para obtener orientación sobre los demás campos de configuración, acceda a Configurar pago.
Haga clic en el botón Guardar
Paso 3: configurar la URL de notificaciones (Webhook)
Acceda al menú Marketplace > Configuraciones
Haga clic en la pestaña Pago
En Medio de pago, copie la URL que aparece en el campo Webhook
Solicite a Cielo la configuración de la URL de notificación para su cuenta enviando un correo electrónico a cieloecommerce@cielo.com.br con los siguientes datos:
La credencial Merchant ID.
La URL del Webhook.
Paso 4: activar el servicio de consulta BIN
El servicio de consulta BIN (identificación de marcas de tarjetas) no está activado por defecto. Para habilitarlo, siga los pasos que se indican a continuación:
Acceda al Portal Cielo e-Commerce o entre directamente en el Backoffice Cielo con su nombre de usuario
Haga clic en Mi cuenta o Gestión de API (el nombre puede variar)
En la sección Microservicios, localice la opción Consulta BIN
Active el servicio
Si al seleccionar el método de pago con tarjeta de crédito, el usuario/alumno ve el siguiente error:

Póngase en contacto con Cielo por correo electrónico (cieloecommerce@cielo.com.br) y solicite la activación del servicio de consulta BIN (GET /1/card/bin/{bin}
) para su entorno de producción.
Espere la confirmación de la activación y la habilitación de la ruta en su Merchant ID.