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
Acesse o Portal Cielo e-Commerce ou entre diretamente no Backoffice Cielo com seu login
Clique em Minha Conta ou Credenciais de API (o nome pode variar)
Selecione o ambiente Produção
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
Acesse o menu Marketplace > Configuração
Clique na aba Pagamento
Em Meio de pagamento, habilite a opção Ativar da Cielo
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.
Clique no botão Salvar
Passo 3: configurar a URL de notificações (Webhook)
Acesse o menu Marketplace > Configuração
Clique na aba Pagamento
Em Meio de pagamento, copie a URL exibida no campo Webhook
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:
Acesse o Portal Cielo e-Commerce ou entre diretamente no Backoffice Cielo com seu login
Clique em Minha Conta ou Gestão de API (o nome pode variar)
Na seção de Microsserviços, localize a opção Consulta BIN
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:

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.