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 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 para validar toda a integração antes de ir para produção.

Diferenças Importantes

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