Solicitar uma importação de dados de pagamento

Importe com segurança dados de pagamento confidenciais.

A Stripe permite que você mantenha seus dados de clientes e pagamentos existentes ao migrar para a Stripe. Trabalhamos com sua equipe e seu provedor de pagamentos atual, conforme necessário, para migrar suas informações com segurança.

Esse processo permite aceitar e cobrar novos clientes na Stripe e continuar cobrando os clientes atuais com o processador atual até que a migração seja concluída. Seus clientes não incorrem em nenhum tempo de inatividade. Após a conclusão do processo de migração, você poderá processar todos os pagamentos na Stripe.

Este guia ensina como migrar para a Stripe de outro processador de pagamentos ou de uma solução de pagamento personalizada, se você não for uma grande empresa (como uma startup ou uma pequena empresa). Você também criará uma integração com a Stripe que poderá testar antes de entrar em operação. Se tiver alguma dúvida sobre o processo de migração ou integração com a Stripe, consulte o Suporte. Se ainda não o fez, consulte os preços da Stripe.

Antes de começar

As empresas devem solicitar suporte à equipe de migração de dados da Stripe antes de migrar.
Se você precisar transferir informações confidenciais de pagamento, deverá preencher uma solicitação de migração de dados antes de migrar. Podemos ajudá-lo a fazer isso de forma segura e compatível com o PCI.

Revise os recursos de integração da Stripe

A Stripe simplifica seus requisitos de segurança para que os clientes não precisem sair do site para concluir um pagamento. Isso é feito por meio de uma combinação de etapas do lado do cliente e do lado do servidor:

Quando o cliente acessa o seu site em um navegador, a Stripe coleta os dados de pagamento com segurança.
A Stripe responde com um token representativo.
O navegador envia o token ao seu servidor, junto com outros dados do formulário.
O código no lado do servidor usa esse token em uma solicitação de API (por exemplo, ao criar uma cobrança).

Essa abordagem simplifica o fluxo de checkout do seu site, enquanto dados de pagamento sigilosos jamais passam pelo seu servidor. Isso permite operar de acordo com regulamentos de conformidade de PCI, o que pode economizar tempo e fornecer benefícios financeiros.

Fluxo de processo de pagamento da Stripe

Em comparação com outros processadores de pagamentos, a integração da Stripe pode apresentar algumas diferenças:

Seu cliente nunca sai do seu site.
O token criação não está vinculado a um produto ou valor específico.
Não há necessidade de criar uma chave sob demanda no lado do cliente. Em vez disso, use uma chave de API definida e publicável.

Crie uma conta Stripe

Antes de integrar com a Stripe, você deve criar uma conta Stripe.

Crie uma conta informando seu endereço de e-mail, nome completo, país e criando uma senha.
Preencha o perfil da sua empresa.
No Dashboard, clique em Verificar seu e-mail. A Stripe envia um e-mail de verificação para o seu endereço de e-mail.
Verifique o seu endereço de e-mail

Crie uma integração Stripe

Para todos os tokens de cliente novos (não importados), implemente o seguinte:

Para armazenar os dados do cartão de forma segura, utilize objetos Customer.
Recolha e tokenize os dados do cartão do cliente com uma de nossas integrações recomendadas de pagamentos. Crie sua integração Stripe antes de pedir ao seu processador de pagamentos para transferir dados para a Stripe. Para a maioria das startups, recomendamos criar uma integração Checkout incorporado, um formulário de pagamento que você incorpora ao seu site.
Para configurar essa integração, consulte o Guia rápido do checkout incorporado e aceite pagamentos únicos e assinaturas (se aplicável).
Crie cobranças para esses novos clientes.

Com essa abordagem, você pode aceitar pagamentos de novos clientes no Stripe sem afetar os clientes atuais do processador atual durante o processo de migração.

Considerações sobre a integração

A maneira mais eficiente de gerenciar dados importados é criar a integração antes de solicitar que o processador de pagamentos transfira dados para a Stripe. Algumas ações que você pode tomar antes de solicitar uma importação incluem:

Remapeie os registros de clientes
Proteja as atualizações das formas de pagamento salvas durante a migração.
Habilite todas as otimizações, como Adaptive Acceptance, atualizador de cartões (CAU) e tokens de rede.

OpcionalMapeie os clientes para IDs da Stripe

Se preferir, você pode configurar sua integração para importar os dados da forma de pagamento de registros anteriores para objetos Customer existentes da Stripe. Isso evita que a migração crie um novo objeto Customer (possivelmente duplicado) na sua conta Stripe para cada ID de cliente exclusivo nos arquivos recebidos do seu processador anterior.

