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

# Migração para Chargefy

> Guia para migrar de outras plataformas de pagamento para a Chargefy.

## Migração para Chargefy

Se você está vindo de outra plataforma de pagamentos (Stripe, Polar, PagSeguro, etc.), este guia vai te ajudar a entender os conceitos equivalentes na Chargefy e como migrar sua integração.

### Mapeamento de Conceitos

| Conceito Original | Equivalente Chargefy | Notas |
| - | - | - |
| Customer | Customer | Mesmo conceito, com campos brasileiros (CPF/CNPJ) |
| Product | Product | Suporte a one-time, recorrente e baseado em uso |
| Price | Price | Valores em BRL (R\$), suporte a parcelamento |
| Subscription | Subscription | Gerenciada pelo sistema de recorrência da Chargefy |
| Checkout Session | Checkout | Suporte a PIX, Cartão e Boleto |
| Webhook | Webhook | Mesmo padrão Standard Webhooks com HMAC |
| API Key | Organization Access Token (OAT) | Token de acesso por organização |

### Checklist de Migração

**1. Criar Conta na Chargefy**

Cadastre-se em [chargefy.io](https://chargefy.io/signup) e crie sua organização.

**2. Configurar Produtos**

Recrie seus produtos no dashboard da Chargefy ou via API. Configure preços em BRL.

**3. Atualizar Integração**

Substitua os SDKs anteriores pelo `@chargefy/sdk`. Atualize os endpoints da API.

**4. Configurar Webhooks**

Configure novos endpoints de webhook no dashboard da Chargefy para receber eventos.

**5. Migrar Clientes**

Importe clientes existentes via API. Vincule assinaturas ativas.

**6. Testar no Sandbox**

Use o [ambiente sandbox](https://scaleup-c34c4386.mintlify.site/integrate/sandbox.md) para validar toda a integração antes de ir para produção.

### Diferenças Importantes

> [!WARNING]
>
> A Chargefy possui sua própria infraestrutura de pagamentos, diferente do Stripe. Isso significa que:
>
> * Métodos de pagamento são PIX, Cartão de Crédito e Boleto (não ACH, SEPA, etc.)
> * Parcelamento em até 12x no cartão é nativo
> * Valores são em BRL (R\$)
> * KYC é obrigatório para sellers


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