Skip to main content
Pagamentos brasileiros simplificadosA Chargefy oferece os três principais métodos de pagamento do Brasil em uma única integração: PIX, Cartão de Crédito e Boleto Bancário.

​
Visão Geral

CaracterísticaPIXCartão de CréditoBoleto Bancário
ProcessadorChargefyChargefyChargefy
ConfirmaçãoInstantâneaInstantânea1-3 dias úteis
Parcelamento❌✅ 1-12x❌
Recorrência❌✅❌
Pagamento único✅✅✅
Reembolso✅✅✅

​
PIX

O PIX é o método de pagamento instantâneo do Banco Central do Brasil. É o método mais popular do país, com confirmação em segundos.

​
Como funciona na Chargefy

1

Criar checkout

Crie uma sessão de checkout via API ou Checkout Link, selecionando PIX como método de pagamento.
2

QR Code gerado

A Chargefy gera automaticamente um QR Code e o código EMV (copia e cola).
3

Cliente paga

O cliente escaneia o QR Code com o app do banco ou copia o código PIX.
4

Confirmação instantânea

O pagamento é confirmado em segundos. A Chargefy atualiza o status do checkout para succeeded.

​
Exemplo de código

// Criar checkout com PIX
const checkout = await chargefy.checkouts.create({
  product_price_id: "price_xxx",
  payment_method: "pix",
  customer_email: "[email protected]",
});

// Confirmar checkout (gera QR Code)
const confirmed = await chargefy.checkouts.confirm(checkout.id, {
  customer_name: "João Silva",
  customer_email: "[email protected]",
  customer_tax_id: "123.456.789-00",
});

// O response inclui:
// confirmed.payment_data.pix_qr_code — QR Code para exibir
// confirmed.payment_data.pix_emv — Código copia e cola
O PIX está disponível apenas para pagamentos únicos. Para cobranças recorrentes, utilize cartão de crédito.

​
Cartão de Crédito

Pagamento com cartão de crédito via tokenização segura, com suporte a parcelamento de 1 a 12 vezes.

​
Como funciona na Chargefy

1

Criar checkout

Crie uma sessão de checkout via API ou Checkout Link.
2

Dados do cartão

O cliente insere os dados do cartão. Os dados são tokenizados de forma segura pela Chargefy.
3

Parcelamento

Para pagamentos únicos, o cliente pode escolher parcelar em 1 a 12 vezes.
4

Confirmação

O pagamento é processado e confirmado instantaneamente. O status do checkout é atualizado para succeeded.

​
Parcelamento

ParcelasDisponibilidade
1x (à vista)✅ Sempre disponível
2x a 12x✅ Configurável por produto
Com juros✅ Configurável
Sem juros✅ Configurável

​
Bandeiras aceitas

  • Visa
  • Mastercard
  • Elo
  • American Express
  • Hipercard
  • Diners Club

​
Exemplo de código

// Confirmar checkout com cartão
const confirmed = await chargefy.checkouts.confirm(checkout.id, {
  customer_name: "João Silva",
  customer_email: "[email protected]",
  customer_tax_id: "123.456.789-00",
  payment_method: "credit_card",
  card: {
    holder_name: "JOAO SILVA",
    card_number: "4111111111111111",
    expiry_month: "12",
    expiry_year: "2028",
    cvv: "123",
  },
  installments: 3, // 3x sem juros
});

​
Recorrência

O cartão de crédito é o único método que suporta cobranças recorrentes na Chargefy. Ao confirmar um checkout para um produto recorrente, a Chargefy automaticamente:
  1. Cria um plano de recorrência
  2. Vincula o cartão ao plano
  3. Processa cobranças automáticas no ciclo definido (mensal, anual, etc.)
Saiba mais em Assinaturas.

​
Boleto Bancário

O boleto bancário é um método de pagamento tradicional no Brasil, com compensação em 1 a 3 dias úteis.

​
Como funciona na Chargefy

1

Criar checkout

Crie uma sessão de checkout via API ou Checkout Link, selecionando Boleto como método de pagamento.
2

Boleto gerado

A Chargefy gera o boleto com código de barras, linha digitável e URL do PDF.
3

Cliente paga

O cliente paga o boleto em qualquer banco, lotérica ou app bancário antes da data de vencimento.
4

Compensação

O pagamento é compensado em 1 a 3 dias úteis. A Chargefy atualiza o status do checkout para succeeded.

​
Configurações do Boleto

  • Data de vencimento — Padrão de 3 dias, configurável na criação do checkout
  • Instruções — Mensagem personalizada impressa no boleto
  • Multa e juros — Configuráveis para pagamento após vencimento

​
Exemplo de código

// Confirmar checkout com boleto
const confirmed = await chargefy.checkouts.confirm(checkout.id, {
  customer_name: "João Silva",
  customer_email: "[email protected]",
  customer_tax_id: "123.456.789-00",
  payment_method: "boleto",
  boleto: {
    due_date: "2026-03-20",
  },
});

// O response inclui:
// confirmed.payment_data.barcode — Código de barras
// confirmed.payment_data.digitable_line — Linha digitável
// confirmed.payment_data.pdf_url — URL do PDF do boleto
O boleto está disponível apenas para pagamentos únicos. Devido ao prazo de compensação de 1-3 dias, não é adequado para cobranças recorrentes automáticas.

​
Escolhendo o método certo

Recomendação por caso de uso:
  • Venda única de produto digital → PIX (confirmação instantânea, sem taxas de parcelamento)
  • Assinatura mensal/anual → Cartão de Crédito (único método que suporta recorrência)
  • Venda para empresas (B2B) → Boleto (preferido por departamentos financeiros)
  • Máxima conversão → Ofereça todos os métodos e deixe o cliente escolher

​
Webhooks de pagamento

Independente do método de pagamento, a Chargefy dispara os mesmos eventos de webhook:
  • checkout.updated — Quando o status do checkout muda
  • subscription.active — Quando a assinatura é ativada após pagamento
Para métodos assíncronos (PIX e Boleto), o fluxo é:
  1. Checkout status muda para confirmed (aguardando pagamento)
  2. Quando o pagamento é recebido, a Chargefy atualiza o checkout para succeeded e dispara checkout.updated
Saiba mais em Webhooks.