Após a migração, talvez ainda seja necessário atualizar alguns registros para corresponder ao novo identificador Customer da Stripe se:

Você criou o Customer da Stripe antes da migração, e então importamos as informações de pagamento para atualizar esse registro de Customer.
Importamos as informações de pagamento como um novo registro de Customer.

Por exemplo, a cliente jenny.rosen@example.com pode ter o ID 42 no seu banco de dados, correspondente ao ID 1893 no sistema do seu processador anterior, mas é o ID cus_12345 na sua conta Stripe. Nesse caso, agora você deve mapear seu ID 42 para o ID Stripe cus_12345 no seu banco de dados. A Stripe fornece um arquivo de mapeamento pós-importação para ajudar a identificar o remapeamento necessário.

OpcionalProteja as atualizações das formas de pagamento salvas

Se os clientes atualizarem os dados de pagamento com o processador anterior na janela entre a transferência dos dados e a conclusão da importação, essas alterações serão perdidas.

Atualize o processo do seu site para lidar com alterações em pagamentos armazenados e evitar erros ou problemas de faturamento para seus clientes. Isso inclui a preparação para realizar uma migração manual para qualquer cliente sem um ID de Customer da Stripe armazenado.

Crie um objeto Customer na Stripe para o seu cliente.
Anexe a forma de pagamento ao objeto Customer.
Se necessário, migre assinaturas.

Após a conclusão da migração, a Stripe gerencia automaticamente atualizações acionadas por cartão, como alterações de data de validade.

Teste sua integração Stripe

Para testar a integração do seu formulário de pagamento integrado:

Crie uma Checkout Session integrada e incorpore o formulário de pagamento à sua página.
Preencha os dados de pagamento com um método da tabela abaixo.
- Insira qualquer data futura para a validade do cartão.
- Insira qualquer número de 3 dígitos para o CVC.
- Insira qualquer código postal de faturamento.
Clique em Pagar. Você será redirecionado para o seu return_url.
Acesse o Dashboard e procure o pagamento na página de Transações. Se o pagamento tiver sido realizado com sucesso, ele aparecerá nessa lista.
Clique no pagamento para ver mais detalhes, como um resumo do Checkout com as informações de faturamento e a lista de itens comprados. Você pode usar essas informações para executar o pedido.

Saiba mais sobre como testar sua integração.

Número do cartão	Cenário	Como testar
	O pagamento com cartão é bem-sucedido e não precisa de autenticação.	Preencha o formulário do cartão de crédito usando o número do cartão de crédito com qualquer validade, CVC e código postal.
	O pagamento com cartão precisa de autenticação.	Preencha o formulário do cartão de crédito usando o número do cartão de crédito com qualquer validade, CVC e código postal.
	O cartão é recusado com um código de recusa como `insufficient_funds`.	Preencha o formulário do cartão de crédito usando o número do cartão de crédito com qualquer validade, CVC e código postal.
	O cartão UnionPay tem um comprimento variável de 13 a 19 dígitos.	Preencha o formulário do cartão de crédito usando o número do cartão de crédito com qualquer validade, CVC e código postal.

Consulte Testes para obter mais informações sobre como testar sua integração.

Solicite e confirme os detalhes da migração

Após concluir a integração e estiver pronto para processar pagamentos na Stripe, solicite seus dados de pagamento do processador anterior. Muitos processadores exigem que o proprietário da conta solicite uma transferência de dados.
Faça login na sua conta Stripe para enviar o formulário de solicitação de migração para solicitar a migração da sua importação.
Interaja com a Stripe por meio da sequência de e-mails autenticada que criamos após o recebimento da sua solicitação de migração.

Aviso

Nunca envie dados sigilosos de cartão de crédito ou de clientes diretamente à Stripe. Se tiver esses dados, informe-nos no formulário de solicitação de migração para que possamos ajudar você a transferir seus dados com segurança.

A Stripe pode importar as informações de endereço de faturamento e detalhes de pagamento dos seus clientes. Você também pode:

Migrar tipos de pagamento específicos
Migrar assinaturas ou importá-las usando o Kit de ferramentas de migração de faturamento.

Seu operador anterior pode levar alguns dias ou várias semanas para transferir os dados finais para a Stripe. Permita esse tempo de transição em seu plano de migração. Depois que seu operador anterior transferir seus dados, a Stripe analisará os dados e identificará quaisquer problemas com a importação. Trabalhamos com você e seu operador anterior para corrigir quaisquer problemas. Em seguida, compartilhamos um resumo da importação para sua análise final e aprovação.

