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 associações no MemberPress, que serão associadas a transações importadas (pagamentos únicos);
• Você migrou todos os seus usuários para o novo site do WordPress (Dashboard > Users);
• 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 presentes no seu processador de pagamentos, iniciadas pela solução de associação usada anteriormente. A importação de transações apenas adicionará os dados das transações existentes de seu processador de pagamentos ao MemberPress. A importação não criará nenhuma transação em seu processador de pagamentos nem iniciará 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 resultará em falha na importação correta do seu arquivo. Observe também que, se você não adicionar uma coluna expires_at ao seu arquivo, os usuários terão acesso vitalício a partir da transação importada.

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 Configurações do MemberPress. O padrão é "manual". Se estiver importando membros Free, você também pode definir essa opção 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 sequência pequena 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 é usado no MemberPress atualmente. O padrão é "padrão".
• status - O status da transação. Pode ser "pendente", "concluída", "reembolsada" ou "falha". 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 é o tempo de expiração regular da associação. Use 0000-00-00 00:00:00 para acesso vitalício. 

Observação: O expires_at A coluna é necessária se suas assinaturas únicas tiverem duração limitada. A exclusão dessa coluna importar transações sem datas de vencimento, dar aos seus usuários acesso vitalício.

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.