Credenciais e autenticação

Abaixo, você aprende como solicitar credenciais Sandbox e, em seguida, credenciais Produção.

Solicitação de credenciais Sandbox

Para obter acesso ao ambiente Sandbox, solicite à Cielo, por meio do e‑mail [email protected], as seguintes credenciais:

  • Client ID e Client Secret (utilizados para autenticação via OAuth2);
  • Chave Pix transacional (tipo: aleatória).

No ambiente Sandbox, gere uma cobrança e obtenha o Pix copia e cola retornado pela API. Envie esse código por e-mail para [email protected] para que a Cielo efetue o pagamento. Configure um tempo de expiração maior para o Pix copia e cola.

ℹ️

API não retorna diretamente uma imagem de QR Code, a API retorna apenas o Pix copia e cola, utilizado para realizar o pagamento. A geração do QR Code a partir desse código é de responsabilidade do parceiro integrador, que deve implementá-la em seu próprio backend.

Solicitação de credenciais Produção

Para transacionar em nome dos clientes da Cielo, os parceiros devem ter as seguintes chaves do cliente:

  • Client ID
  • Client Secret
  • Chave Pix
🚧

Cada estabelecimento comercial precisa ter credenciais próprias.

Siga o passo-a-passo abaixo para gerar credenciais de Produção:

  1. Faça login no site Cielo e clique em Pix;
  2. No menu à esquerda, selecione a opção Configurações do Pix.
  1. Clique em Credenciais do Pix e, em seguida, em Criar credencial.

  1. Selecione a Plataforma parceira.
  1. Clique em Criar.

  1. Confirme a plataforma selecionada clicando em Continuar.
  2. Em seguida, aceite os termos e condições para criações de credenciais marcando a caixa e clique em Criar credencial.
  1. Complete o processo de autenticação.

Pronto! Credencial criada com sucesso. Agora, você pode baixar ou copiar suas credenciais para realizar onboarding no portal parceiro.


As credenciais precisam ser copiadas/baixadas dentro de 3 minutos. Caso contrário, será necessário gerar uma nova credencial.