O Cielo OAUTH é um processo de autenticação das APIs Cielo relacionadas ao e-commerce.
O Cielo OAUTH usa como segurança o protocolo OAUTH2, no qual é necessário primeiro obter um token de acesso utilizando suas credenciais e, posteriormente, informar o token nas requisições às APIs.
Para utilizar o Cielo OAUTH são necessárias as seguintes credenciais:
CREDENCIAL | DESCRIÇÃO | TIPO |
---|---|---|
ClientId | Identificador chave fornecido pela Cielo. | GUID |
ClientSecret | Chave que valida o ClientID. Fornecida pela Cielo junto ao ClientID | string |
Para gerar o
ClientID
e oClientSecret
, consulte o tópico de Obtendo as Credenciais, a seguir.
Obtendo as credenciais ClientId e ClientSecret
Para obter as credenciais ClientId
e ClientSecret
para autenticação na API do Link de Pagamento ou na API do Checkout, siga os passos a seguir:
- Após receber o nº de estabelecimento (EC) com a habilitação para o Link de Pagamento ou para o Checkout Cielo, acesse o site Cielo e faça o login;
- Para acessar o Link de Pagamento, navegue até a aba E-commerce > Link de Pagamento > Meus Links > Configurações > Dados Cadastrais. Se você estiver utilizando o Checkout, siga para a aba E-commerce > Checkout > Acessar > Configurações > Dados Cadastrais.
A imagem a seguir ilustra as configurações:
A imagem a seguir ilustra os dados cadastrais:
- Na seção Dados cadastrais, clique no botão Gerar Credenciais de Acesso às APIs e uma mensagem de confirmação aparecerá em tela;
- Um e-mail será enviado com as chaves para o endereço cadastrado como responsável pela loja;
- A partir das credenciais, será possível gerar um token de acesso.
Atenção:
- Os dados de contato técnico não são mais utilizados para o envio de chaves, devido a questões de segurança;
- Para alguns cadastros de Link de Pagamento, o uso do Link via API não será permitido por motivos de regras de negócio. Nesses casos, o botão “Gerar Credenciais de Acesso às APIs” não estará disponível no site da Cielo. Se tiver dúvidas sobre como proceder, entre em contato com o suporte de e-commerce;
- Caso você já tenha utilizado uma credencial anterior, ela deixará de funcionar assim que você clicar para gerar novas credenciais.