PayWhirl integration
PayWhirl facilita o gerenciamento de pagamentos recorrentes.
A integração com o PayWhirl é feita usando um aplicativo interno do PayWhirl chamado “Scripts de rastreamento personalizados”.
Instale o aplicativo
Para começar com a integração, navegue até sua conta PayWhirl e depois para Aplicativos & Integrações. Encontre e instale um aplicativo chamado Scripts de Rastreamento Personalizados.
Uma vez instalado, você verá duas guias diferentes na página de configurações. Uma seção carregará scripts em TODAS as páginas que a PayWhirl fornecer e a outra seção apenas carregará scripts APÓS CONVERSÕES, quando as pessoas concluírem o checkout com sucesso – é isso que usaremos.
Acompanhamento de vendas
O primeiro passo é dar um nome ao seu aplicativo. Você pode nomeá-lo, por exemplo: Post Affiliate Pro
Agora, escolha a guia “Conversão” e use o seguinte código nela:
<script id="pap_x2s6df8d" src="https://URL_TO_PostAffiliatePro/scripts/trackjs.js" type="text/javascript"></script>
<script type="text/javascript">
PostAffTracker.setAccountId('Account_ID');
{% for invoice in invoices %}
papSkus = '';
{% for item in invoice.items %}
papSkus += '{{item.sku}}, ';
{% endfor %}
var sale{{ loop.index }} = PostAffTracker.createSale();
if ({{invoice.paid}}) {
sale{{ loop.index }}.setTotalCost({{ invoice.amount_due }} - {{ invoice.shipping_total }} - {{ invoice.tax_total }});
} else {
sale{{ loop.index }}.setTotalCost(0);
}
{% if invoice.subscription_id %}
sale{{ loop.index }}.setOrderID('{{ invoice.subscription_id }}');
{% else %}
sale{{ loop.index }}.setOrderID('{{ invoice.id }}');
{% endif %}
sale{{ loop.index }}.setProductID(papSkus.slice(0, -2));
sale{{ loop.index }}.setData1('{{ customer.email }}');
sale{{ loop.index }}.setCurrency('{{ invoice.currency }}');
sale{{ loop.index }}.setCoupon('{{ invoice.promo_code }}');
{% if loop.index != invoices|length %}
sale{{ loop.index }}.doNotDeleteCookies();
{% endif %}
{% endfor %}
PostAffTracker.register();
</script>
Se você rolar um pouco para baixo, verá uma lista completa de variáveis disponíveis, portanto, se você quiser personalizar o código de acompanhamento de vendas, sinta-se à vontade para fazê-lo usando as variáveis disponíveis.
Configuração do webhook
Para rastrear também pagamentos recorrentes, você precisará configurar um webhook em Desenvolvedor > Webhooks, onde será necessário criar um webhook para evento da conta charge.succeeded. Se você também deseja rastrear reembolsos, crie o webhook para charge.refunded também.
O webhook deve ser criado para o seguinte URL:
https://URL_TO_PostAffiliatePro/plugins/PayWhirl/paywhirl.php
As comissões recorrentes serão rastreadas apenas se você usar o recurso Comissões Recorrentes ou o plugin Comissões Vitalícias.
Ativação do plugin
A última etapa da integração é ativar o plugin de rastreamento em sua conta Post Affiliate Pro. Faça login no seu painel de comerciante e vá para Configuração > Plugins, onde você precisa encontrar e ativar o plugin de controle de webhook PayWhirl. Uma vez que o plugin é ativado, você pode configurá-lo para ativar/desativar o rastreamento de reembolsos e definir quais detalhes devem ser salvos nos campos de dados extras da comissão.
Não se esqueça de integrar seu site com o código de rastreamento de cliques.