Blog

mardi 28 mars 2017

Informations techniques micropaiement et affiliation

 

Dans ce tutoriel, nous allons vous expliquer comment monétiser votre contenu grâce aux solutions de micropaiement de Rentabiliweb.
Dans un premier temps, nous verrons comment installer le paiement à l’acte et le paiement CB personnalisé supérieur à 3 euros (clients premium et supérieurs).
Le deuxième temps de ce tutoriel sera d’apprendre à utiliser l’affiliation avec les formulaires de paiement Rentabiliweb.

Sommaire :

1. MICROPAIEMENT

1.1 Installation du paiement à l’Acte

Le micropaiement à l’acte Rentabiliweb est une solution de paiement sécurisée qui permet de rentabiliser votre site Internet.

Audiotel/SMS+

Vous avez à votre disposition une offre complète internationale.
Le code est dicté par téléphone par un automate vocal.
Par sms : L’utilisateur envoie un mot clé et reçoit le code en retour par sms. Chaque pays établit sa propre facturation.
Vous devez donc choisir les différents paliers que vous allez proposer à vos membres.

Carte bancaire

Nous vous proposons plusieurs paliers différents entre 1.80 et 15 euros.
Si vous désirez utiliser un palier précis supérieur à 3 euros, nous vous invitons à créer un document CB personnalisé (clients premium et prestige).

Remarque : La configuration de Mistercash est couplée à notre solution de carte bancaire.

Paramétrage

Les paramétrages disponibles sont les suivants :

  • Par accès : le code sera valide x fois ;
  • Par jour : le code sera valide pendant x jour(s) à partir de la première saisie dans le formulaire.

1.1.1 Le formulaire de paiement

L’installation du formulaire est très simple et rapide.
Le script contient tous les éléments visuels et techniques du formulaire permettant de sécuriser et rentabiliser votre accès payant.

Trois types de formulaire sont disponibles :

  • Le formulaire classique (popup) : il se présente sous la forme de drapeaux représentant chaque pays, ainsi qu’une zone pour saisir le(s) code(s).
    En cliquant sur un drapeau, l’utilisateur pourra voir les types de paiement disponibles pour son pays dans un popup.
  • Le formulaire iframe : il se compose des mêmes zones que le formulaire classique mais il n’ouvre pas de popup pour afficher les différents moyens de paiement.
    L’utilisateur voit directement le numéro à composer.
    Il intègre également une fonction de géolocalisation affichant uniquement les moyens de paiement disponibles pour le pays de l’utilisateur.
  • Le formulaire Facebook : il possède les mêmes caractéristiques que le formulaire iframe, avec un design différent puisqu’utilisé pour monétiser les applications Facebook.

Voici les paramètres nécessaires pour la validation d’un code dans le formulaire :

  • docId : l’identifiant de votre document ;
  • siteId : l’identifiant de votre site où est configuré le document ;
  • code[n] : le champ permettant à l’utilisateur de saisir le(s) code(s) pour accéder à votre partie payante (n : de 0 à 10).

Voici les paramètres optionnels :

  • noInfos : si ce paramètre est égal à 1, Rentabiliweb ne retournera aucun paramètre lors de la redirection sur la page d’erreur (code, docId, siteId, data) ;
  • data : grâce à ce paramètre, vous pourrez transmettre des informations à vos pages protégées ou à votre page d’erreur. Rentabiliweb retournera la valeur du champ data en méthode GET dans l’url de redirection ;
  • record : Ce paramètre vous permettra d’enregistrer des valeurs qui vous seront retournées dans le journal de codes.
a) Installer le formulaire de paiement

Pour installer un formulaire de paiement, il suffit simplement de faire votre choix parmi ces trois types accessibles en allant dans le menu de gauche de votre espace administrateur de votre compte Rentabiliweb, section “Micropaiement/CB”, en cliquant sur “Gestion des documents” puis sur le bouton “Installer” correspondant au document que vous désirez.

Rentabiliweb - gestion des documents

 

Rentabiliweb - Installation

Il vous suffit ensuite de copier le script correspondant au formulaire de paiement de votre choix, puis de le coller dans votre page de paiement (la page d’accès configurée dans votre document Rentabiliweb) à l’endroit souhaité.

b) Passer des valeurs supplémentaires

