Produto

RECOMENDADO

TESTE GRATUITO

Integrações

CONEXÕES UNIFICADAS

Visualize todas as suas assinaturas juntas para fornecer uma visão holística da saúde de suas empresas.

Recursos

Como Migrar Dados de Clientes do PayPal para Stripe: Tudo Que Você Precisa Saber

Por Lea LeBlanc em 03 de junho de 2021
Última atualização em 18 de junho de 2026

Este artigo cobre em detalhes como migrar dados de clientes do PayPal para o Stripe usando os recursos do Stripe, bem como lógica personalizada. O cliente Baremetrics, Sync with Connex, compartilhou conosco como eles realizaram a migração.

Joseph Anderson é o Fundador e CEO da Sincronizar com Connex, uma empresa SaaS que automatiza a entrada de dados entre QuickBooks e canais de comércio eletrônico on-line. Depois de usar o PayPal para processamento de pagamentos por 10 anos, ele decidiu mudar para a plataforma Stripe. 

Ele decidiu migrar do PayPal para o Stripe porque o software do PayPal e os relatórios de dados eram insuficientes para as necessidades do Sync with Connex. Com o Stripe, Joseph pode aproveitar mais os recursos amigáveis para desenvolvedores e pode integrar facilmente sua conta com aplicativos de terceiros como Baremetrics para análises mais inteligentes. 

Neste guia, ele explica como o Sync with Connex realizou com sucesso uma migração completa do PayPal para o Stripe, incluindo o código que ele usou para editar informações específicas de assinatura, criar assinaturas e atualizar clientes após serem importados para o Stripe. 

Baremetrics é uma ferramenta de métricas de negócios que amplifica o Stripe para gerar melhores insights com seus dados. Se você está usando o Stripe, definitivamente deveria estar usando o Baremetrics. Obtenha a avaliação gratuita do Baremetrics aqui.

Visão geral: Como o Sync with Connex fez isso?

Embora o Stripe e o PayPal sejam ambos gateways de pagamento, são ferramentas muito diferentes. Os atributos de um cliente no Stripe são diferentes de como estão organizados no PayPal.

Este artigo abordará em detalhes o processo de migração do Stripe para o PayPal.

Embora o Stripe e o PayPal sejam ambos gateways de pagamento, são ferramentas muito diferentes. Os atributos de um cliente no Stripe são diferentes de como estão formatados no PayPal. 

Por causa disso, o Sync with Connex concluiu a migração pelo seguinte processo: 

  1. Primeiro, o Sync with Connex trabalhou com a equipe de migração do Stripe para importar dados de clientes do PayPal para o Stripe usando uma planilha preparada pelo PayPal. O PayPal enviou as informações do cliente para o Stripe e o Stripe importou os dados. A planilha incluía nome do cliente, e-mail e informações de cartão de crédito. 
  2. Algumas contas de usuário foram marcadas como ativas, em vez de canceladas.
  3. Alguns usuários tinham níveis de plano incorretos associados à sua conta.
  4. Algumas contas do Sync with Connex foram associadas incorretamente às suas contas do PayPal.

Este artigo explicará exatamente como o Sync with Connex realizou essas etapas, começando com aprendizados importantes para estar ciente antes de começar. 

5 pontos-chave a saber antes de migrar do PayPal para o Stripe 

Conforme o Sync with Connex migrava do PayPal para o Stripe, eles superaram diversos desafios para fazer com que seus dados de clientes existentes se adequassem ao ambiente do Stripe.

1. Você deve usar a API do Stripe para importar informações de assinatura, preços herdados e informações de contato.

Joseph recomenda criar uma planilha e, em seguida, escrever código para importar a planilha para o Stripe.

Informações de assinatura 

 Se sua empresa oferece diferentes produtos com diferentes níveis de assinatura, você poderá ver qual produto cada cliente está inscrito, mas não o nível de assinatura. 

 Em vez disso, você deve editar suas contas do Stripe importando manualmente uma planilha de números de RP (é o que o PayPal chama de IDs de clientes), seu novo ID de preço do Stripe, a data de membro desde, a data do próximo pagamento e a frequência de pagamento (mensal / anual).

