Migração ou importação de assinaturas recorrentes automáticas

Antes de ler esta página, certifique-se de ter revisado nosso  Visão geral da migração página primeiro!

Quando importar assinaturas recorrentes

Visão geral do vídeo

Observe que os vídeos nesta página mostram a antiga ID do Stripe que usaríamos para assinaturas (cus_xxxxxxxxxxxxxxx). Os IDs corretos que você deve usar agora para todas as importações futuras são os IDs de assinatura (sub_xxxxxxxxxxxxxxx).

Instruções gerais

Você deve SOMENTE importar assinaturas recorrentes pelos seguintes motivos:

1. Você está migrando perfis recorrentes automatizados (para PayPal, Authorize.Net ARB ou Stripe) de outro sistema 
2. Você precisa importar manualmente uma assinatura que não foi adicionada corretamente ao MemberPress devido a uma falha no gateway.

Isso significa que quaisquer assinaturas recorrentes que você esteja importando DEVE sejam assinaturas reais e ativas encontradas atualmente em seu processador de gateway (PayPal, Authorize.Net ARB ou Stripe). A importação NÃO cria e NÃO PODE criar assinaturas ou iniciar cobranças reais. A importação é usada para simplesmente adicionar dados existentes. 

Observação importante: Antes de importar os arquivos descritos, você precisará se certificar de que criou primeiro as associações no MemberPress às quais essas assinaturas serão associadas E que os usuários aos quais eles serão atribuídos podem ser encontrados na seção Painel do WordPress > Usuários. 

Para importar Recurring Subscriptions, você precisará importar dois separados CSV na seguinte ordem:

1. Arquivo CSV de assinaturas
2. Arquivo CSV de transações (se você não precisar importar um grande lote de transações, observe que pode ser mais fácil e rápido criar apenas transações manuais para a(s) assinatura(s) que você importar - não é possível criar assinaturas manualmente).

Tenha o máximo de cuidado para seguir EXATAMENTE a formatação listada abaixo. Caso não o faça EXATAMENTE vontade resultará em falha na importação correta do seu arquivo. 

Voltar ao topo

Formato de arquivo CSV das assinaturas

Clique aqui para ver um exemplo de arquivo CSV de assinaturas. Com esse modelo básico, veja abaixo as colunas obrigatórias e opcionais de seu arquivo CSV.

Instruções em vídeo

Observe que os vídeos nesta página mostram a antiga ID do Stripe que usaríamos para assinaturas (cus_xxxxxxxxxxxxxxx). Os IDs corretos que você deve usar agora para todas as importações futuras são os IDs de assinatura (sub_xxxxxxxxxxxxxxx).

Colunas obrigatórias:

• nome de usuário OU e-mail - Você pode inserir "nome de usuário" OU "e-mail" para o cabeçalho da coluna (NÃO há suporte para ambos em um arquivo). Se usar "username" (nome de usuário), use o nome de usuário do usuário que deve ser associado à transação. Se usar "e-mail", digite o e-mail do usuário. Sua seleção deve pertencer a um usuário já existente no banco de dados. (Observação: Desde a versão 1.6.8 do MemberPress Importer, você também pode usar user_email em vez de nome de e-mail)
• product_id - O ID da associação para a qual essa assinatura se destina. Deve ser o ID de uma associação já existente no banco de dados.
• sub_num ou subscr_id - O número da assinatura que faz referência à assinatura. Observação: Para o Stripe, usamos o ID da assinatura para o sub_num (sub_xxxxxxxxxxxx). Para o PayPal, o ID do perfil (I-xxxxxxxxxxxx).
• quantidade ou price - Preço da associação. Pode ser qualquer número em um formato decimal sem um símbolo de moeda - por exemplo, 5,99
• total - Preço incluindo imposto (se houver). total = (amount + tax_amount). Se não houver imposto, isso deve ser definido com o mesmo valor do campo "amount".
• period - Número de semanas, meses ou anos. Pode ser qualquer número inteiro válido se period_type='months' ou period_type='weeks', mas qualquer outra coisa, só pode ser 1.
• period_type - Esse é o tipo de período. Pode ser "semanas", "meses", "anos" ou "vida útil".
• método_de_pagamento ou gateway - O ID exclusivo do método de pagamento. Isso pode ser encontrado na seção guia de pagamentos da página Configurações do MemberPress. Isso deve fazer referência ao gateway real em que o perfil recorrente do cliente existe. Portanto, se estiver usando o PayPal Express Checkout, por exemplo, certifique-se de que o ID desse gateway seja definido aqui.