Vous pouvez, au travers de nos formulaires, passer des valeurs supplémentaires à votre page protégée ou à votre page d’erreur.
Pour les formulaires de type iframe ou popup, cela se pratique grâce à un champ caché. Ce champ caché aura obligatoirement le nom “data”, et portera la valeur que vous lui attribuerez.

Le code de ce champ caché :

<input type="hidden" name="data" value="ma_valeur"/>

ou bien, pour passer une variable php :

<input type="hidden" name="data" value="<?php echo $ma_variable; ?>"/>

Cette façon de procéder peut également servir pour passer les paramètres record et noInfos.

Code html pour passer le paramètre noInfos :

<input type="hidden" name="noInfos" value="1"/>

Si vous faites cela, cela implique que Rentabiliweb ne retournera aucun paramètre lors de la redirection sur la page d’erreur (code, docId, siteId, data).

Les formulaires popup et iFrame peuvent grossièrement être divisés en 2 parties. Celle permettant l’achat d’un code par un des moyens de paiement proposés, celle contenant le formulaire pour la saisie du code et l’accès au contenu protégé. C’est dans cette deuxième partie qu’il est possible d’ajouter une balise de champ caché pour faire passer un des paramètres optionnels.

Exemple pour le formulaire popup et le paramètre data (valeur)

<form id="rweb_tickets_XXXXX"  method="get" action="http://payment.rentabiliweb.com/access.php" style="margin: 0px; padding: 0px;" >
     <table width="280" cellpadding="0" cellspacing="0" style=" margin: 2px auto;">
          <tr>
	       <td style="text-align: center"><label for="code_0" style=" font-family:Arial, Helvetica, sans-serif;font-size: 12px; font-weight:bold; color:#3b5998; padding: 2px 2px 5px 2px; margin: 0px;">
                        Saisissez votre code d'accès et validez :<br/>
			<span style="font-size: 11px; font-style: italic;color:#5c5c5c;">Please enter your access code :</span></label></td>
          </tr>
          <tr>
               <td style="text-align: center">
	            <input name="code[0]" type="text" id="code_0" size="10" style="border: solid 1px #3b5998; padding: 2px; font-weight: bold; color:#3b5998; text-align: center;"/>
	            <input type="hidden" name="docId" value="XXXXX" />
		    <input type="hidden" name="data" value="ma_valeur" />
		    <input type="button"  alt="Ok" onclick="getElementById('rweb_sub_XXXXX').disabled=true;document.getElementById('rweb_tickets_XXXXX').submit();" id="rweb_sub_XXXXX"  style="width: 40px; height:20px; vertical-align:middle; margin-left: 5px; border: none; background:url(http://payment.rentabiliweb.com/data/i/component/button_ok.gif);"/></td>
          </tr>
     </table>
</form>

Exemple pour le formulaire iFrame et le paramètre data (variable php)

<form id="rweb_tickets_XXXXX" method="get" action="http://payment.rentabiliweb.com/access.php" style="margin: 0px; padding: 0px;" >
     <table width="400" cellpadding="0" cellspacing="0" style=" margin: 2px auto;">
          <tr>
               <td style="text-align: center"><label for="code_0" style=" font-family:Arial, Helvetica, sans-serif;font-size: 12px; font-weight:bold; color:#3b5998; padding: 2px; margin: 0px;">
               Saisissez votre code d'accès et validez :
	       <br/>
	       <span style="font-size: 11px; font-style: italic;color:#5c5c5c;">Please enter your access code :</span></label></td>
          </tr>
          <tr>
               <td style="text-align: center">
	            <input name="code[0]" type="text" id="code_0" size="10" style="border: solid 1px #3b5998; padding: 2px; font-weight: bold; color:#3b5998; text-align: center;"/>
		    <input type="hidden" name="docId" value="XXXXX" />
		    <input type="hidden" name="data" value="<?php echo $ma_variable;?>" />
		    <input type="button"  alt="Ok" onclick="getElementById('rweb_sub_XXXXX').disabled=true;document.getElementById('rweb_tickets_XXXXX').submit();" id="rweb_sub_XXXXX"  style="width: 40px; height:20px; vertical-align:middle; margin-left: 5px; border: none; background:url(http://payment.rentabiliweb.com/data/i/component/button_okdefault.gif);"/>
               </td>
          </tr>
     </table>
