Cielo - pagamentos.dev

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.

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

pagamentos.ts

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
    })
  ]
})

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

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 e webhooks.