> ## Documentation Index
> Fetch the complete documentation index at: https://scaleup-c34c4386.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Métodos de Pagamento

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

> [!NOTE]
>
> **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

```typescript theme={null}
// Criar checkout com PIX
const checkout = await chargefy.checkouts.create({
  product_price_id: "price_xxx",
  payment_method: "pix",
  customer_email: "cliente@email.com",
});

// Confirmar checkout (gera QR Code)
const confirmed = await chargefy.checkouts.confirm(checkout.id, {
  customer_name: "João Silva",
  customer_email: "cliente@email.com",
  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
```

> [!NOTE]
>
> 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

```typescript theme={null}
// Confirmar checkout com cartão
const confirmed = await chargefy.checkouts.confirm(checkout.id, {
  customer_name: "João Silva",
  customer_email: "cliente@email.com",
  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](https://scaleup-c34c4386.mintlify.site/features/subscriptions.md).

***

## 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

```typescript theme={null}
// Confirmar checkout com boleto
const confirmed = await chargefy.checkouts.confirm(checkout.id, {
  customer_name: "João Silva",
  customer_email: "cliente@email.com",
  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
```

> [!WARNING]
>
> 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

> [!NOTE]
>
> **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](https://scaleup-c34c4386.mintlify.site/integrate/webhooks/events.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.