Preços herdados 

Alguns usuários do Sync with Connex têm preços herdados. A lógica que o Sync with Connex usou dizia que "Se a 'data de membro desde' fosse anterior a 1º/6/2019, escolha o ID de preço herdado. Caso contrário, use o novo ID de preço." Quando você fizer sua planilha para importar, certifique-se de que o ID de preço está correto para usuários herdados. O Stripe permite que o mesmo produto contenha vários pontos de preço.

Endereços de faturamento e entrega

Para adicionar detalhes de faturamento, você deve importá-los manualmente usando uma planilha de números de RP, telefone, e-mail e endereço de faturamento. 

Para criar esta planilha, vá para o PayPal Manager. Vá para Relatórios e gere um Relatório Personalizado. Certifique-se de incluir todos os campos necessários. O campo "Comentário 2" contém o número de RP. 

relatório personalizado, comentário 2

2. Você precisará criar IDs de preço do Stripe.

Se você não tem IDs de preço no Stripe, será necessário criá-los. Isso significa criar novos IDs de preço que correspondam aos seus produtos PayPal existentes. 

O Sync with Connex fez isso criando códigos específicos, que eles chamam de SKUs, para cada produto. Usar SKUs tornou mais fácil mapear esses produtos para IDs de preço do Stripe, uma vez que os nomes de produtos do Connex mudaram ao longo dos anos. Então, eles escreveram código para corresponder esses SKUs a uma lista no Stripe. 

Depois de exportar os SKUs do PayPal para uma planilha, o Sync with Connex criou um campo Meta chamado SKU. Então, seu código personalizado mapeou as informações de SKU do PayPal para novos IDs de preço do Stripe através do campo meta SKU de ID de preço do Stripe. 

Para mais informações sobre como mapear campos do PayPal para o Stripe, continue lendo. Para ver seu código, você pode encontrá-lo no final deste artigo. 

3. O PayPal pode exportar as informações do cartão de crédito de um cliente, mas mal-entendidos podem ter grandes consequências. 

Para importar informações de cartão de crédito do PayPal para o Stripe, você pode facilmente exportar para o Stripe através do ID de perfil PayPal dos clientes. No entanto, isso pode ser difícil de fazer com precisão em escala. 

Na experiência do Sync with Connex, durante a migração, uma falha de comunicação fez com que o Stripe recebesse IDs de transação quando deveria ter recebido IDs de perfil do PayPal. Isso foi um problema porque os IDs de transação não teriam reconhecido adequadamente as diferenças nos cronogramas de pagamento dos clientes do Sync with Connex; alguns clientes pagam mensalmente, enquanto outros pagam anualmente. 

Essa falha de comunicação resultou em um atraso de 2 semanas.

 

4. Desativar um cliente antes da migração apagará seu histórico de cliente.

Se você desativar um cliente no PayPal antes de migrar tudo para o Stripe, não apenas suas informações não aparecerão no Stripe, você não poderá reativar seu perfil no futuro. 

 

5. O Stripe permite que você importe assinaturas e dados de clientes um de cada vez.

Como uma solução alternativa, você pode usar programação paralela para importá-los em lotes.

Como os campos do PayPal mapeiam para os campos do Stripe?

Antes de migrar os dados personalizados, vamos ver como os campos mapeiam do PayPal para o Stripe.

Estas são as informações que serão importadas automaticamente ao trabalhar com a equipe de migração do Stripe:

PayPal

Stripe

Notas

Número de RP Campo Meta chamado old_id Usado para vincular usuário Stripe a PayPal
E-mail Email da Conta Usado para vincular usuário Stripe a PayPal e usado para identificar usuários Stripe.

 

RPNumber é a abordagem recomendada para vincular. 

Primeiro Nome de Cobrança Primeiro Nome do Cliente Celular
Sobrenome de Cobrança Sobrenome do Cliente Celular
Telefone  Telefone do Cliente Celular
Endereço de Cobrança 1 Endereço de Cobrança do Cliente 1 Celular
Endereço de Cobrança 2 Endereço de Cobrança do Cliente 2 Celular
Cidade de Cobrança Cidade de Cobrança do Cliente Celular
Estado de Cobrança Estado de Cobrança do Cliente Celular
País de Cobrança País de Cobrança do Cliente Celular