</form>

Pour le formulaire de type Facebook, la méthode pour passer une valeur supplémentaire est un peu différente. Cela se pratique en ajoutant le paramètre data dans l’URL de la source du formulaire.

Exemple pour le formulaire Facebook et le paramètre data (valeur)

<iframe src="http://payment.rentabiliweb.com/form/acte/form_fb.php?docId=xxxxx&siteId=yyyyyy&cnIso=geoip&data=ma_valeur" frameborder="0" scrolling="auto" width="580" height="400"></iframe>

Exemple pour le formulaire Facebook et le paramètre data (variable php)

<iframe src="http://payment.rentabiliweb.com/form/acte/form_fb.php?docId=xxxxx&siteId=yyyyyy&cnIso=geoip&data=<?php echo $ma_variable; ?>" frameborder="0" scrolling="auto" width="580" height="400"></iframe>

Si vous voulez passer plusieurs valeurs par ce champ caché (formulaires iFrame et popup) ou par ce paramètre (formulaire Facebook), il vous suffit de créer un tableau, de le sérialiser puis de l’encoder (en base 64 par exemple), ce qui donnerait par exemple :

$tableau = array($maVar1, $maVar2, $maVarN);
$data = serialize($tableau);
$data = base64_encode($data);

Ce champ est passé en paramètre GET, donc pour le récupérer dans votre page protégée ou votre page d’erreur, il vous suffira d’écrire :

$le_champ_a_recuperer=$_GET['data'];

Si vous avez sérialisé puis encodé un tableau de variables, il faudra écrire ceci pour récupérer votre tableau dans votre page protégée ou votre page d’erreur :

$data = base64_decode($_GET['data']);
$tableau = unserialize($data);

Vous pouvez aussi, grâce à la méthode des champs cachés, passer les variables d’affiliation. Ceci est expliqué plus bas, dans le 2. 2 Configuration et intégration des paramètres d’affiliation.

c) Code HTML et CSS

NE SURTOUT PAS MODIFIER LE CODE HTML SINON DES ERREURS PEUVENT SE PRODUIRE
Pour modifier l’apparence de votre formulaire de paiement, vous pouvez vous servir d’une feuille de style ou de modifier le style directement dans la balise souhaitée.
Pour ne pas afficher un block il vous suffit d’ajouter dans la feuille de style ou dans la balise style=’display: none;’
Pour mieux identifier les blocks vous pouvez vous servir de la web developer toolbar avec firefox disponible ici :
http://chrispederick.com/work/web-developer/
Une fois installée, vous appuyez sur les touches ctrl+shift+F et cliquez sur un block pour voir son id ou sa class.

1.1.2 La vérification du code

Rentabiliweb met à disposition un script permettant de sécuriser l’accès à vos pages payantes.
Ce script est récupérable dans la même page web que le formulaire de paiement (cf. début du a) Installer le formulaire de paiement).

Ce script de sécurisation doit impérativement être couplé à notre formulaire de paiement (sans modification du code html), sinon des erreurs peuvent se produire.
Pour obtenir de l’aide ou des conseils sur la sécurisation de votre site ou la personnalisation de votre formulaire de paiement, veuillez s’il vous plait prendre contact avec notre équipe technique.

Votre site, grâce à des langages comme PHP ou ASP, pourra interroger les serveurs Rentabiliweb pour vérifier le code de l’utilisateur.
Votre script va donc effectuer une requête HTTP.

Vous pouvez choisir le script de protection parmi deux types : Php ou Javascript.

Le script de protection en Php s’installe en le copiant à partir de la page Micropaiement » Installation de votre document. Il est à coller tout en haut du code de votre page à protéger, celle qui contient votre contenu payant.

Exemple

