ReCharge (BigCommerce) integration
A plataforma ReCharge permite adicionar produtos de assinatura recorrentes à sua loja BigCommerce. Este guia explica como integrar a ReCharge com o Post Affiliate Pro para rastrear esses pagamentos recorrentes.
A integração BigCommerce consiste em várias etapas de ambos os lados. Primeiro, você precisa criar um token de API em sua conta ReCharge e configurá-lo em sua conta Post Affiliate Pro. Em seguida, adicione um código de rastreamento à página de agradecimento da ReCharge e coloque um código de rastreamento de cliques no rodapé da sua loja BigCommerce.
Para rastrear pagamentos recorrentes, você precisa do recurso Comissões Recorrentes ou do plugin Comissões Vitalícias ativado!
Criar um token de API
Como primeiro passo, você precisará entrar em contato com a ReCharge para solicitar acesso à API. Consulte https://support.rechargepayments.com/hc/en-us/articles/360008829993-ReCharge-API-tokens para obter mais detalhes.
Depois de receber acesso à API, você pode criar seu token de API. Para fazer isso, faça login no painel de administração do Bigcommerce, vá para a seção Apps e clique em assinaturas da ReCharge para chegar ao painel ReCharge. Uma vez lá, clique na guia Integrações no menu superior e depois em tokens de API, na borda direita da página. Depois, clique em Criar um token de API.
Nomeie o token da API como quiser, adicione um e-mail onde você será notificado se o webhook estiver falhando e, o mais importante, certifique-se de adicionar Permissão de Acesso de Leitura aos Pedidos. Se você também puder ver a permissão de Webhooks, defina como Acesso de Leitura e Gravação. No entanto, isso pode ter sido removido e, portanto, não é mais necessário definir. Salve o token e copie sua chave de API.
Configurar o plugin de controle de webhook da ReCharge
O próximo passo é fazer login no painel do comerciante do Post Affiliate Pro; vá para Configuração -> Plugins e ative o plugin chamado controle de webhook da ReCharge. Assim que estiver ativo, clique no botão Configurar e adicione a chave API da Recharge na página de configuração do plugin.
Nesta página, você também pode configurar o que exatamente será rastreado como ID do produto e também pode escolher se deseja rastrear quaisquer dados adicionais do pedido nos campos de dados extras. Quando terminar, salve a configuração do plugin na parte inferior da página.
Edite sua página de agradecimento
Faça login no painel de administração do BigCommerce, vá para a seção Apps e clique em assinatura da ReCharge para acessar o painel de administração da ReCharge. Uma vez lá, clique em Configurações (ícone de chave inglesa) no canto superior direito e vá para a seção Checkout. Role para baixo até a seção Página de Agradecimento e cole o código a seguir no campo Scripts e Rastreadores adicionais:
<script id="pap_x2s6df8d" src="https://URL_TO_PostAffiliatePro/scripts/trackjs.js" type="text/javascript"></script>
<script type="text/javascript">
PostAffTracker.setAccountId('Account_ID');
var discountMultiplier = 1 - {{total_discounts}} / ({{subtotal_price}} + {{total_discounts}});
{% for item in line_items %}
var itemPrice = {{item.price}} * {{item.quantity}};
var sale{{ loop.index }} = PostAffTracker.createSale();
sale{{ loop.index }}.setTotalCost(itemPrice * discountMultiplier);
var subscriptionId = '{{item.subscription_id}}';
if (subscriptionId != '') {
sale{{ loop.index }}.setOrderID(subscriptionId);
} else {
sale{{ loop.index }}.setOrderID('{{id}}({{ loop.index }})');
}
sale{{ loop.index }}.setProductID('{{item.product_id}}');
sale{{ loop.index }}.setCoupon('{{discount_code}}');
{% endfor %}
PostAffTracker.register();
</script>
Se você deseja salvar o nome ou e-mail do cliente, pode adicionar as seguintes linhas:
sale{{ loop.index }}.setData1('{{email}}');
sale{{ loop.index }}.setData2('{{first_name}} {{last_name}}');sob a linha:
sale{{ loop.index }}.setCoupon('{{discount_code}}');Você pode encontrar mais variáveis disponíveis na base de conhecimento da ReCharge.
Rastreamento de cliques
Faça login no painel de administração do BigCommerce, vá para a seção Storefront e clique no gerenciador de scripts. Nesta seção, clique no botão Criar um Script no canto superior direito. Nomeie o script, defina o local na página para rodapé, selecione as páginas onde o script será adicionado a todas as páginas, altere o tipo de script para script e insira o código de rastreamento de cliques do painel do comerciante do Post Affiliate Pro > Ferramentas > Integração > Rastreamento de cliques no Campo de conteúdo do script e salve.
