Migração ou importação de assinaturas únicas (transações)

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

Ao importar assinaturas de pagamento único para o MemberPress, você somente precisa importar um arquivo CSV de transações.

Este documento explica como migrar transações (ou assinaturas únicas) de outra solução de associação (plug-in ou plataforma) para o MemberPress.

Observação: O arquivo CSV de assinaturas não deve ser importado para assinaturas únicas. 

Requisitos de migração

Antes de migrar as transações, você precisará se certificar de que atende a todos os requisitos:

• Você criou suas assinaturas no MemberPress, que serão associadas às transações importadas (pagamentos únicos);
• Você migrou todos os seus usuários para o seu novo site do WordPress (Painel > Usuários);
• Você confirmou que as transações em seu processador de pagamentos (Listrado, PayPal, Quadrado, ou Authorize.net) pertencem a assinaturas não recorrentes (pagamentos únicos).

Observação: Todas as transações dos usuários já devem estar registradas no seu processador de pagamentos, tendo sido iniciadas pela solução de assinaturas que você utilizava anteriormente. A importação de transações apenas adicionará os dados das transações já existentes no seu processador de pagamentos ao MemberPress. A importação não criará nenhuma transação no seu processador de pagamentos nem gerará novas cobranças.

Formato CSV das transações

Tenha o máximo de cuidado para seguir EXATAMENTE a formatação listada abaixo. Caso não o faça EXATAMENTE vontade isso fará com que seu arquivo não seja importado corretamente. Se você omitir a coluna `expires_at`, a transação assumirá a data de validade padrão da assinatura. Uma célula vazia nessa coluna funciona da mesma maneira. Por exemplo, uma assinatura mensal expira um mês após a data `created_at`. Os usuários só têm acesso vitalício se a própria assinatura não tiver data de validade.

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 (mas não ambos) - 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 o 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.
• quantidade - 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".

Colunas opcionais:

• id - Atualiza as informações da transação para a transação existente que corresponde ao ID. Se for deixado em branco, isso criará um novo 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. (Observação: você não precisará usar esse cabeçalho de coluna)
• método_de_pagamento ou gateway_id - O ID exclusivo do método de pagamento. Isso pode ser encontrado na seção guia de pagamentos da página de configurações do MemberPress. O padrão é ‘manual’. Se você estiver importando membros da versão gratuita, também pode definir essa opção como ‘gratuita’.
• 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 sequência curta de texto. 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 é utilizado atualmente no MemberPress. O valor padrão é ‘standard’.
• status — O status da transação. Pode ser ‘pendente’, ‘concluída’, ‘reembolsada’ ou ‘falha’. O valor padrão é ‘concluída’.
• 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 é o tempo de expiração regular da associação. Use 0000-00-00 00:00:00 para acesso vitalício. 

Observação: Use o expires_at coluna em que uma transação deve terminar em uma data diferente da data de vencimento normal da assinatura. Por exemplo, use-a para um assinante que já tenha pago até uma data específica.

Para importar membros que cancelaram, mas pagaram até uma data específica, importe cada um deles como uma transação concluída. Defina expires_at até a data de vencimento do pagamento. Esses membros mantêm o acesso até essa data. Até lá, eles não podem adquirir a mesma assinatura novamente. Para permitir isso, ative Permitir que os usuários criem várias assinaturas ativas para este produto de assinatura no Permissões A guia MemberPress envia lembretes de vencimento para essas transações. A MemberPress não envia lembretes de renovação, pois essas transações não possuem assinatura.

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.