1.1 Installation du paiement à l’Acte
1.1.1 Le formulaire de paiement
a) Installer le formulaire de paiement
b) Passer des valeurs supplémentaires
c) Code HTML et CSS
1.1.2 La vérification du code
1.2 Installation du paiement CB > 3 EUR (clients premium et prestige)
1.2.1 Le formulaire de paiement
1.2.2 La vérification du code
1.2.3 Url de callback
2.1 Utilisation des liens partenaires
2.2 Configuration et intégration des variables d’affiliation
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 3 paliers différents : 2 euros, 2.5 euros et 3 euros.
Si vous désirez utiliser un palier 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.
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 que d’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 car étant utilisé pour monétiser les applications Facebook.
Cependant, il est utilisable sur les sites web classiques par un légère modification du script généré par la plateforme Rentabiliweb (cf. a) Formulaires de paiement).
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.
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. 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é.
Pour installer le formulaire Facebook sur votre site web classique, il vous suffit de remplacer les balises <fb:iframe> et </<fb:iframe> par les balises iframe standards <iframe> et </iframe>.
Exemple :
Script du formulaire Facebook opérationnel pour les applications Facebook :
<fb:iframe src="http://payment.rentabiliweb.com/form/acte/form_fb.php?docId=xxxxx&siteId=yyyyyy&cnIso=geoip" frameborder="0" scrolling="auto" width="580" height="400"></fb:iframe>
Script adapté pour les sites web :
<iframe src="http://payment.rentabiliweb.com/form/acte/form_fb.php?docId=xxxxx&siteId=yyyyyy&cnIso=geoip" frameborder="0" scrolling="auto" width="580" height="400"></iframe>
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, et ce d’une manière très simple : par un champ caché. Ce champ caché aura obligatoirement le nom « data », et portera la valeur que vous lui attribuerez.
Le code de ce champs caché :
<input type="hidden" name="data" value="ma_valeur"/>
ou bien, pour passer une variable php :
<input type="hidden" name="data" value="<?php echo $votre_variable; ?>"/>
Si vous voulez passer plusieurs valeurs par ce champ, 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);
Les formulaires popup et iFrame peuvent grossièrement être divisé 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é.
Exemple pour le formulaire popup
<form id="rweb_tickets_88178" 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="88178" />
<input type="hidden" name="data" value="<?php echo $ma_variable;?>" />
<input type="button" alt="Ok" onclick="getElementById('rweb_sub_88178').disabled=true;document.getElementById('rweb_tickets_88178').submit();" id="rweb_sub_88178" 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
<form id="rweb_tickets_88178" 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="88178" />
<input type="hidden" name="data" value="<?php echo $ma_variable;?>" />
<input type="button" alt="Ok" onclick="getElementById('rweb_sub_88178').disabled=true;document.getElementById('rweb_tickets_88178').submit();" id="rweb_sub_88178" 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 connaître les paramètres d’affiliation cliquez-ici.
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.
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.
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) saisis par l’internaute (en cas de multicode 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 et Paypal : XX),
- $result[2] : est le type de paiement utilisé pour obtenir le code (1 : audiotel, 2 : sms, 3 : Internet+/KML, 5 : CB, 8 : Paypal, 10 : Néosurf, 13 : OnNET).
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 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. 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>
Le script de protection en Javascript s’installe différemment. Il s’installe en le copiant à partir 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. 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=88178&siteId=362391&nojs=1">
</noscript>
<script type="text/javascript" language="Javascript" src="URL_CHECKTICKET_JS?docId=88178&siteId=362391"></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. Pour obtenir de l’aide et des conseils sur la sécurisation de votre site, prenez contact avec notre équipe technique.
1.2 Installation du paiement CB > 3 EUR (clients premium et prestige)
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 transmetre des information à votre url de callback.
Rentabiliweb retounera la valeur du champ data en method GET dans l’url de callback
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).
Rentabiliweb possède un POOL de requêtes, celui-ci renverra la requête de callback en cas de non réponse de vos serveurs.
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 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 ou PRGR_n.
Pour configurer vos programmes de reversements cliquez-ici
Intégration à nos formulaires de paiement
Ils 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_88178" 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="88178" />
<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_à_cette_affilié;?>" />
<input type="button" alt="Ok" onclick="getElementById('rweb_sub_88178').disabled=true;document.getElementById('rweb_tickets_88178').submit();" id="rweb_sub_88178" 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%.