Após a sua aprovação, a Stripe importa os dados para sua conta. Criamos um Customer para cada cliente no arquivo de dados transferido e criamos e vinculamos os cartões do cliente como objetos Card ou Payment Method. Se os dados transferidos especificarem o cartão padrão do cliente, ele será definido como forma de pagamento padrão do cliente para cobranças e pagamentos de assinaturas.

Se sua conta Stripe já tiver acumulado um grande volume de registros de clientes no momento da migração, considere mapear os dados importados para objetos Customer existentes da Stripe, em vez de criar novos objetos Customer.

Normalmente, a Stripe importa dados até 10 dias úteis após o recebimento dos dados corretos do seu processador anterior, junto com quaisquer arquivos de dados adicionais que você queira compartilhar com a nossa equipe.

Atualizar sua integração

Depois de concluir a importação, a Stripe envia a você uma escolha de um arquivo CSV ou JSON que mostra a relação mapeada entre os IDs do seu processador atual e os IDs dos objetos Stripe importados. Analise esse arquivo de mapeamento e atualize seu banco de dados de acordo. Verifique se a integração processou todas as atualizações de cartão ocorridas durante a transição.

Arquivo de mapeamento pós-importação

Depois de atualizar sua integração com este arquivo de mapeamento, você pode começar a cobrar todos os seus clientes no Stripe.

{
  "1893": {
    "cards": {
      "2600": {
        "id": "card_2222222222",
        "fingerprint": "x9yW1WE4nLvl6zjg",
        "last4": "4242",
        "exp_month": 1,
        "exp_year": 2020,
        "brand": "Visa"
      },
      "3520": {
        "id": "card_3333333333",
        "fingerprint": "nZnMWbJBurX3VHIN",
        "last4": "0341",
        "exp_month": 6,
        "exp_year": 2021,
        "brand": "Mastercard"
      }
    },
    "id": "cus_abc123def456"
  }
}

O exemplo de mapeamento JSON acima mostra:

Cliente importado com ID 1893 como um novo Customer da Stripe com ID cus_abc123def456.
ID de cartão do cliente 2600 importado como um novo cartão Stripe com ID card_2222222222.
ID de cartão do cliente 3520 importado como um novo cartão Stripe com ID card_3333333333.

A Stripe pode importar dados de cartão como PaymentMethods em vez de objetos Card, se você especificar isso na sua solicitação de migração. Os exemplos a seguir mostram os arquivos de mapeamento para diferentes tipos de importação de informações de pagamento.

old_customer_id,customer_id,old_card_id,card_id,card_fingerprint,card_last4,card_exp_month,card_exp_year,card_brand
old_cus_100,cus_abc123def456,old_src_100,card_2222222222,x9yW1WE4nLvl6zjg,424242,09,2024,Visa

Monitore seus pagamentos importados

Após a migração, monitore o desempenho dos seus pagamentos para verificar se a taxa de aceitação dos dados de pagamento importados corresponde às suas expectativas.

A aceitação de pagamentos (ou taxa de autorização do emissor) é a porcentagem de transações que os emissores autorizam corretamente de todas as transações enviadas para pagamento. Essa métrica exclui transações bloqueadas (por exemplo, devido a regras do Radar) porque elas nunca são enviadas para autorização.

Tanto na abordagem geral quanto após a migração, alinhe suas metas de otimização da autorização de pagamento com seus objetivos comerciais. Por exemplo, uma empresa de produtos digitais com baixo custo unitário pode definir seu nível de risco para bloquear menos pagamentos. Considere os possíveis efeitos:

Aumento das taxas de conversão devido à redução do atrito.
Maior exposição a fraudes devido ao recebimento de pagamentos mais arriscados.
Redução nas autorizações brutas do emissor devido a bloqueios de modelo de fraude pelo emissor.

Certifique-se de fornecer dados precisos (como nome do titular do cartão, endereço de faturamento e e-mail). Refletir a intenção do titular do cartão maximiza o potencial de autorização bem-sucedida.

Identifique os cartões cadastrados

As migrações de dados de pagamento envolvem cartões cadastrados (cartões salvos para um pagamento futuro iniciado pelo comerciante ou fora da sessão para o mesmo cliente). Armazene dados de pagamento importados e rotule os pagamentos usando os cartões cadastrados com o parâmetro off_session correto. Se você identificar indevidamente os cartões cadastrados:

Os emissores que não conseguem confirmar o consentimento de um titular de cartão para pagamentos futuros ou recorrentes podem recusá-los.
Os dados de pagamento podem não estar qualificados para determinados produtos de otimização de Stripe, como atualizador de cartões (CAU) e tokens de rede (NT).

Monitore os motivos de recusa para encontrar oportunidades de otimização

