Breadcrumbs

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

  1. Acceda al Portal Cielo e-Commerce o entre directamente en el Backoffice Cielo con su nombre de usuario

  2. Haga clic en Mi cuenta o Credenciales API (el nombre puede variar)

  3. Seleccione el entorno Producción

  4. 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

  1. Acceda al menú Marketplace > Configuraciones

  2. Haga clic en la pestaña Pago

  3. En Medio de pago, habilite la opción Activar de Cielo

  4. 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.

  1. Haga clic en el botón Guardar

Paso 3: configurar la URL de notificaciones (Webhook)

  1. Acceda al menú Marketplace > Configuraciones

  2. Haga clic en la pestaña Pago

  3. En Medio de pago, copie la URL que aparece en el campo Webhook

  4. 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:

  1. Acceda al Portal Cielo e-Commerce o entre directamente en el Backoffice Cielo con su nombre de usuario

  2. Haga clic en Mi cuenta o Gestión de API (el nombre puede variar)

  3. En la sección Microservicios, localice la opción Consulta BIN

  4. Active el servicio

Si al seleccionar el método de pago con tarjeta de crédito, el usuario/alumno ve el siguiente error:

image-20250730-151648.png

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.