Métodos de Pagamento

PIX, Cartão de Crédito e Boleto — todos os métodos de pagamento brasileiros em uma única plataforma

Pagamentos brasileiros simplificados

A 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ística	PIX	Cartão de Crédito	Boleto Bancário
Processador	Chargefy	Chargefy	Chargefy
Confirmação	Instantânea	Instantânea	1-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: "[e-mail]",
});

// Confirmar checkout (gera QR Code)
const confirmed = await chargefy.checkouts.confirm(checkout.id, {
  customer_name: "João Silva",
  customer_email: "[e-mail]",
  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

Parcelas	Disponibilidade
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: "[e-mail]",
  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: "[e-mail]",
  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.