Skip to main content

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 OriginalEquivalente ChargefyNotas
CustomerCustomerMesmo conceito, com campos brasileiros (CPF/CNPJ)
ProductProductSuporte a one-time, recorrente e baseado em uso
PricePriceValores em BRL (R$), suporte a parcelamento
SubscriptionSubscriptionGerenciada pelo sistema de recorrência da Chargefy
Checkout SessionCheckoutSuporte a PIX, Cartão e Boleto
WebhookWebhookMesmo padrão Standard Webhooks com HMAC
API KeyOrganization 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