Colunas opcionais:

• id - Atualiza as informações de assinatura da assinatura existente que corresponde ao id. Se for deixado em branco, isso criará um novo assinatura. Certifique-se de usar o id da coluna "Id" na página MemberPress > Subscriptions (Assinaturas), conforme mostrado aqui. Esse campo requer o MemberPress Importer versão 1.6.0 ou mais recente.
• trial - Define se a associação tem ou não um período de teste. Pode ser 1 para verdadeiro ou 0 para falso. O padrão é 0.
• trial_days - Número de dias que o teste durará. Pode ser qualquer número inteiro. O padrão é 0.
• trial_amount - O valor que será cobrado para iniciar o teste. Pode ser qualquer número em um formato decimal sem um símbolo de moeda - por exemplo, 5,99
• limit_cycles - Se deve ou não limitar o número de ciclos de pagamento. Deve ser 1 para sim ou 0 para não. O padrão é 0.
• limit_cycles_num - O número de ciclos de pagamento regulares antes que a assinatura seja cancelada. Isso não inclui o pagamento do período de avaliação. Se limit_cycles for definido como 0 ou deixado em branco, essa configuração não terá efeito. Pode ser qualquer número maior ou igual a 1. O padrão é 2.
• limit_cycles_action - O que fazer depois que a assinatura for cancelada. Pode ser definido como "expire" ou "lifetime". O padrão é "expirar".
• prorated_trial - Se o período de avaliação foi rateado como parte de um upgrade ou downgrade. Deve ser 1 para sim ou 0 para não. O padrão é 0.
• status - O status da assinatura. Pode ser "pendente", "ativa" ou "cancelada". O padrão é "ativo".
• started_at ou created_at - A data em que a assinatura foi iniciada. Deve estar no formato "AAAA-MM-DD hh:mm:ss". O padrão é a hora atual. OBSERVAÇÃO IMPORTANTE: Para assinaturas mensais, é importante que isso seja definido para o mesmo dia do mês em que a cobrança está ocorrendo no momento. Portanto, se a assinatura for cobrada no dia 12 de cada mês, certifique-se de que esse também seja o dia 12 do mês. Caso contrário, as datas de vencimento de sua transação estarão incorretas nas renovações após a importação.
• coupon_code - O código do cupom aplicado a essa transação. Deve fazer referência a um cupom que já exista no banco de dados. O padrão é em branco.
• tax_rate - A taxa de imposto em %. Exemplo: 5% deve ser inserido como 5.000. O padrão é 0.
• tax_amount - O valor do imposto aplicado ao total. tax_amount = (amount*(tax_rate/100)). O padrão é 0.
• tax_desc - A descrição do imposto. O padrão é sem descrição.
• tax_class - Não é usado no MemberPress atualmente. O padrão é "standard".
• cc_last4 - Os últimos 4 dígitos do cartão de crédito usado para comprar a assinatura. Não é compatível com todos os gateways.
• cc_exp_month - O mês (1-12) em que o cartão de crédito usado para comprar essa assinatura expira. Não é compatível com todos os gateways.
• cc_exp_year - O ano (20xx) em que o cartão de crédito usado para comprar essa assinatura expira. Não é compatível com todos os gateways.

Observe que não é possível usar o mesmo arquivo CSV para importar assinaturas e transações ao mesmo tempo. Eles devem ser importados separadamente.

Voltar ao topo

Formato CSV das transações

Instruções em vídeo

Observe que os vídeos nesta página mostram a antiga ID do Stripe que usaríamos para assinaturas (cus_xxxxxxxxxxxxxxx). Os IDs corretos que você deve usar agora para todas as importações futuras são os IDs de assinatura (sub_xxxxxxxxxxxxxxx).

Tenha o máximo de cuidado para seguir EXATAMENTE a formatação listada abaixo. Caso não o faça EXATAMENTE vontade resultará em falha na importação correta do seu arquivo. 

Clique aqui para ver um exemplo de arquivo CSV de transações. Com isso como modelo básico, veja abaixo as colunas obrigatórias e opcionais do arquivo CSV.

Colunas obrigatórias:

• nome de usuário ou e-mail - O nome de usuário ou endereço de e-mail do usuário que deve ser associado à transação. Deve pertencer a um usuário já existente no banco de dados. (Observação: Desde a versão 1.6.8 do MemberPress Importer, você também pode usar user_email em vez de nome de e-mail)
• product_id - O ID da associação para a qual essa transação se destina. Deve ser a ID de uma associação já existente no banco de dados. O ID pode ser encontrado no URL ao editar a associação. Por exemplo, o ID da associação neste URL: http://awesomesite.com/wp-admin/post.php?post=10&action=edit é 10.
• valor - Preço da associação. Pode ser qualquer número em um formato decimal sem um símbolo de moeda - por exemplo, 5,99.
• total - Preço incluindo imposto (se houver). total = (amount + tax_amount). Se não houver imposto, isso deve ser definido com o mesmo valor do campo "amount".
• sub_num ou subscr_id - essa coluna não é obrigatória mas é necessário para fazer referência a uma transação para a assinatura importada no Importação de CSV de assinaturas. Veja abaixo.

Colunas opcionais:

• id - Atualiza as informações da transação para a transação existente que corresponde ao id. Se for deixado em branco, será criada uma nova transação. Certifique-se de usar o id da coluna "Id" na página MemberPress > Transactions (MemberPress > Transações), conforme mostrado aqui. Esse campo requer o MemberPress Importer versão 1.6.0 ou mais recente.
• sub_num ou subscr_id - O número da assinatura que faz referência à assinatura. Esse sub_num deve fazer referência a uma assinatura já existente no banco de dados. O padrão é em branco.
• método_de_pagamento ou gateway_id - O ID exclusivo do método de pagamento. Pode ser encontrado na guia de pagamentos da página Configurações do MemberPress. O padrão é "manual". Se estiver importando membros Free, você também pode definir isso como "free".
• código do cupom ou cupom - O código do cupom aplicado a essa transação. Deve fazer referência a um cupom que já exista no banco de dados. O padrão é em branco.
• send_welcome - Controla se o usuário receberá um e-mail de boas-vindas junto com essa transação recém-criada. Pode ser 1 para verdadeiro ou 0 para falso. O padrão é 0.
• send_receipt - Controla se o usuário receberá um e-mail de recibo junto com essa transação recém-criada. Pode ser 1 para verdadeiro ou 0 para falso. O padrão é 0.
• trans_num - O número da transação do gateway. Pode ser qualquer cadeia de texto pequena. Se estiver em branco, será gerado um ID aleatório.
• tax_rate - A taxa de imposto em %. Exemplo: 5% deve ser inserido como 5.000. O padrão é 0.
• tax_amount - O valor do imposto aplicado ao total. tax_amount = (amount*(tax_rate/100)). O padrão é 0.
• tax_desc - A descrição do imposto. O padrão é sem descrição.
• tax_class - Não é usado no MemberPress atualmente. O padrão é "standard".
• status - O status da transação. Pode ser "pendente", "completo" ou "reembolsado". O padrão é "completo".
• created_at - A data em que essa transação foi criada. Deve estar no formato "AAAA-MM-DD hh:mm:ss". O padrão é a data atual.
• expires_at - A data de expiração da transação. Quando uma transação expira, ela deve ser renovada pelo usuário para que ele continue a ter acesso. Deve estar no formato "AAAA-MM-DD hh:mm:ss". O padrão são as regras de expiração regulares da associação, se deixadas em branco. Para acesso vitalício, use 0000-00-00 00:00:00 como a data expires_at. OBSERVAÇÃO IMPORTANTE: Se não quiser que o usuário tenha acesso vitalício com base nessa importação, você tem que adicione uma data de expiração por meio dessa coluna.

Mensagens do importador

Depois de importar o arquivo, o importador mostrará algumas linhas e caixas diferentes para que você saiba como foi a importação. Abaixo estão descritas essas informações.

X linhas importadas com sucesso - Aqui, o importador informará quantas linhas (no lugar de X) foram importadas com sucesso.

X Linhas não puderam ser importadas - Aqui, o importador informará quantas linhas (no lugar de X) não foram importadas.

X Total de linhas processadas - Aqui, o importador informará quantas linhas totais (no lugar de X) foram processadas.

Mensagens de sucesso da linha: - Nessa caixa, você verá todas as mensagens de sucesso relacionadas à sua importação mais recente. 

Erros de linha: - Nessa caixa, você verá os erros relacionados a qualquer linha da importação mais recente. A mensagem deve ser detalhada o suficiente para que você saiba o que precisa corrigir, para que o arquivo funcione corretamente na importação. 

CSV para linhas com falha... copie-os, corrija-os e reimporte-os: - Aqui, você receberá as linhas exatas que precisam ser corrigidas. Anote-as para corrigir as linhas com erros. 

Voltar ao topo