Guide d utilisation. v 2.0

Transcription

1 Guide d utilisation v 2.0 Maj. le 23/10/2013

2 Inscription et Connexion à l'espace client 3 Installer le service de micropaiement PayPerPass 4 1. Ajouter un site! 5 2. Ajouter un produit! 6 3. Utiliser les scripts de micropaiement! 7 A. Mode Standard! 7 Processus de paiement! 11 B. Mode Mixte! 11 Cas de l'appel Sans Code et du Double Appel Sans Code! 13 C. Mode API (transparent)! 15 Cas de l'appel sans code! 18 Relevés des micropaiements 19 Liste des micropaiements 19 Sécurité 20 Annexe : liste des code d'erreurs 21 2

3 Inscription et Connexion à l'espace client Pour vous inscrire et utiliser notre service, vous devez simplement remplir le formulaire dédié disponible à cette adresse : Après validation du formulaire, vous recevez vos identifiants de connexion par . Connectez-vous à l'espace client : Entrez vos code d'accès. Le relevé des micropaiements vous indique semaine par semaine, le nombre de micropaiements effectués sur votre site classés par type de service (SMS, audiotel, MPME,...). 3

4 Installer le service de micropaiement PayPerPass L installation du système de micropaiement PayPerPass, se fait en 3 étapes simples : 1. Ajouter un site : pour enregistrer le site à partir duquel vous souhaitez proposer le module de paiement PayPerPass, 2. Ajouter un produit : pour enregistrer le produit que vous souhaitez vendre à partir de votre site Internet, 3. Générer un script : pour générer le script personnalisé à installer sur votre site Internet. 4

5 1. Ajouter un site Une fois connecté, vous devez vous rendre dans la rubrique SITES et cliquer sur le bouton Ajouter un site. Ensuite vous n avez qu à renseigner les informations demandées et valider le formulaire. Il est possible de modifier les informations ultérieurement en cliquant sur MAJ (mise à jour) ou Suppr. (supprimer). Important : les sites enregistrés doivent respecter la charte d'utilisation des services PayPerPass. Nous nous réservons de droit de supprimer les sites contrevenant aux clauses de notre charte. 5

6 2. Ajouter un produit Allez ensuite dans la rubrique PRODUITS. Choisissez votre site (pour l'exemple renseignez les informations suivantes : url de votre page de paiement : c'est l'adresse de la page qui contiendra le cadre de paiement payperpass à destination de vos clients url de votre page de produit : c'est l'adresse de la page qui contiendra votre produit (un fichier à télécharger, une recette, un jeu, un contenu,...) url de votre page d'erreur : c'est l'adresse de la page qui contiendra votre message d'erreur en cas de problème de paiement. Note : vous pouvez laisser ce champ vide. Dans ce cas l'utilisateur sera redirigé vers un message d'erreur payperpass. Après validation, le produit s affiche dans la liste en dessous du formulaire. Vous pouvez modifier les informations de chaque produit en cliquant sur Edit Vous pouvez enregistrer autant de produit que vous le souhaitez. 6

7 3. Utiliser les scripts de micropaiement Vous allez maintenant pouvoir utiliser les scripts de micropaiement PayPerPass de 3 façons différentes : en mode Standard en mode Mixte en mode API (transparent) A. Mode Standard Ce mode vous permet d'insérer un cadre embarqué dans votre site qui permettra à vos utilisateurs d'accéder à un contenu payant après avoir effectué un paiement. C'est le mode le plus simple. Vous allez télécharger 2 scripts à insérer l'un sur la page de paiement de votre produit et l'autre sur la page du produit pour le protéger. Aller dans la rubrique GENERER UN SCRIPT Sélectionnez le site, puis le produit désiré. Vous avez alors accès à la liste des services de micropaiement disponibles. Important : les services SMS+ ne sont pas autorisés pour les sites d'instant gagnant engageant des sommes à gagner. Sélectionnez les services désirés (un par catégorie : SMS, Audiotel, MPME). 7

8 Si vous sélectionnez plus d'un service, vous pouvez choisir d en mettre un en avant (l'onglet qui s'affichera par défaut dans l'interface de paiement). Laissez le paramètre durée de réservation du numéro vide. Ce paramètre est optionnel et pourra être utilisé en mode mixte et caché. Dans l image ci-dessus, c'est l'appel sans code 30s qui s'affichera en premier à l'utilisateur. Après validation, vous obtenez les scripts à installer sur la page produit de votre site. 8