O gráfico abaixo mostra como o Sync with Connex mapeou o email do cliente, cronograma de cobrança, ID de Preço e frequência de assinatura:

Seus Clientes (no PayPal)

Stripe

Notas

Email PayPal Email do Cliente  
Próximo Pagamento Cronograma de Assinatura Usado para definir os termos da assinatura do usuário. Por exemplo, se um usuário tem o plano anual e o último pagamento foi em 1/3/2021, então o termo é 1/3/2021 – 1/3/2022. 

 

Use a âncora do ciclo de cobrança da assinatura Stripe para definir a data do próximo pagamento. 

Em seguida, insira 1/3/2021 como a data de início retroativa. 

SKU do Produto ID de Preço O Sync with Connex adicionou uma lista de seus SKUs de produtos ao Stripe em um campo personalizado chamado SKU. 

 

Em seguida, ele escreveu a lógica para corresponder IDs de preço Stripe aos SKUs. 

Frequência Recorrente Frequência de Assinatura Celular

Pós-Migração: Como os Dados do Cliente ficam no Stripe? 

Como discutido anteriormente, o Stripe importará apenas o email e o método de pagamento. Informações como dados de pagamento anteriores, informações de plano, nome do cliente e detalhes de cobrança não serão importados do PayPal para o Stripe. 

 Abaixo está um exemplo de uma conta de cliente imediatamente após a migração. Observe a ausência de assinaturas e histórico de pagamentos. 

migração de paypal para stripe

Pós-Migração: Usando APIs para Editar e Adicionar Informações Adicionais 

Após a exportação inicial para o Stripe, o Sync with Connex usou as APIs Stripe e PayPal para modificar ainda mais as informações do cliente no Stripe.

O método que ele usou é o seguinte:

  1. Listar assinaturas no PayPal
  1. Criar assinaturas no Stripe
  1. Atualizar clientes no Stripe usando código personalizado

Abaixo está o código que Joseph escreveu para atualizar clientes:

migração de paypal para stripe: código para atualizar informações de cliente

Aqui está o objeto de transferência de dados do Sync with Connex. Alguns dos campos são desnecessários para a integração Stripe: 

objeto de transferência de dados

 

Aqui está o código para importar os usuários:

código para importar usuáriosimportando usuários 2/3importando usuários 3/3

Correspondência de Produtos PayPal e Stripe usando rótulos SKU 

Como Faço para Corresponder Produtos? 

Como mencionado anteriormente, se você não tiver IDs de preço no Stripe, precisará criá-los.

O método de sincronização com Connex era mapear uma planilha de SKUs de produtos (sua forma de rotular diferentes produtos) e IDs de preço do Stripe

No código abaixo, você verá os SKUs e seus IDs de preço: . 

paypal para stripe: skus para ids

Por fim, aqui está como dois produtos Sync with Connex ficaram no Stripe:

visualização de produto pós-migração

Conclusão

É imperativo encontrar o processador de pagamento certo para suas necessidades comerciais. Para Sync with Connex, Stripe foi a escolha mais inteligente devido às suas capacidades avançadas de faturamento, integrações simples e ferramentas criadas para desenvolvedores. 

Mas processar pagamentos é apenas o primeiro passo. Empresas de SaaS e assinatura precisam entender métricas como MRR, ARR, LTV e muito mais para entender com precisão a saúde de seus negócios e prever o crescimento. 

Connex usa Baremetrics para se manter atualizado sobre métricas-chave, bem como recuperar pagamentos falhados e entender melhor por que os clientes cancelam assinaturas. Para saber mais sobre como Sync with Connex usou Baremetrics para recuperar mais de $7.500 em pagamentos falhados em apenas 3 semanas, confira a história deles aqui. 

Joseph Anderson é o Fundador e CEO da Sincronizar com Connex, uma empresa de SaaS que automatiza a entrada de dados entre QuickBooks e canais de vendas online. Joseph é o autor de "The $20 SaaS Company: From Zero to Seven Figures Without Venture Capital"", publicado em 6 de junho de 2021. 