<?php
// Identifiants de votre document
$docId = xxxxx
$siteId = yyyyyy
// PHP5 avec register_long_arrays désactivé?
if (!isset($HTTP_GET_VARS)) {
     $HTTP_SESSION_VARS    = $_SESSION;
     $HTTP_SERVER_VARS     = $_SERVER;
     $HTTP_GET_VARS        = $_GET;
}
// Construction de la requête pour vérifier le code
$query      = 'http://payment.rentabiliweb.com/checkcode.php?';
$query     .= 'docId='.$docId;
$query     .= '&siteId='.$siteId;
$query     .= '&code='.$HTTP_GET_VARS['code'];
$query     .= "&REMOTE_ADDR=".$HTTP_SERVER_VARS['REMOTE_ADDR'];
$result     = @file($query);
if(trim($result[0]) !== "OK") {
header('Location: http://www.votresite.com/votrepageerreur.html');
    exit();
}
// Accès à votre page protégée
?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr">
//LE CODE DE VOTRE PAGE PROTEGEE ...
</html>

Voici l’url du script de vérification : http://payment.rentabiliweb.com/checkcode.php

Voici les paramètres nécessaires pour la requête :

  • docId : l’identifiant de votre document ;
  • siteId : l’identifiant de votre site où est configuré le document ;
  • code : ce paramètre contiendra le(s) code(s) saisi(s) par l’internaute (en cas de multicodes les codes seront séparés par des tirets “-“).

Notre script retournera en cas d’erreur : KO

En cas de code valide Rentabiliweb retournera : OK
De plus, sur la seconde et la troisième ligne, Rentabiliweb vous fournit des informations sur la nature du code (pays, type de paiement) sous cette forme :

– $result[1] : est le code ISO du pays (pour les dom tom : DT, pour les paiements par CB : XX),
– $result[2] : est le type de paiement utilisé pour obtenir le code (1 : audiotel, 2 : sms, 3 : Internet+, 5 : CB, 10 : Néosurf, 13 : OnNET).

Le script de protection en Javascript s’installe différemment. Il s’installe en le copiant à partir de la page Micropaiement » Installation de votre document. Il est à coller entre les balises <head> et </head> du code html de votre page à protéger, celle qui contient votre contenu payant.

Exemple

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<meta http-equiv="Content-Language" content="fr">
<meta name="description" content="description de votre page " />
<meta name="keywords" content="vos mots clés" />

<noscript>
<meta http-equiv="Refresh" content="0;URL=URL_CHECKTICKET_JS?docId=xxxxx&siteId=yyyyyy&nojs=1">
</noscript>
<script type="text/javascript" language="Javascript" src="URL_CHECKTICKET_JS?docId=xxxxx&siteId=yyyyyy"></script>
</head>

Pour sécuriser plusieurs pages grâce au même accès vous pouvez utiliser un système de session ou de cookie.

1.2 Installation du paiement CB > 3 EUR (clients premium et prestige)

1.2.1 Le formulaire de paiement

  • bouton d’achat

Ce bouton permettra à vos visiteurs d’acheter leur ticket abonné pour accéder à votre service.
En cliquant sur ce bouton, un popup s’ouvre avec les systèmes de paiement disponibles.
Voici les variables nécessaires au bon fonctionnement du popup :
– docId : l’identifiant de votre document
– siteId : l’identifiant de votre site où est configuré le document

Voici les paramètres facultatifs :
– data : grâce à ce paramètre vous pourrez transmettre des informations à l’url de votre page protégée et à votre url de callback (si configurée dans votre document).
Rentabiliweb retournera la valeur du champ data en méthode GET dans l’url de votre page protégée et votre url de callback (si configurée dans votre document).

  • formulaire de saisie

Ce formulaire fonctionne du même principe que le formulaire de paiement à l’Acte. Il accepte les mêmes paramètres.

1.2.2 La vérification du code

La vérification d’un ticket abonné se fait de la même façon que le paiement à l’Acte.

1.2.3 Url de callback

Rentabiliweb vous permet d’être informé lorsqu’un de vos clients achète un ticket abonné.
Dès qu’un achat est validé, le serveur Rentabiliweb envoie une requête sur vos serveurs à l’url indiquée dans le paramétrage de votre document.

Voici les paramètres que cette url retourne :

En cas de paiement Oneshot :
– docId : identifiant de ce document
– ticket : code abonnement délivré à l’internaute
– reference : numéro de la transaction
– amount : montant payé par l’internaute
– data : données “data” si présentes dans le script d’achat de pass abonné

