Início / Documentação / Integrações
doc://integracoes/cielo
Na integração com a Cielo, você cadastra as credenciais da sua loja no sistema — diferente da Stripe e do Mercado Pago, onde nenhuma chave é entregue. E o erro mais comum não é digitar errado: é usar a credencial de uma versão da plataforma Cielo na outra.
| Webservice 1.5 (SOAP/XML) | API E-commerce 3.0 (REST/JSON) | |
|---|---|---|
| Credenciais | Afiliação + Chave de Produção | MerchantId + MerchantKey |
| O que é o 1º campo | código de identificação do cadastro da loja na Cielo | número de afiliação |
| Onde a credencial trafega | no corpo da requisição | no cabeçalho (header) |
| Se ausente/errada | transação recusada | a API bloqueia a transação e retorna erro |
| Sandbox | — | público, sem credenciamento |
Qual versão o meu escritório usa? Depende da configuração do seu projeto no MMNWEB. Na dúvida, abra um chamado com o suporte antes de mexer em credencial — informamos a versão ativa e quais campos preencher.
A própria Cielo equipara MerchantId + MerchantKey a usuário e senha do seu e-commerce. Não compartilhe por e-mail, WhatsApp, print ou ticket — nem com o nosso suporte (quando precisarmos validar algo, orientamos o caminho seguro).
Conforme o PDF oficial da Cielo (2023): login no site da Cielo → escolher o estabelecimento → aba E-commerce → API E-commerce Cielo → ambiente Braspag → Cielo → Credenciais → Visualizar Merchant Key → código de confirmação por e-mail → Confirmar.
Atenção — o painel muda: fontes mais recentes descrevem outro fluxo (Gestão API e-commerce → Credencial API), em que o MerchantKey é exibido uma única vez na geração e só pode ser obtido de novo por revogação (que leva ~15 min pra refletir e invalida a chave anterior — risco real se a loja estiver em produção; nunca faça como passo padrão). Se a tela que você vê divergir do PDF, consulte docs.cielo.com.br ou o suporte da Cielo antes de agir.
Produção (API 3.0): https://api.cieloecommerce.cielo.com.br/1/sales/
Sandbox (API 3.0): https://cadastrosandbox.cieloecommerce.cielo.com.br/
Credenciamento e-commerce: credenciamentoecommerce@cielo.com.br · Suporte: cieloecommerce@cielo.com.br · 4002 9700 · 0800 570 1700
docs.cielo.com.br (documentação atual) · FAQ 1.5 × 3.0 e guia de migração (o manual developercielo.github.io está descontinuado desde 14/08/2024 — citado aqui como legado).
Relacionados: Visão geral das integrações · Stripe · Mercado Pago · Conceitos do motor
Checkout parado ou credencial em dúvida?