Após a migração, os motivos de recusa do emissor podem ajudar a identificar se os dados de pagamento migrados estão fazendo transações conforme o esperado. Picos em determinados tipos de recusas podem se beneficiar dos seguintes produtos de otimização:

Atualizador de cartões: as parcerias da Stripe com as bandeiras de cartão permitem obter atualizações automaticamente para cartões expirados ou substituídos, tanto em tempo real quanto em segundo plano.
Tentativas automáticas (cobrança): tenha cuidado, pois novas tentativas de vários cartões (como após uma migração) podem parecer suspeitas para os emissores. Se você usa o Smart Retries da Stripe para pagamentos de cobrança, nosso modelo de IA analisa o código de recusa, as atualizações de forma de pagamento e a atividade de limite de risco bancário para tentar novamente os pagamentos de receita recorrente de forma mais estratégica.
Tokens de rede: Substitua um número de conta de pagamento (PAN) específico por um token seguro da bandeira do cartão para garantir que atualizações de PAN (como renovação ou substituição) reflitam automaticamente no token.
Adaptive Acceptance: a Stripe usa IA para avaliar o efeito de pequenos ajustes (como formatação) em uma solicitação de autorização em tempo real. Em seguida, refina a nova tentativa de pagamento antes de retornar a recusa original ao cliente.
Contato com os clientes: Pedir para o cliente fazer login e reinserir ou verificar novamente os dados de pagamento frequentemente restabelece a confiabilidade da sua empresa com o cliente e os provedores de pagamento. Considere notificar os clientes por outros canais que não e-mail, como mensagens de texto ou notificações no aplicativo.

A tabela a seguir mostra quais produtos de otimização oferecem melhoria para diversos motivos de recusa.

Os códigos de recusa podem incluir	Efeito da migração	Faça	Não faça
`incorrect_number` `invalid_number` `expired_card`	Atualizações nos dados do cartão durante o intervalo de migração natural podem fazer com que os dados do cartão salvos fiquem desatualizados.	Atualizador de cartões Tokens de rede Adaptive Acceptance Entrar em contato com o cliente	Tentar novamente
`generic_decline` `do_not_honor`	Alterações na descrição no extrato ou em outros marcadores de identificação podem acionar modelos de risco do emissor ou confundir o cliente.	Tentar novamente Tokens de rede Adaptive Acceptance Entrar em contato com o cliente	Atualizador de cartões
`transaction_not_allowed` `try_again_later` `authentication_required` `incorrect_cvc`	Alguns dados de pagamento migrados podem não ter detalhes iniciais de validação do cartão, como o token de rede ou o ID da transação original.	Atualizador de cartões Tentar novamente Adaptive Acceptance Entrar em contato com o cliente	Tokens de rede
`lost_card` `stolen_card` `invalid_account` `pickup_card` `card_not_supported`	Os clientes podem relatar perda ou roubo de cartões durante um atraso de migração. Fique atento a um evento especial da CONTAC em conjunto com essas recusas.	Tokens de rede Entrar em contato com o cliente	Atualizador de cartões Tentar novamente¹ Adaptive Acceptance

¹ Tentar novamente dados de pagamento perdidos ou roubados pode parecer suspeito para os emissores de cartão.

OpcionalMigrar assinaturas

As migrações que envolvem assinaturas normalmente envolvem estas etapas:

Configure sua integração do Billing.
Migrar os dados do seu cliente e do processador de pagamentos.
Importar suas assinaturas para o Stripe Billing.
Você pode importar assinaturas existentes usando a API de assinaturas ou o kit de ferramentas de migração de faturamento do Dashboard.
Após deixar seu processador de pagamentos, confirme se ele cancelou toda a cobrança automática dos seus clientes.

Chave PGP de migração

Se não estiver familiarizado com o PGP, consulte GPG e comece importando uma chave pública. Depois de se familiarizar com os conceitos básicos do PGP, use a chave PGP a seguir para criptografar dados confidenciais (como informações de cartão de crédito) para fazer uma migração compatível com PCI.

Chave de migração PGP

Isso cria FILENAME.gpg com as seguintes informações:

ID da chave: 9C78B7620C1E99AD
Tipo de chave: RSA
Tamanho da chave: 4096 bits
Impressão digital: AEBF 7C48 38C4 4D2F DC99 A3F9 9C78 B762 0C1E 99AD
ID do usuário: Stripe Import Key (PCI) <support-migrations@stripe.com>

Depois de importar nossa chave, você pode criptografar os arquivos a serem enviados executando este comando no prompt da linha de comando:

gpg --encrypt --recipient 9C78B7620C1E99AD FILENAME

Para obter mais detalhes sobre como fornecer dados criptografados à Stripe, consulte Carregar dados suplementares.