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. No site da Cielo, acesse o portal Minha Conta e clique em Meu Cadastro.
  2. Na aba Autorizações, clique em Pix.
  3. Selecione a opção Novo acesso.
IMG_PIX_02
  1. Clique em Criar credencial.
IMG_PIX_03
  1. Selecione o parceiro.
IMG_PIX_04
  1. Clique em Criar.
IMG_PIX_05
  1. Aceite os termos de uso e marque a caixa.
IMG_PIX_06
  1. Clique no botão Autenticar e continuar.
IMG_PIX_07

9 Insira o token de segurança.

A ativação do token deve ser realizada através do Cielo Gestão.

IMG_PIX_08

Pronto! Credencial criada com sucesso.

IMG_PIX_09

Após essa etapa, o cliente poderá copiar o Cliente ID, Client Secret e Chave Transacional 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.

IMG_PIX_10