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

Criar Conta na Chargefy

Cadastre-se em chargefy.io e crie sua organização.

Configurar Produtos

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

Atualizar Integração

Aponte sua integração para os endpoints da API Chargefy (https://api.chargefy.io/v1/...) usando sua API key.

Configurar Webhooks

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

Migrar Clientes

Importe clientes existentes via API.

Validar a Integração

Valide sua integração em um ambiente controlado da sua aplicação antes de apontar tráfego de produção.

Diferenças Importantes

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