Una suite di API che alimenta il commercio per le imprese di tutte le dimensioni.
Stripe rende facile iniziare ad accettare carte di credito sul web. Il metodo di integrazione utilizza il nostro plugin integrato per la gestione delle notifiche.
L’integrazione gestisce anche gli ordini, gli ordini ricorrenti e i rimborsi. Supporta anche le “lifetime commissions” e la gestione dei coupon.
Dati dei cookie – modulo d’ordine
Ogni conto cliente in Stripe ha un campo extra chiamato ‘descrizione‘. In questo metodo di integrazione, lo stiamo usando. Il tuo compito è quello di aggiungere il valore del cookie (di tracciamento) nel campo descrizione che si trova nel tuo modulo d’ordine. Il modo più semplice è aggiungere questo codice al tuo modulo di 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 il modulo viene inviato (il cliente sta ordinando), puoi elaborare i dati del modulo nel modo standard e prima di creare un addebito e un conto cliente (con Stripe_Customer::create), devi usare i dati pap_custom dal modulo inviato e impostare il valore come descrizione del cliente – “description” => $_POST[‘pap_custom’].
Dati dei cookie – Checkout di Stripe
Se stai usando Stripe Checkout allora invece del passo precedente devi fare questo. Essenzialmente quello che bisogna fare è inserire nell’opzione clientReferenceId della funzione stripe.redirectToCheckout l’ID di monitoraggio che può essere ottenuto come spiegato qui.
Ecco un esempio di un pulsante di Checkout di Stripe integrato:
<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) { }
PostAffTracker.executeOnResponceFinished.push(function() {
papCookie = PostAffTracker._getAccountId() + PostAffTracker._cmanager.getVisitorIdOrSaleCookieValue();
});
</script>
<script src="https://js.stripe.com/v3"></script>
<button id="checkout-button-price_1HHyerAqrxE6mVvaZyp4HYuI" role="link" type="button">Purchase</button>
<div id="error-message"></div>
<script>
(function() {
var stripe = Stripe('pk_live_key');
var checkoutButton = document.getElementById('checkout-button-price_1HHyerAqrxE6mVvaZyp4HYuI');
checkoutButton.addEventListener('click', function () {
stripe.redirectToCheckout({
lineItems: [
{price: 'price_123', quantity: 1},
],
mode: 'payment',
successUrl: 'https://your-website.com/success',
cancelUrl: 'https://your-website.com/canceled',
clientReferenceId: papCookie
})
.then(function(result) {
.....
});
});
})();
</script>
Tracciamento delle vendite
Il monitoraggio delle vendite avverrà automaticamente, sia per gli addebiti standard che per quelli periodici. L’ultimo passaggio consiste nell’impostare il tuo account Stripe per informare il tuo account Post Affiliate Pro su ogni addebito. Questo viene fatto da Stripe webhooks.
Per impostare un webhook vai nella sezione del menu Sviluppi (in alto a destra) e poi vai su Webhooks. Cliccando su Aggiungi endpoint si apre un modulo per aggiungere un nuovo URL per ricevere i webhooks. Inserisci qui questo URL per le notifiche in tempo reale:
https://URL_TO_PostAffiliatePro/plugins/Stripe/stripe.php?AccountId=Account_ID
In caso di eventi da ascoltare puoi aggiungere invoice.payment_succeeded, charge.successful e charge.refunded. Se stai usando Stripe Checkout allora avrai anche bisogno dell’evento checkout.session.completed.
Se vuoi tracciare anche i pagamenti di prova, imposta lo stesso webhook anche nella modalità di prova.
Attivazione del plugin
L’ultimo passaggio consiste nell’attivare il plugin integrato nel tuo account Post Affiliate Pro. Non dimenticare di configurarlo dopo l’attivazione aggiungendo la Secret API key o una Restricted API key. Nel caso in cui tu voglia usare una Restricted API key, devi permettere l’accesso in lettura per queste risorse: Spese, Iscrizioni, Sessioni di checkout, Clienti e Fatture.
Ed ecco fatto, hai finito. Tutte le transazioni saranno ora tracciate.
Non dimenticarti di integrare il tuo sito con il codice di tracciamento dei clic per farlo funzionare.
