Breadcrumbs

Integrar a Cielo ao Kubo para uso no Marketplace

Para utilizar a Cielo como meio de pagamento no Marketplace, é necessário integrá-la ao Kubo.

Pré-requisitos

Antes de iniciar, verifique se:

  • Sua empresa possui um contrato ativo com a Cielo.

  • O cadastro da conta Cielo está completo e aprovado.

Instruções

Passo 1: obter as credenciais Merchant ID e Merchant Key

  1. Acesse o Portal Cielo e-Commerce ou entre diretamente no Backoffice Cielo com seu login

  2. Clique em Minha Conta ou Credenciais de API (o nome pode variar)

  3. Selecione o ambiente Produção

  4. Copie os valores de Merchant ID e Merchant Key

Armazene essas informações em local seguro e nunca as compartilhe publicamente.

Passo 2: configurar as credenciais Merchant ID e Merchant Key no Kubo

  1. Acesse o menu Marketplace > Configuração

  2. Clique na aba Pagamento

  3. Em Meio de pagamento, habilite a opção Ativar da Cielo

  4. Preencha os campos Merchant ID e Merchant Key com as credenciais obtidas no Passo 1

Para orientações sobre os demais campos de configuração, acesse Configurar pagamento.

  1. Clique no botão Salvar

Passo 3: configurar a URL de notificações (Webhook)

  1. Acesse o menu Marketplace > Configuração

  2. Clique na aba Pagamento

  3. Em Meio de pagamento, copie a URL exibida no campo Webhook

  4. Solicite à Cielo a configuração da URL de notificação para sua conta, enviando um e-mail para cieloecommerce@cielo.com.br com os seguintes dados:

    • A credencial Merchant ID.

    • A URL do Webhook.

Passo 4: ativar o serviço de consulta BIN

O serviço de consulta BIN (identificação de bandeiras de cartão) não é ativado por padrão. Para habilitá-lo, siga os passos abaixo:

  1. Acesse o Portal Cielo e-Commerce ou entre diretamente no Backoffice Cielo com seu login

  2. Clique em Minha Conta ou Gestão de API (o nome pode variar)

  3. Na seção de Microsserviços, localize a opção Consulta BIN

  4. Ative o serviço

Se, ao selecionar o método de pagamento por cartão de crédito, for exibido o seguinte erro ao usuário/aluno:

image-20250730-151648.png

Entre em contato com a Cielo por e-mail (cieloecommerce@cielo.com.br) e solicite a ativação do serviço de consulta BIN (GET /1/card/bin/{bin}) para o seu ambiente de produção.

Aguarde a confirmação da ativação e liberação da rota no seu Merchant ID.