Ir para o conteúdo

Migrando Assinantes Existentes para o 4Geeks Payments

🤖 Explicar com IA

Migrar sua base de assinantes para uma nova plataforma de pagamento é um processo crítico que exige precisão para garantir a continuidade da receita. O 4Geeks Payments foi projetado para tornar essa transição contínua, ajudando você a consolidar sua cobrança, reduzir a evasão involuntária (churn) por meio de retentativas inteligentes e oferecer uma melhor experiência ao cliente com um portal de autoatendimento dedicado.

Este guia descreve as estratégias mais eficazes para mover seus clientes recorrentes atuais para o 4Geeks Payments sem interromper o serviço.

Pré-requisitos

Antes de iniciar a migração, certifique-se de atender aos seguintes requisitos:

  • Conta Verificada: Uma conta do 4Geeks Payments verificada (modo Produção ativado).
  • Lista de Clientes: Uma lista de seus clientes atuais (Nome, E-mail) e seus planos ativos.
  • Planos Criados: Seus planos de assinatura já criados no 4Geeks Console (Sales > Recurring Plans).

Estratégias de Migração

Existem três maneiras principais de migrar assinantes. Escolha a que melhor se adapta aos seus recursos técnicos e ao tamanho do seu negócio.

Método 1: O “Novo Começo” (Recomendado para precisão)

Este método consiste em convidar os clientes ativos a assinar novamente por meio de um link seguro. Embora exija uma ação do cliente, costuma ser a melhor escolha para o seu negócio, pois atualiza cartões expirados, verifica informações de contato e garante a conformidade com a Autenticação Forte do Cliente (SCA).

  1. Crie Seus Planos: Certifique-se de que seus planos no 4Geeks correspondam aos planos antigos (preço, intervalo, moeda).
  2. Gere Convites:
    • Vá em Sales > Recurring Plans no 4Geeks Console.
    • Selecione o plano para o qual deseja migrar os usuários.
    • Clique em Add Subscriber.
    • Insira o e-mail do cliente.
  3. Envie o Convite: O 4Geeks enviará um e-mail oficial e seguro para o seu cliente contendo um link para ativar a nova assinatura.
  4. Cancele as Assinaturas Antigas: Assim que o cliente confirmar a nova assinatura no 4Geeks, cancele o perfil dele no provedor anterior para evitar cobranças duplicadas.

Método 2: Migração Programática (Para Desenvolvedores)

Se você tiver uma grande base de usuários e recursos de desenvolvimento, poderá automatizar o processo usando a API do 4Geeks Payments.

  1. Recupere o ID do Plano: No Console, abra os detalhes do seu plano para encontrar seu endpoint/ID de API exclusivo.
  2. Crie o Script de Migração: Escreva um script para percorrer seu banco de dados de clientes.
  3. Crie Assinaturas: Envie uma solicitação POST para cada cliente para a URL exclusiva do plano.
    • Dados Obrigatórios: Você deve incluir o nome e o e-mail do cliente no corpo da solicitação.
  4. Gerencie os Detalhes de Pagamento: Como você não pode transferir dados brutos de cartão de crédito via API (devido à conformidade PCI), a API iniciará uma assinatura “Pendente”. Você pode então acionar um e-mail pedindo ao usuário que simplesmente atualize o método de pagamento no Portal do Cliente.

Método 3: Migração de Tokens (Somente Enterprise)

Se você tem milhares de assinantes e tokens de cartão de crédito ativos com um provedor em conformidade com PCI (como Stripe ou PayPal), pode ser possível transferir os dados de pagamento diretamente sem pedir aos usuários que os insiram novamente.

  • Entre em Contato com o Suporte: Este processo exige uma transferência segura entre backends dos processadores de pagamento. Entre em contato com a equipe de Suporte Enterprise do 4Geeks para iniciar uma solicitação de importação de dados segura.

Como Gerenciar a Transição

Assim que seus assinantes forem migrados, o 4Geeks fornece ferramentas para gerenciar o relacionamento contínuo sem esforço.

  • Portal de Autoatendimento: Seus clientes migrados terão acesso automático a um Portal do Cliente. Lá, eles podem atualizar seus próprios cartões de crédito, visualizar o histórico de faturas e gerenciar o status de sua assinatura sem entrar em contato com o suporte.
  • Retentativas Automáticas: Se o pagamento de um cliente migrado falhar (por exemplo, devido a um cartão expirado), o 4Geeks Payments tenta automaticamente retentativas inteligentes para recuperar a receita antes de cancelar a assinatura.

Casos de Uso Comuns

Cenário 1: Mudando do Faturamento Manual para o Faturamento Automatizado

Situação: Uma agência digital envia atualmente faturas em PDF para 50 clientes mensalmente e rastreia as transferências bancárias manualmente.

Solução: A agência cria um plano “Mensalidade” no 4Geeks Payments. Eles usam o Método 1 para enviar por e-mail um link de assinatura seguro para todos os 50 clientes. Os clientes inserem seu cartão corporativo uma vez, e o 4Geeks automatiza a cobrança e a geração de recibos para sempre.

Cenário 2: Consolidando Provedores de Pagamento Regionais

Situação: Uma empresa SaaS usa provedores diferentes para clientes dos EUA e da América Latina, mas deseja um painel unificado.

Solução: Eles usam o Método 2 (API) para criar perfis de clientes para todos os usuários no 4Geeks Payments. Em seguida, direcionam todos os usuários para o Portal do Cliente do 4Geeks para adicionar seu método de pagamento local preferido (cartão, carteira, etc.), aproveitando os recursos globais de processamento do 4Geeks.

Solução de Problemas

Problema 1: Recusa do cliente durante a nova assinatura

  • Solução: Certifique-se de que a moeda do plano corresponda à moeda do cartão do cliente, sempre que possível, para evitar rejeições bancárias. O 4Geeks Payments suporta várias moedas e roteamento inteligente para minimizar as “recusas suaves”.

Problema 2: Cobrança duplicada

  • Solução: O período de migração é delicado. Certifique-se de cancelar explicitamente a assinatura do usuário em seu sistema antigo imediatamente após receber o webhook “New Subscription Created” ou a notificação por e-mail do 4Geeks.

Problema 3: Dados do cliente ausentes

  • Solução: Se estiver usando a API, certifique-se de que seu payload siga estritamente o requisito de incluir first_name, last_name e email válidos. Campos ausentes resultarão em um erro 400 Bad Request.

Perguntas Frequentes (FAQs)

Eu mesmo posso migrar tokens de cartão de crédito ativos?

Não. Por segurança e conformidade PCI-DSS, você não pode exportar/importar dados brutos de cartão de crédito via CSV ou API padrão. Você deve usar o método de “Convite” ou entrar em contato com o suporte para uma migração de token segura.

Meus clientes serão cobrados imediatamente após a migração?

Depende de como você configura o plano. Você pode definir um “Período de Teste” nas configurações do plano se quiser atrasar a primeira cobrança para alinhar com o ciclo de faturamento existente.