A camada de recuperação que a maioria das configurações de faturamento está perdendo

Além da mecânica de faturamento abordada acima, o vazamento de receita silencioso na maioria dos negócios de assinatura é recuperação de pagamentos falhados. Negócios de assinatura perdem em média 9% de MRR para cartões expirados, fundos insuficientes e cobranças recusadas — quase tudo isso é recuperável com um sistema de cobrança estruturado. Entre 148 clientes da Baremetrics usando Recuperar em dezembro de 2024, $1,35 milhão foi recuperado em um único mês; 82% dos clientes viram a ferramenta se pagar no primeiro mês. O sistema completo é coberto em nosso guia de gerenciamento de cobrança; para o lado prático do e-mail, consulte como escrever e-mails de cobrança.

Perguntas Frequentes

  • Como você migra dados de clientes do PayPal para o Stripe sem perder o histórico de assinaturas?
    Migrar dados de clientes do PayPal para o Stripe requer um processo coordenado: exportar uma planilha do PayPal, trabalhar com a equipe de migração do Stripe para importar registros de clientes e usar a API do Stripe para adicionar detalhes de assinatura manualmente.

    O processo de importação do Stripe traz apenas informações básicas de clientes, como e-mail e método de pagamento. Histórico de assinatura, níveis de plano, endereços de faturamento e preços herdados precisam ser adicionados separadamente por meio de chamadas de API ou código personalizado. Antes de iniciar sua migração de dados de clientes, mapeie seus campos do PayPal para seus equivalentes no Stripe, crie IDs de Preço do Stripe correspondentes para cada nível de produto oferecido e certifique-se de passar IDs de Perfil do PayPal em vez de IDs de transação para evitar erros de faturamento. Desativar um cliente no PayPal antes de concluir a migração apagará seu histórico permanentemente, portanto sequencie os passos com cuidado.
  • Quais dados de clientes são transferidos automaticamente do PayPal para o Stripe e quais devem ser adicionados manualmente?
    O processo de migração do Stripe importa automaticamente campos básicos, incluindo nome do cliente, e-mail e informações de cartão de crédito, mas detalhes de assinatura, endereços de faturamento, níveis de plano e histórico de pagamento exigem importação manual por meio da API do Stripe.

    Essa distinção é importante porque a maioria dos dados que uma empresa de SaaS realmente precisa, como o nível de preço do cliente, a âncora do ciclo de faturamento e a data de adesão, não será transferida automaticamente. Você precisará criar uma planilha que mapeie números de referência do PayPal (chamados números RP) para IDs de Preço do Stripe, frequências de assinatura e datas do próximo pagamento, e escrever código personalizado para enviar esses dados para o Stripe. Para empresas de assinatura especialmente, pular esta etapa significa que seu novo ambiente do Stripe mostrará clientes sem planos ativos e sem histórico de pagamento.
  • Como você lida com preços herdados ao migrar assinaturas do PayPal para o Stripe?
    A precificação herdada deve ser gerenciada manualmente durante uma migração do PayPal para o Stripe, criando IDs de Preço do Stripe separados para cada ponto de preço histórico e escrevendo lógica para atribuir o preço correto a cada cliente com base em sua data de inscrição original.

    O Stripe suporta múltiplos pontos de preço dentro de um único produto, o que torna isso viável. Uma abordagem comum é definir uma regra condicional no seu código de importação: se a data de adesão de um cliente é anterior à sua mudança de preço, atribua o ID de Preço herdado; caso contrário, use o atual. Cometer um erro significa cobrar dos assinantes de longo prazo uma taxa incorreta, o que cria risco de churn e sobrecarga de suporte. Construa sua lógica de mapeamento de preços antes de executar qualquer importação em massa e valide uma amostra de contas antes de migrar sua base de assinantes completa.
  • Quais são os erros mais comuns que levam as empresas de SaaS a perder dados de receita durante uma migração de processador de pagamento?
    Os erros mais comuns que causam perda de receita em uma migração de processador de pagamento são desativar clientes antes de concluir a migração, confundir IDs de transação com IDs de perfil de cliente e falhar em mapear níveis de preço herdados para os IDs de Preço novos corretos.

    Cada um desses erros pode ter consequências duradouras para uma empresa de assinatura. Desativar uma conta de cliente do PayPal antes que seus dados sejam totalmente transferidos exclui permanentemente seu histórico sem caminho de recuperação. Enviar IDs de transação em vez de IDs de Perfil para o Stripe quebra os cronogramas de faturamento para clientes com diferentes frequências de pagamento. E o mapeamento incorreto de ID de Preço coloca silenciosamente clientes no plano errado, o que inflaciona ou subestima a MRR. Uma lista de verificação de migração limpa que cubra mapeamento de campos, lógica de preços e um lançamento em fases com pontos de validação reduz o risco de cada um desses modos de falha.
  • Como você rastreia MRR e churn com precisão após mudar do PayPal para o Stripe?
    Após migrar para o Stripe, conectar sua conta a uma plataforma de análise de assinatura como Baremetrics oferece rastreamento de MRR em tempo real, relatórios de churn e cálculos de LTV sem configuração adicional.

    O Stripe por si só mostra dados de transação, mas não fornece as métricas em nível de assinatura que uma empresa de SaaS precisa para monitorar a saúde da receita. Baremetrics extrai diretamente de seus dados do Stripe e divide MRR em receita nova, expansão, contração e MRR de churn, para que você possa ver exatamente onde a receita está crescendo ou vazando após a migração. Isso é especialmente útil nas semanas após uma mudança de processador de pagamento, quando anomalias de faturamento são mais prováveis de surgir. Você também pode comparar sua taxa de churn pós-migração em relação a dados do setor de centenas de outras empresas de SaaS usando dados de benchmark aberto do Baremetrics.
  • Quais plataformas oferecem recuperação automatizada de pagamentos falhos para empresas de assinatura que processam pagamentos por meio do Stripe?
    Baremetrics inclui uma ferramenta de dunning automatizada integrada chamada Recover que tenta novamente pagamentos do Stripe com falha em um cronograma otimizado e envia sequências de e-mail personalizáveis para reduzir churn involuntário.

    Pagamentos com falha são uma das fontes mais recuperáveis de churn para empresas de assinatura. Entre 148 clientes de Baremetrics usando Recover em dezembro de 2024, a ferramenta recuperou US$ 1,35 milhão em um único mês, com 82% dos clientes vendo-a se pagar no primeiro mês. Recover funciona diretamente sobre sua integração existente com o Stripe, portanto não há infraestrutura de faturamento adicional para gerenciar. Para empresas de SaaS que acabaram de concluir uma migração de processador de pagamento e desejam proteger a receita que moveram, recuperação automatizada de pagamentos com falha é uma das ferramentas de maior alavancagem para ativar imediatamente.
  • Como fundadores de SaaS podem comparar sua taxa de churn após uma grande mudança de infraestrutura de faturamento, como uma migração de processador de pagamento?
    Baremetrics oferece dados de benchmark aberto extraídos de centenas de empresas de SaaS, permitindo que fundadores comparem sua taxa de churn, crescimento de MRR e LTV em relação a empresas em escala de receita similar após uma migração de processador de pagamento.

    Uma migração do PayPal para o Stripe geralmente causa um pico temporário em pagamentos com falha e contato com clientes, o que pode fazer as métricas de churn parecerem piores do que realmente são. Ter um benchmark confiável ajuda você a distinguir um blip relacionado à migração de um problema real de retenção. Baremetrics segmenta dados de benchmark por faixa de MRR, portanto uma empresa de assinatura com MRR de US$ 50K não está sendo comparada a uma empresa SaaS enterprise com um perfil de cliente completamente diferente. Monitorar MRR novo, MRR de expansão e MRR de churn separadamente nas semanas seguintes a uma migração oferece a imagem mais clara de se a receita está se estabilizando ou se ação é necessária.

Lea LeBlanc

Lea é apaixonada por negócios impactantes, boas escritas e as histórias que os fundadores têm para contar. Quando não está escrevendo sobre tópicos de SaaS, você pode encontrá-la experimentando novas receitas em sua pequena cozinha em Tóquio.