Autenticação e credenciais

Nossa API conta com dois ambientes:

AmbienteURL Base
Sandboxhttps://api.cielo.com.br/sandbox-lio/order-management/v1
Produçãohttps://api.cielo.com.br/order-management/v1

Para integrar sua aplicação com os serviços da Cielo, é necessário obter credenciais de autenticação, como o Client-ID, Merchant ID e o Access Token. Essas credenciais são essenciais para garantir a segurança e a identificação da sua aplicação durante a comunicação com as APIs da Cielo.

Há dois tipos de credenciais de autenticação:

  • Credenciais de Sandbox: Ambiente de testes que simula a API sem processar transações reais.
    📘

    Não é possível realizar testes em um terminal físico com as credenciais de Sandbox. Para testar em um terminal, solicite as credenciais de testes ao time [email protected].

  • Credenciais de Produção: Ambiente real, onde as chamadas processam transações efetivas de estabelecimentos comerciais verdadeiros.

Caso tenha dúvidas e precise de ajuda, envie um e-mail para [email protected].

Gerando credenciais de Sandbox

Todo o processo de cadastro é feito pelo Portal de Desenvolvedores da Cielo. Siga os passos abaixo:

  1. Acesse o Portal de desenvolvedores e clique aqui para ir diretamente para a página de cadastro de aplicativo.

  2. Preencha os campos obrigatórios, incluindo: Ícone do aplicativo, Nome, Descrição.

  3. No campo API Disponível, selecione Cielo Smart - Order Manager para realizar a integração remota.

  4. Clique em Registrar para concluir o processo.

Gerando credenciais de Produção

Para operar em Produção, é necessário gerar o Merchant ID (token) de cada estabelecimento comercial (EC), já que cada um possui seu próprio identificador.

Para solicitar a geração do Merchant ID, envie um e-mail para [email protected] com as seguintes informações:

  • Estabelecimento comercial (16 dígitos = EC + Loja): Número que consta no terminal do cliente final.
  • Razão Social do EC;
  • E-mail cadastrado no Portal Dev Cielo (Cielo Desenvolvedores);
  • URL de Callback (caso possua) em https padrão e TLS 1.2.

Consultando credenciais de autenticação

Após registrar suas credenciais de autenticação, você pode consultá-las clicando em Perfil > Client-IDs Cadastrados.

Você será redirecionado para uma tela que exibirá o Client-ID, Access Token e o Merchant ID.