> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chargefy.io/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, 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      |
| 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

<Steps>
  <Step title="Criar Conta na Chargefy">
    Cadastre-se em [chargefy.io](https://chargefy.io/signup) e crie sua organização.
  </Step>

  <Step title="Configurar Produtos">
    Recrie seus produtos no dashboard da Chargefy ou via API. Configure preços em BRL.
  </Step>

  <Step title="Atualizar Integração">
    Aponte sua integração para os endpoints da API Chargefy (`https://api.chargefy.io/v1/...`) usando sua API key.
  </Step>

  <Step title="Configurar Webhooks">
    Configure novos endpoints de webhook no dashboard da Chargefy para receber eventos.
  </Step>

  <Step title="Migrar Clientes">
    Importe clientes existentes via API.
  </Step>

  <Step title="Validar a Integração">
    Valide sua integração em um ambiente controlado da sua aplicação antes de apontar tráfego de produção.
  </Step>
</Steps>

### Diferenças Importantes

<Warning>
  A Chargefy é focada no Brasil e tem particularidades:

  * 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
</Warning>