Stripe

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.