En cas de paiement par réabonnement :
– docId : identifiant de ce document
– duration : durée de l’abonnement
– endDate : date de fin d’abonnement (forme : AAAA-MM-JJ HH:MM:SS)
– ticket : ticket abonné délivré à l’internaute
– reference : numéro de la transaction
– amount : montant payé par l’internaute
– renew : 1 s’il s’agit d’un renouvellement ; 0 s’il s’agit d’un premier paiement
– data : données “data” si présentes dans le script d’achat de ticket abonné

L’url de callback est exécutée à chaque transaction (paiement, réabonnement).

2. AFFILIATION

2.1 Utilisation des liens partenaires

Lors de la création du programme d’affiliation, vous avez configuré une bannière et un lien de promotion.

Rentabiliweb fournit à vos affiliés un lien d’inscription à votre programme ainsi que les scripts pour promouvoir vos services.
Le système gère automatiquement les partages de gains lors du paiement CB ou lors de la saisie du code pour un paiement à l’acte.

Nous gérons le backoffice technique de vos affiliations (inscriptions, envois d’emails automatiques, statistiques/gains) et le paiement de vos affiliés.

2.2 Configuration et intégration des variables d’affiliation

Vous pouvez paramétrer directement dans le formulaire de paiement votre affiliation et les reversements affiliés.

Les variables d’affiliation sont prioritaires sur l’utilisation des liens partenaires.

Les deux systèmes ne peuvent pas être utilisés en même temps.

Voici les paramètres :

  • PRID : id de votre programme d’affiliation ;
  • CAFF_n : code affilié du partenaire qui touchera les gains (n de 1 à 4) ;
  • POUR_n : pourcentage des gains reversé au partenaire sur l’acte (n de 1 à 4) ;
  • POUR_CB_n : pourcentage des gains reversé au partenaire sur la CB (n de 1 à 4) ;
  • PRGR_n : code du programme de reversement en sommes fixes qui sera utilisé pour calculer les gains affiliés (n de 1 à 4).

Attention vous ne pouvez utiliser que l’un des paramètres POUR_n (POUR_CB_n dans le cas d’un document CB) ou PRGR_n.

Pour configurer vos programmes de reversements en sommes fixes cliquez-ici

Intégration à nos formulaires de paiement

Elles peuvent s’intégrer de la même manière que ce qui est expliqué dans b) Passer des valeurs supplémentaires, à savoir grâce à des champs cachés dans le formulaire de micropaiement.

Exemple pour le formulaire popup :

<form id="rweb_tickets_XXXXX"  method="get" action="http://payment.rentabiliweb.com/access.php" style="margin: 0px; padding: 0px;" >
     <table width="280" cellpadding="0" cellspacing="0" style=" margin: 2px auto;">
          <tr>
	       <td style="text-align: center"><label for="code_0" style=" font-family:Arial, Helvetica, sans-serif;font-size: 12px; font-weight:bold; color:#3b5998; padding: 2px 2px 5px 2px; margin: 0px;">
                        Saisissez votre code d'accès et validez :<br/>
			<span style="font-size: 11px; font-style: italic;color:#5c5c5c;">Please enter your access code :</span></label></td>
          </tr>
          <tr>
               <td style="text-align: center">
	            <input name="code[0]" type="text" id="code_0" size="10" style="border: solid 1px #3b5998; padding: 2px; font-weight: bold; color:#3b5998; text-align: center;"/>
	            <input type="hidden" name="docId" value="XXXXX" />
		    <input type="hidden" name="PRID" value="<?php echo $le_prid;?>" />
                    <input type="hidden" name="CAFF_1" value="<?php echo $identifiant_de_votre_affilié;?>" />
                    <input type="hidden" name="POUR_1" value="<?php echo $le_pourcentage_à_reverser_à_cet_affilié;?>" />
		    <input type="button"  alt="Ok" onclick="getElementById('rweb_sub_XXXXX').disabled=true;document.getElementById('rweb_tickets_XXXXX').submit();" id="rweb_sub_XXXXX"  style="width: 40px; height:20px; vertical-align:middle; margin-left: 5px; border: none; background:url(http://payment.rentabiliweb.com/data/i/component/button_ok.gif);"/></td>
          </tr>
     </table>
</form>

Vous veillerez à indiquer le pourcentage en chiffre, exemple 80 pour 80%, ou 45 pour 45%.

Découvrez le micropaiement
Retrouvez toutes les newsletters
Suivez Rentabiliweb sur Facebook
Fil Twitter