Recurly

Un’azienda basata su SaaS che si occupa della gestione delle fatture ricorrenti come servizio in outsourcing.

Questo metodo di integrazione utilizza le API di Recurly per ottenere i dettagli del piano acquistato e per registrare una commissione con i valori dell’abbonamento.

L’integrazione richiede la funzionalità Commissioni Ricorrenti per poter tracciare i pagamenti ricorrenti/ le conversioni di prova.

Configurazione di Recurly

Questo metodo di integrazione utilizza una “Pagina di ringraziamento” esterna, quindi se non ne hai una, per favore creala. Quando hai il sito, vai alla sezione Configurazione > Piani del tuo pannello di amministrazione Recurly e modifica i tuoi piani. Verso la parte inferiore della schermata di modifica del piano seleziona la casella di controllo di Conferma di Bypass di Recurly e imposta l’URL di Ritorno Dopo il Successo alla tua pagina di ringraziamento.

Aggiungi questa stringa ad ogni URL:

?account_code={{account_code}}&plan={{plan_code}}

Nel caso in cui tu abbia già un punto interrogativo nel link, modificalo nel codice di cui sopra con il simbolo della barra verticale (&).

Abilita API

Nel pannello di amministrazione di Recurly vai su Integrazioni > sezione Credenziali API abilita la tua API se non è ancora abilitata, e ottieni la tua chiave API.

Ora, vai su Integrazioni > Webhook e usa il pulsante Configura per aggiungere un nuovo Endpoint e cambia il suo URL con:

https://URL_TO_PostAffiliatePro/plugins/Recurly/recurly.php

Per scegliere specificamente un tipo di notifica, seleziona ‘notifica rinnovo_abbonamento‘ e ‘notifica nuova fattura_accredito‘.

Infine, abilita il plugin Recurly nella sezione Plugins del tuo pannello commerciante di Post Affiliate Pro e imposta lì la tua chiave API.

Codice di integrazione

Apri la tua pagina di ringraziamento per la modifica e incolla questo codice nel file:

<script id="pap_x2s6df8d" src="https://URL_TO_PostAffiliatePro/scripts/trackjs.js" type="text/javascript"></script>
<script type="text/javascript">
var $_GET = get_query();
var callBack = false;

PostAffTracker.setAccountId('Account_ID');
try {
  PostAffTracker.track();
  PostAffTracker.executeOnResponseFinished.push(function() {visitorCallBack();});
}
catch(e){}

function getVisitorId() {
	return PostAffTracker._getAccountId() + PostAffTracker._cmanager.getVisitorIdOrSaleCookieValue();
}

function visitorCallBack() {
  if (callBack == false && "null" != getVisitorId()) {
    callBack = true;
    var pixel = document.createElement("img");pixel.width=1;pixel.height=1;
    pixel.src = 'https://URL_TO_PostAffiliatePro/plugins/Recurly/recurly.php?papCookie=' + getVisitorId() + '&account_code=' + $_GET.account_code + '&plan=' + $_GET.plan;
    document.body.appendChild(pixel);
  }
}

function get_query(){
    var url = location.search;
    var qs = url.substring(url.indexOf('?') + 1).split('&');
    for(var i = 0, result = {}; i < qs.length; i++){
        qs[i] = qs[i].split('=');
        result[qs[i][0]] = decodeURIComponent(qs[i][1]);
    }
    return result;
}
</script>

Non dimenticarti di integrare il tuo sito con il codice di tracciamento dei clic.