Stripe integration
Um conjunto de APIs que potencializa o comércio para empresas de todos os tamanhos.
O Stripe torna fácil começar a aceitar cartões de crédito na web hoje mesmo. O método de integração usa nosso plugin integrado para controle de notificações.
A integração também lida com pedidos, pedidos recorrentes e reembolsos. Ela também suporta comissões vitalícias e controle de cupons.
Dados de cookies – formulário de pedido
Cada conta de cliente na Stripe possui um campo extra chamado “descrição“. Neste método de integração, estamos usando ele. A tarefa é adicionar o valor do cookie (rastreamento) no campo de descrição encontrado em seu formulário de pedido. A maneira mais fácil é adicionar este código ao seu formulário de pagamento:
<input type="hidden" name="pap_custom" value="" id="pap_tdx8v2s5a" />
<script id="pap_x2s6df8d" src="https://URL_TO_PostAffiliatePro/scripts/trackjs.js" type="text/javascript"></script>
<script type="text/javascript">
PostAffTracker.writeCookieToCustomField('pap_tdx8v2s5a');
</script>
Quando o formulário é enviado (o cliente está fazendo o pedido), você pode processar os dados do formulário da maneira padrão e antes de criar uma cobrança e uma conta de cliente (com Stripe_Customer::create), você deve usar os dados pap_custom do formulário enviado e definir o valor como uma descrição do cliente – “description” => $_POST[‘pap_custom’].
Dados de cookies – Checkout da Stripe
Se você estiver usando o Stripe Checkout, em vez da etapa acima, você precisará faça esse. Essencialmente, o que precisa ser feito é adicionar um valor de cookie de rastreamento à variável client-reference-id do objeto de sessão do Stripe. Dê uma olhada aqui em como obter o valor do cookie de rastreamento (ID do visitante).
Aqui está um exemplo de botão Stripe Checkout:
<script async src="https://js.stripe.com/v3/buy-button.js">
</script>
<stripe-buy-button
buy-button-id="buy_btn_BBBBBBBBBBBBBB"
publishable-key="pk_test_XXXXXXXXXXXXXXXXXXX"
>
</stripe-buy-button>Esta é a aparência de um botão integrado (o código do botão listrado agora é adicionado usando JavaScript):
<script async src="https://js.stripe.com/v3/buy-button.js">
</script>
<script id="pap_x2s6df8d" src="https://URL_TO_PostAffiliatePro/scripts/trackjs.js" type="text/javascript"></script>
<script type="text/javascript">
var papCookie = '';
PostAffTracker.setAccountId('Account_ID');
try {
PostAffTracker.track();
} catch (err) { }
papCookie = PostAffTracker._getAccountId() + PostAffTracker._cmanager.getVisitorIdOrSaleCookieValue();
document.write('<stripe-buy-button buy-button-id="buy_btn_BBBBBBBBBBBBBB" publishable-key="pk_test_XXXXXXXXXXXXXXXXXXX" client-reference-id="' + papCookie + '"></stripe-buy-button>');
</script>Dados de cookies – Links de pagamento Stripe
Se você estiver usando links de pagamento Stripe, será necessário passar o valor do cookie de rastreamento como parâmetro de string de consulta client_reference_id para o link. Para poder fazer isso, você precisa atribuir um ID à tag <a> elemento link, então, por exemplo, você atribuiria “papCookie” como o ID do link, então seria:
<a id="papCookie" href="https://buy.stripe.com/2wM8yP31J6vF6wodQZ">Pay now</a>Depois de obter o ID, você precisa executar o comando PostAffTracker.writeCookieToLink(‘papCookie‘, ‘client_reference_id‘); função do código de rastreamento de cliques com o ID do link (em nosso exemplo papCookie) e o nome do parâmetro da string de consulta que deve ser adicionado (client_reference_id ), por exemplo assim:
<script id="pap_x2s6df8d" src="https://URL_TO_PostAffiliatePro/scripts/trackjs.js" type="text/javascript"></script>
<script type="text/javascript">
try {
PostAffTracker.setAccountId('Account_ID');
PostAffTracker.track();
PostAffTracker.writeCookieToLink('papCookie', 'client_reference_id');
} catch (err) { }
</script>Outra categoria de ferramentas de pagamento Stripe são as tabelas de preços Stripe. Ele suporta o uso de client-reference-id para que sua integração também seja possível.
Acompanhamento de vendas
O acompanhamento da venda acontecerá automaticamente, tanto para cobranças padrão quanto para cobranças recorrentes. O último passo é configurar a conta Stripe para informar seu Post Affiliate Pro sobre cada cobrança. Isso é feito pelos webhooks da Stripe.
Para definir um webhook, navegue até a seção do menu Desenvolvedores (canto superior direito) e navegue até Webhooks. Clicar em Adicionar endpoint irá revelar um formulário para adicionar um novo URL para receber webhooks. Insira este URL para notificações ao vivo:
https://URL_TO_PostAffiliatePro/plugins/Stripe/stripe.php?AccountId=Account_ID
Em caso de eventos para ouvir, você pode adicionar invoice.payment_succeeded, charge.succeeded e charge.refunded. Se você estiver usando o Checkout da Stripe, também precisará do evento checkout.session.completed.
Se você deseja rastrear pagamentos de teste, configure o mesmo webhook no modo de teste também.
Ativação do plugin
O último passo é ativar o plugin embutido no seu Post Affiliate Pro. Não se esqueça de configurá-lo após a ativação adicionando a chave de API secreta ou uma chave de API restrita. Caso você queira usar uma chave de API restrita, você precisa permitir o acesso de leitura para esses recursos: Cobranças, Assinaturas, Sessões de Checkout, Clientes e Faturas.
É isso, está feito. Todas as transações agora serão rastreadas.
Não se esqueça de integrar seu site com o código de rastreamento de cliques para que tudo funcione.
Discover the essentials of clicks (referrals) tracking with our comprehensive guide. Learn about the importance of click tracking code, explore various code examples including simple, asynchronous, and PHP versions, and dive into advanced tracking options. Optimize your affiliate marketing strategy with expert tips on setting account IDs, managing cookies, and customizing tracking parameters. Visit now to enhance your click tracking implementation!
