> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pagamentos.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Cielo

> Integre cartão de crédito tokenizado com a API E-commerce Cielo

## Sobre a Cielo

A Cielo é uma adquirente brasileira. Esta integração usa a API E-commerce para
criar, consultar e cancelar vendas com cartão tokenizado, além de processar
notificações.

Consulte a [documentação oficial da API E-commerce](https://docs.cielo.com.br/ecommerce-cielo/).

## Métodos e recursos

* `cartaoCredito` — cobrança com `CardToken`
* Consulta e cancelamento de vendas
* Webhooks com segredo configurável

## Credenciais e sandbox

Obtenha `MerchantId` e `MerchantKey` no portal da Cielo. Use `mode: 'sandbox'`
com credenciais de teste e troque para `production` somente após a homologação.

## Configuração

```ts pagamentos.ts theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
import { Pagamentos, cielo } from 'pagamentos'

export const pg = new Pagamentos({
  providers: [
    cielo({
      merchantId: process.env.CIELO_MERCHANT_ID!,
      merchantKey: process.env.CIELO_MERCHANT_KEY!,
      mode: 'sandbox',
      brand: 'Visa',
      allowCardWithoutSecurityCode: true,
      signingSecret: process.env.CIELO_WEBHOOK_SECRET
    })
  ]
})
```

<Warning>
  O fluxo unificado usa `CardToken` sem CVV. Só habilite
  `allowCardWithoutSecurityCode` depois que a Cielo autorizar essa modalidade
  para o seu estabelecimento.
</Warning>

Dados brutos de cartão não devem passar pelo seu backend. Tokenize-os com a
solução aprovada pela Cielo e envie apenas o token ao SDK.

Veja também [cartão de crédito](/metodos/cartao-credito) e
[webhooks](/features/webhooks).