9 Copiez / coller le script de paiement à l'emplacement où vous voulez voir l'interface de paiement s'afficher sur la page de paiement. Il s'agit d'un iframe (un cadre embarqué) qui affichera l'interface de paiement PayPerPass. La taille de l'iframe est de 580 px de hauteur par 550 px de largeur. Copiez / coller le script de protection dans la partie «<head></head>» de votre page produit. Ce script évite qu'un utilisateur qui connaîtrait l'adresse directe de cette page ne s'y connecte et accède à votre produit sans être passé par l'interface de paiement. Si c'était le cas celui-ci serait redirigé vers votre page de paiement. Ne vous souciez pas de la partie Url de rapport des transactions réussies. Elle sera utilisée en mode mixte. Important : l'iframe payperpass charge votre page produit dans la fenêtre parent. N'utilisez pas de scripts java ou flash qui bloqueraient le chargement depuis le cadre enfant. 9

10 Une fois le script inséré dans votre page de paiement, l'interface s'affichera de cette manière sur votre site : Notez que c'est le service que vous avez choisi de mettre en avant qui s'affiche en premier. En cliquant sur les onglets l'internaute peut choisir d'autres moyens de paiement s il le souhaite. 10

11 Processus de paiement Un fois le code saisi par l'internaute ou le paiement effectué chez l'opérateur mobile, celui-ci est redirigé vers votre page de produit dont vous avez saisi l'adresse à la rubrique PRODUITS. Le script de protection vérifie qu'un micropaiement a été effectué par l'internaute et donne l'accès au contenu. Note : il est possible de personnaliser l'interface aux couleurs de votre site. (Sur devis - Nous consulter) Pour toute question technique : webmaster@payperpass.eu Voilà! Vous avez maintenant terminé l'implémentation des scripts de paiement payperpass sur votre site en mode standard.. Vous pouvez désormais vous connecter régulièrement à votre relevé pour suivre l'état d'avancement de vos micropaiements. B. Mode Mixte Ce mode vous permet d'insérer un cadre embarqué dans votre site qui permettra à vos utilisateurs d'effectuer une action sur votre site dont vous serez le maitre d'oeuvre après avoir effectué leur paiement. Il ne s'agit pas de rediriger vers une page produit dont le contenu est protégé avec le script standard PayPerPass mais de rediriger vers une page de traitement dont vous ordonnez la protection. Il peut s'agir d'une page qui augmente un crédit de jeu, une monnaie virtuelle ou un enregistrement. Téléchargez le script à insérer sur la page de paiement dans la rubrique GENERER UN SCRIPT comme expliqué dans le fonctionnement standard. Installez ce script sur votre page de paiement. Dans la rubrique PRODUITS, indiquez dans l'url du produit l'adresse de la page qui effectuera le traitement (exemple Comme il s'agit d'une page de script dynamique exécutée coté serveur, le script de protection standard payperpass n'est pas adapté. Pour vérifier que l'internaute est apte à lancer le processus de cette page (cad qu'il n'a pas lancé cette page sans avoir effectué de paiement) interrogez l'url de rapport des transactions réussies qui est contenue dans le bloc Url de rapport des transactions réussies : 2 paramètres optionnels peuvent être fournis : 11

12 le paramètre [id de reservation du numero] : est utilisé en mode API. Ne l'utilisez pas en mode mixte, [ip de l internaute] : c'est l'adresse ip de votre client final. En fournissant ce paramètre vous allez recevoir la liste de toutes les transactions réussies pour ce client. 12

13 La liste est au format xml : <gettransactionsvalides> " <transaction> " " <service>615</service> " " <produit>848</produit> " " <idtransaction>651559</idtransaction> " " <ip> </ip> " " <date> t00:46:41.77</date> " " <test>false</test> " </transaction> " <transaction> " " <service>615</service> " " <produit>848</produit> " " <idtransaction>651557</idtransaction> " " <ip> </ip> " " <date> t00:46:27.2</date> " " <test>false</test> " </transaction> " <transaction> " "... " </transaction> </gettransactionsvalides> Utilisez ensuite les critères contenus dans cette liste pour effectuer votre traitement. Par exemple : garder en mémoire les id de transaction qui ont déjà été enregistrées et effectuer une action (créditer le compte de l'utilisateur) pour les nouvelles idem par rapport aux dates En cas d'erreur ou d'absence de transaction, l'api retourne <api> <codeerreur>500</codeerreur> </api> Reportez-vous à la liste des codes d'erreurs en annexe pour en connaître le détail. Cas de l'appel Sans Code et du Double Appel Sans Code Vous pouvez choisir une durée de réservation de numéro à appel sans code. Pendant cette durée de réservation, votre client client peut appeler autant de fois que nécessaire ce numéro. Dans ce cas il n'est pas redirigé automatiquement vers votre page de traitement après un appel. Il devra cliquer sur le lien Valider les appels pour être redirigé vers votre page de traitement une fois ses appels passés. 13

14 Vous récupérez ensuite toutes les transactions validées et effectuez le traitement adapté (crédit d'un compte utilisateur fonction du nombre d'appel par exemple). Pour cela renseignez le paramètre optionnel Durée de réservation du numéro dans la rubrique générer un script. Le numéro restera opérationnel pendant la durée de réservation. 14

15 Exemple d'appel de l'url de rapport des transactions Utilisez la fonction php curl en post ou get pour interroger l'url de vérification. Exemple en php : $url = ' method=gettransactionsvalides&p=927&s= &ip='. $_SERVER['REMOTE_ADDR'] ; $urlparam=''; // Appel au web_service $ch = curl_init(); curl_setopt ($ch, CURLOPT_URL, $url); curl_setopt ($ch, CURLOPT_POST, true); curl_setopt ($ch, CURLOPT_POSTFIELDS, $urlparam); curl_setopt ($ch, CURLOPT_RETURNTRANSFER,1); curl_setopt($ch, CURLOPT_TIMEOUT, 90); // delai de réponse du serveur, en secondes curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); // reponse de la page $content = curl_exec($ch); // information de retour $err=curl_errno($ch); $liberr=curl_error($ch); $info=curl_getinfo($ch,curlinfo_http_code ); $infotime=curl_getinfo($ch,curlinfo_total_time ); $infodns=curl_getinfo($ch,curlinfo_namelookup_time ); $infocnx=curl_getinfo($ch,curlinfo_connect_time ); $infopre=curl_getinfo($ch,curlinfo_pretransfer_time ); $infostart=curl_getinfo($ch,curlinfo_starttransfer_time ); $infored=curl_getinfo($ch,curlinfo_redirect_time ); curl_close ($ch); // Traitement // ajouter ici votre traitement de lecture des données au format XML C. Mode API (transparent) Ce mode vous permet de fonctionner avec notre système de micropaiement en toute transparence sur votre site. Il vous permet d'implémenter votre propre interface de paiement en utilisant nos librairies de délivrance et de validation de code. Pour cela utilisez les urls fournies à la rubrique générer un script dans l'onglet INTERROGATION PAR API. Suivez d'abord les étapes de création de site et de produit comme indiqué précédemment. 15

16 Important : Lors de la création de votre produit, il est inutile de renseigner les urls de vos pages de paiement et de produit. Indiquez simplement l'url de votre site dans ces zones. Ne choisissez qu'un service à la fois pour utiliser ce mode. L'url de réservation de numéro vous permet de ramener tous les paramètres nécessaires à l'affichage du numéro (audiotel, SMS, Appel sans code). Le format de retour est le suivant : 16

17 Pour l'appel sans code <getnumber> " <service>715</service> " <produit>848</produit> " <numeroappel> </numeroAppel> " <codeappel/> " <dureeappel>15 secondes</dureeappel> " <tarificationappel>1,35 /appel + 0,34 /minute</tarificationappel> " <conditionsappel>paiement sécurisé</conditionsappel> " <conditionsappel2/><dureereservation/> " <idtransaction>b e ea646c4</idtransaction> </getnumber> Pour le SMS+ <getnumber> " <service>7</service> " <produit>848</produit> " <numeroappel>81073</numeroappel> " <codeappel>pass</codeappel> " <dureeappel/> " <tarificationappel>4,50 /SMS + prix d'un SMS</tarificationAppel> " <conditionsappel>paiement sécurisé - Code valable 48 heures</conditionsappel> " <conditionsappel2>1 envoi de SMS par code d'accès</conditionsappel2> " <dureereservation/> " <idtransaction/> </getnumber> Pour l'audiotel <getnumber> <service>9</service> <produit>848</produit> <numeroappel> </numeroAppel> <codeappel/> <dureeappel>25 secondes</dureeappel> <tarificationappel>1,35 /appel + 0,34 /minute</tarificationappel> <conditionsappel>paiement sécurisé - Code valable 48 heures</conditionsappel> <conditionsappel2/> <dureereservation/> <idtransaction/> </getnumber> Utilisez ensuite la fonction de validation de code si vous utilisez les services SMS+ ou audiotel en renseignant le paramètre code. Exemple : Le code n'est valide qu'une seule fois. Effectuez ensuite le traitement approprié sur votre site. 17

18 Cas de l'appel sans code Aucun code n'est validé lors de l'appel sans code. Il est donc nécessaire de vérifier l'état des transactions validées pour le numéro réservé. Vérification par id de transaction (recommandé) On obtient le paramètre idtransaction lors de la réservation d'un numéro à appel sans code. (de la forme guid - ex. : b e ea646c4) On peut aller chercher la liste de tous les appels validés effectués sur ce numéro en utilisant la fonction de rapport des transactions réussies : Exemple method=gettransactionsvalides&p=927&s=660&idreservation=b e ea646c4 Renseignez le paramètre [id de reservation du numero] avec la valeur de idtransaction obtenue lors de la réservation d'un numéro. Ne renseignez pas le paramètre [ip de l internaute]. Vérification par ip vous pouvez aussi vérifier les transactions validées d'un internaute en associant l'ip de l'internaute au numéro réservé. Dans ce cas renseignez le paramètre ip lors de la réservation du numéro. Example : method=getnumber&p=927&s=660&ip= Puis recherchez la liste de tous les appels validés effectués sur ce numéro pour cette adresse ip en utilisant la fonction de rapport des transactions réussies : method=gettransactionsvalides&p=927&s=660&ip= Effectuez ensuite les traitements nécessaires. Renseignez le paramètre optionnel [durée de réservation du numéro] à la réservation du numéro si vous souhaitez limiter le temps de validité du numéro. La réservation ne peut excéder 10 mn (600 secondes). 18

19 Relevés des micropaiements L'état de vos micropaiements s'affiche par mois, par semaine, par jour, par site et par service distinct. Un total cumulé du nombre de paiements et du chiffre d'affaire réalisé est présenté à la fin de chaque période. C'est sur la base de vos relevés que sont effectués vos virements. Les virements ont lieu chaque semaine le mercredi pour la semaine précédente (micropaiements effectués du lundi au dimanche). Il sera bientôt possible d'effectuer des demandes de reversements. Pour toute question sur les reversements : reversement@payperpass.eu Liste des micropaiements Au besoin vous pouvez consulter la liste exhaustive des micropaiements effectués sur votre site. Relevé chronologique des paiements effectués sur votre site détaillant les codes valides entrés par vos clients, la date et l'heure d'entrée et l'ip de l'internaute ayant entré le code. 19

20 Sécurité Nous sécurisons notre interface de paiement avec un Certificat SSL garantissant une connexion cryptée 128bits (https) pour tous les échanges entre notre serveur et les clients finaux. Nous utilisons la technologie ASPX (dot.net) de Microsoft réputée sécurisée et robuste face aux tentative de piratage. A chaque appel de page nous nous assurons de la validité des paramètres produit et service demandé Pour chaque code entré nous effectuons une vérification de la concordance entre l'ip de l'internaute ayant entré le code, la validité du code et le délai entre la saisie du code et l affichage du produit qui ne peut excéder 3 mn : le code ne peut pas être réutilisé indéfiniment. La validité du code est effectuée en temps réel auprès de nos fournisseurs Télécom. Nous n utilisons pas de cookies ni de variables de session : aucune donnée n est stockée sur le poste de l utilisateur. La page produit est protégée par un script javascript inséré en amont de la page produit et qui est généré dynamiquement sur notre serveur à chaque appel. En cas de désactivation du javascript, la page produit reste protégée : l'utilisateur est redirigé vers une page d'erreur (gestion des «no script»). Traçabilité de tous les IP ayant effectué des transactions sur sur votre site. Possibilité d'appel transparent via nos API XML pour gérer votre propre interface. Les mots de passes d'accès à notre interface de statistiques sont cryptés. Notre solution est hébergée sur un centre serveur sécurisé et protégé contre le piratage. Les répertoires sont protégés des accès frauduleux. 20

21 Annexe : liste des code d'erreurs Code Signification 120 Paramètre Produit manquant 125 Paramètre Produit invalide 130 Paramètre Service manquant (SMS, ) appel de la page de paiement aucun paramètres fournis 135 Paramètre Service invalide (SMS, ) vérification du code 135 Paramètre Service invalide (SMS, ) appel de la page de paiement 138 Paramètre Service retour xml aucun des services demandé n'accepte le retour xml 140 Traitement paiement retour xml : paramètre xml invalide (0 ou 1) 150 Paramètre de retour MPME «valide» manquant validation du paiement mobile 155 Paramètre de retour MPME «valide» invalide - non booléen validation du paiement mobile 160 Traitement paiement retour xml : paramètre code manquant 200 Aucun produit associés, produit ou client inactif, erreur BDD 300 Plusieurs lignes pour un même produit 400 Code service incorrect ou erreur BDD 410 Appel de la page de paiement : Aucun fournisseur associé pour le (un des) service(s) demandé(s) 450 Vérification du paramètre service : aucun fournisseur principal pour le service 452 Validation du code : connexion opérateur échouée 455 Validation du code : erreur de validation xml retour opérateur 456 Validation du code : nombre d'appel insufisant (double appel) 460 Retour mpme - Vérification du paramètre hash : code manquant 465 Retour mpme - Vérification du paramètre hash : valeur de retour query invalide 21

22 Code Signification 470 Validation du code : erreur à l'enregistrement du µp 480 Appel sans code : parametre 1 de retour manquant 481 Appel sans code : parametre 2 de retour manquant 482 Appel sans code : parametre 3 de retour manquant 483 Appel sans code : parametre 4 de retour manquant 484 Appel sans code : parametre 5 de retour manquant 485 Appel sans code : Erreur obtention numéro 488 Validation appel sans code f3 : id reservation introuvable (réservation expirée) Appel sans code f3 : obtention du numéro : paramètre de durée de réservation incorrect Appel sans code f3 : obtention du numéro : paramètre de durée de réservation > durée max (10mn) 490 Web API : aucune fonction évoquée 491 Web API : Ip appelante invalide 500 Aucun µp associé 600 Javascript interdit sur le navigateur client 605 Validation MPME : paramètre request_id manquant 610 Validation MPME : accès produit déjà effectué 700 erreur BDD 22