Documentation d Intégration CB Paysite Cash

Please download to get full document.

View again

of 20
264 views
PDF
All materials on our website are shared by users. If you have any questions about copyright issues, please report us to resolve them. We are always happy to assist you.
Document Description
Documentation d Intégration CB Paysite Cash VERSION DU 07/01/ Configuration des paramètres du site dans votre interface commerçant Configuration générale du site Configuration
Document Share
Documents Related
Document Transcript
Documentation d Intégration CB Paysite Cash VERSION DU 07/01/ Configuration des paramètres du site dans votre interface commerçant Configuration générale du site Configuration liste noire des pays Configuration liste noire des porteurs Générateur d'url de paiement Configuration options Agent OpenMembers Configuration des mails de confirmation des abonnements Configuration graphique des pages de paiement Marque blanche Upload des images Gestion des abonnements Gestion des membres Files d attente Logs L affiliation Paysite Cash Considérations sur les systèmes d affiliation Configuration de l affiliation : Paramètres généraux Configuration de l affiliation : % personnalisés par affilié Paramètres d entrée sur la page de paiement Paramètres communs Options pour les abonnements Option pour les offres d essai (trial) Désactiver un ou plusieurs réseaux bancaires Option pour CB 3.6. Code erreur en mode debug Paramètres de retour sur les urls transaction ok / nok Paramètres de retour sur l url de confirmation Paramètres communs Options pour les abonnements Exemples de variables renvoyées Alertes de paiement Paramétrage de l url d alertes de paiement Données contenues dans le message d alerte de paiement Explication des codes d alerte Transactions de test Option de mise en attente Gestion à distance via l utilisation des APIs Paysite Cash Validation/Suppression distante de transaction Remboursement distant de transaction Récupération de l état d une transaction à distance Annulation distante d abonnement Modification distante d abonnement Récupération de l état d un abonnement à distance Comment utiliser le système de manière sécurisée Paramétrage et installation de l Open Members Agent Installation Configuration Page de choix des abonnements Accès distant aux statistiques Stats affiliés Stats webmasters Par respect pour l environemment, merci de n imprimer ce document qu en cas de nécessité. 3 1. Configuration des paramètres du site dans votre interface commerçant Si vous souhaitez récupérer les informations de transaction CB dans votre base de données locale, spécifier des comportements de retour différents suivant les paramètres de retour d une transaction ou encore que Paysite Cash gère vos membres (abonnements), suivez les procédures décrites plus bas (chapitres 4 à 13) Configuration générale du site Id site : le numéro identifiant votre site dans notre plateforme. Notez le bien, vous devrez l utiliser pour chaque utilisation de notre plateforme (appel de page de paiement, appel d API, lien vers la page de support, configuration de modules Paysite-Cash dans boutiques en ligne, configuration d agent, etc ). Mode test : Si le mode test est actif alors les transactions de test (test=1 dans l url) seront considérées comme valides et traitées comme telles, donc confirmées par url avec gestion des utilisateurs. Url référante : elle indique à notre plateforme de quel domaine les transactions financières proviennent pour le site en question. Elle empêche le passage de transactions depuis un autre domaine. Généralement identique à l url principale du site. Vous pouvez si vous le souhaitez spécifier plusieurs url référantes pour un même site, séparées par un point-virgule («;») Url de retour après paiement : Entrer au besoin l url vers laquelle sera automatiquement redirigé le client lorsque son paiement est en attente bancaire. Attention le retour sur cette url ne veut pas dire que le paiement est accepté mais simplement qu il a été traité par la plateforme Paysite Cash (voir chapitre 4) (vous pouvez par ex faire un test sur cette page sur le statut de la transaction - refusé ou accepté - et décider du message affiché en fonction de la réponse de la plateforme). Url de retour après paiement annulé : Entrer au besoin l url sur laquelle sera automatiquement redirigé un client ayant annulé son paiement en cliquant sur le bouton «annuler» (voir chapitre 4). Url de confirmation backoffice : Entrer au besoin (si vous voulez enregistrer ou traiter localement vos transactions CB) l url vers laquelle les informations de transaction seront envoyées par POST. En cas de non réponse de cette url, la plateforme Paysite Cash réessayera ultérieurement. Attention : mettre l adresse complète du fichier (ex : Nom d utilisateur et mot de passe de l url de confirmation : Il est vivement conseillé de sécuriser votre url backoffice via un.htaccess et.htpasswd. Vous pouvez indiquer ici le nom d utilisateur et le mot de passe correspondant le cas échéant. Url zone membres : Utilisée à titre indicatif, n affecte pas le fonctionnement de votre site. Autoriser non cohérence pays CB / Pays IP : Cette option vous permet d agir sur l algorithme de vérification de cohérence. Si vous sélectionnez «non», vous n allez accepter que les transactions réalisées par un client qui se trouve dans son propre pays. A utiliser lorsque l on travaille avec des pays a risques. Autoriser les fre s : Cette option vous permet d agir sur l algorithme de vérification antifraude. Il peut s avérer utile de refuser les fre s pour réduire les tentatives de fraudes. Autoriser les multi abonnements : Cette option permet d empêcher un client de s abonner plusieurs fois avec le même ou le même numéro de CB. Dans le cas d utilisation de l agent de gestion de membres, cette option n affecte que les numéros de CB car le test de l adresse est réalisé par défaut et il est impossible de prendre plus d un abonnement avec le même . Sans utilisation de l agent, cette option s applique sur les numéros de CB et les s. Par défaut les multi-abonnements ne sont pas autorisés. Vous pouvez les autoriser dans des cas précis où le client a la possibilité de souscrire à plusieurs abonnements différents sur le même site. Langues : Vous devez sélectionner au moins une des langues disponibles dans la liste. Clef APIs : Cette clé est une clé unique vous permettant d utiliser nos différentes APIs de manière sécurisée. Elle vous permet d être reconnu par notre plateforme lors des appels à nos différentes APIs. Voir le chapitre 9 pour l utilisation de nos APIS. Inscription SMS mailing : pour les sites ayant la vérification par SMS activée (voir dans les options de vérification SMS), vous pouvez choisir d enregistrer les numéros de téléphones récoltés pour la vérification SMS dans votre compte paysite-cash et vous en servir pour communiquer avec votre client par la suite. Ceci suppose que le client a donné son accord au préalable, en cochant la case sur la page de paiement Configuration liste noire des pays Dans cette section, vous pouvez choisir les pays pour lesquels vous voulez accepter ou refuser les transactions. Le pays est détecté à partir de l adresse IP et non des paramètres régionaux configurés sur l ordinateur de l utilisateur Configuration liste noire des porteurs Dans cette section, vous pouvez ajouter les adresses des porteurs pour lesquels vous voulez refuser les transactions. Lorsque qu un porteur essayera de payer sur votre site avec une adresse listée ici, le paiement lui sera refusé Générateur d'url de paiement Le générateur d url vous permet de générer facilement le code des boutons Paysite-Cash à insérer sur votre site en remplissant un formulaire. Son utilisation est relativement simple : Montant : entrez le montant correspondant au bouton que vous voulez créer. Montant2 : entrez le montant que vous souhaitez prélever in fine dans le cas d un abonnement avec période d essai. Le «Montant» décrit ci-dessus désigne alors dans ce cas le montant du premier prélèvement pour la période d essai. Langue : choisissez la langue par défaut qui sera affichée au client. Vous pouvez en dessous choisir de forcer la langue sélectionnée ou de permettre au client d afficher la langue de son choix, suivant ses paramètres régionaux. Abonnement : cocher dans le cas ou le paiement concerne un abonnement ;. nb de prélèvements au total : nombre de prélèvements prévus incluant le premier (exemple dans le cas d un abonnement de 6 mois avec prélèvement mensuel : 6).. Période : période séparant chaque prélèvement. Dans le cas où vous désirez proposer une période d essai, ce paramètre désigne la durée de la période d essai.. Période2 : dans le cas où vous désirez proposer une période d essai, et si celle-ci est d une longueur différente à la période normale, ce paramètre indique la période qui séparera chacun des prélèvements suivant la période d essai. Mode test : cochez si vous désirez effectuer des paiements de test avec le bouton que vous allez créer. Remarque : dans ce cas, vous devrez recréer un bouton avec cette option non-cochée pour le passage en production et l usage réel. Champ divers : entrez ici des informations additionnelles que vous désirez transmettre lors d un paiement (identifiant interne, commentaire, etc ). Laissez vide dans le cas où vous désirez spécifier un numéro d affilié (voir ci-dessous). Id affilié Paysite Cash : entrez ici le numéro d affilié spécifique au bouton que vous voulez créer le cas échéant. Ce numéro étant stocké dans le champ divers, vous devez laisser ce dernier vide dans le cas où vous souhaitez spécifier un numéro d affilié. GO! : La validation du formulaire vous affiche une nouvelle page contenant deux parties : - La partie haute vous affiche le code et vous permet de le copier/coller directement dans votre page html - La partie basse vous donne un aperçu de l aspect du bouton ainsi que des textes et liens ajoutés au dessus et en dessous dans le code. NB : Cet outil permet la création simple de bouton Paysite-Cash et n est pas prévu pour une utilisation avancée. Pour tirer partie au mieux des options avancées offertes par la plateforme Paysite-Cash, veuillez vous reporter aux chapitres concernées (3 à 5) Configuration options Agent OpenMembers NB : Cette partie ne concerne que les commerçants utilisant notre agent de gestion des membres.!!! Attention : l agent doit avoir été préalablement installé et configuré!!! Url de l agent : Url à laquelle est installé l agent (complète, avec «/index.php» à la fin). Nom d utilisateur et mot de passe de l agent : Ces informations ont été saisies à l installation de l agent. Clé secrète : Cette information a été saisie à l installation de l agent. Htacces, liste d IPs d autorisées sans authentification : Entrer ici les adresses IP/réseaux à autoriser pour des accès kits par exemple (une adresse IP par ligne). Htpasswd, import de membres existants : Si vous avez déjà des membres, entrez ici les données de votre.htpasswd au format : «user:pass_crypté». Réécriture journalière du htpasswd : Activé par défaut. Cela permet une réécriture «saine» complète du htpasswd tous les jours à partir de la liste des membres actifs. Dans le cas où vous utilisez un autre système de paiement CB qui accèderait au même fichier.htpasswd, vous ne devez surtout pas activer cette option. NB : Comme indiqué dans la partie précédente, vous avez à disposition dans votre espace éditeur un générateur d url. Dans le cas où vous utilisez l agent CB pour la gestion des users/pass il faut impérativement utiliser ce générateur car en mode abonnement une clef (&key=) est ajoutée pour éviter les modifications de prix et autre par url Configuration des mails de confirmation des abonnements NB : Cette partie ne concerne que les sites pour lesquels les écritures de nom d utilisateur/mot de passe sont gérées directement par la plateforme Paysite Cash via l agent CB. Format s : normal ou html. En mode html, les mails doivent contenir les balises html. Si vous voulez insérer des images, elles doivent être appelées avec leur adresse complète, ex : début abonnement : Oui / Non. Envoie un mail lors d un nouvel abonnement en se basant sur le contenu inséré dans «Message début». fin abonnement : Oui / Non. Envoie un mail lors de la fin d un abonnement en se basant sur le contenu inséré dans «Message fin». Url de la zone client : Utilisez cette url dans les mails de confirmation afin que les membres puissent se désabonner et réinitialiser leur mot de passe. L url est la suivante : https://billing.paysite-cash.biz/customers/?site=xxxx (XXXX devant être remplacé par le numéro du site). Message début : Entrez ici le texte que vous désirez envoyer au client pour confirmer sa souscription à votre abonnement. Utilisez les balises : #username# et #password# qui seront remplacées lors de l envoi du mail par le nom d utilisateur et le mot de passe du client. Message fin : Entrez ici le texte que vous souhaitez envoyer au client pour lui confirmer la désactivation de son compte le cas échéant. Remarque : la plate forme Paysite Cash réassignera automatiquement une vente à l affilié initial si le client se réabonne. Remarque : vous avez la possibilité d envoyer les messages dans plusieurs langues différentes. Ce choix dépend des langues que vous avez activées pour votre site : vous devez impérativement avoir enregistré un texte pour les messages de début et de fin dans chacune des langues que vous avez activées dans la configuration générale du site concerné Configuration graphique des pages de paiement Les choix de couleurs et polices sont globaux (page CB, page de retour après transaction et zone support clients). Vous avez aussi la possibilité de changer le logo «paiement sécurisé Paysite-Cash» en haut à gauche par votre propre image à uploader dans le champ prévu à cet effet juste en dessous (vous pouvez par ailleurs mettre des images différentes suivant la langue choisie par l utilisateur). Vous avez la possibilité de personnaliser encore plus la page de paiement et la page de support client en encapsulant notre page entre une entête et un pied de page (header/footer). Vous pouvez utilisez les variables divers et id_client que vous envoyez à la page de paiement en ajoutant dans l'en-tête ou le pied de page les tags : pour divers: # divers # pour id_client # id_client # Si dans vos codes html header et footer il y a des images, ces dernières doivent être uploadées sur le serveur Paysite Cash et appelées via SSL sinon une erreur de sécurité pouvant déconcerter les clients se produirait (voir ci-dessous pour l upload des images). Les images doivent ensuite être appelées via l url suivante : https://billing.paysite-cash.biz/images/x, X étant le numéro de votre site Marque blanche NB : Cette partie concerne les sites désirant utiliser un système de marque blanche : vous avez la possibilité d envoyer les paramètres de personnalisation directement dans l url d appel de la page de paiement. Ainsi vous pouvez si vous le voulez donner des couleurs différentes suivant par exemple le type de client qui va payer ou l endroit d où il vient. Les paramètres définis pour chaque site peuvent donc être déterminés par url (hors logo et header/ footer). Il faut les envoyer par GET uniquement de la manière suivante : &var=valeur. Liste de variables : font : nom de la police ou liste de polices séparées par une «,» et avec un urlencode. size : taille de la police avec px, ex 12px txtcolor : couleur du texte, ex #AAAAAA bgcolor : couleur de fond de la page, ex #BBBBBB title : couleur du texte dans les titres des tableaux, ex #CCCCCC titlebg : couleur de fond des cellules titres des tableaux, ex #DDDDDD tablebg : couleur de fond du tableau principal, ex #EEEEEE alink : cf référence HTML avisited : cf référence HTML ahover : cf référence HTML aactive : cf référence HTML 1.9. Upload des images Vous pouvez ici uploader les images que vous souhaitez insérer dans vos pages personnalisées. Contactez notre administrateur pour créer le répertoire qui contiendra ces images avant de les uploader Gestion des abonnements Cette section permet de lister les abonnements actifs et inactifs, de supprimer les abonnements de test inactifs et d annuler des abonnements actifs. Remarque : un abonnement inactif est soit un abonnement terminé soit un abonnement non terminé qui à reçu une demande d annulation de prélèvement ou encore un abonnement avec 1 seul prélèvement au total Gestion des membres Cette section permet de lister les membres actifs (uniquement si vous utilisez notre agent de gestion des membres). Vous pouvez aussi réinitialiser les mots de passe. Vous avez la possibilité de créer des membres et de les supprimer, mais notez toutefois qu un membre manuellement crée a une durée illimitée et n est lié à aucun abonnement Files d attente Cette section permet de lister les files d attentes des confirmations des transactions et des gestions de nom d utilisateur/mot de passe. Cela permet notamment de visualiser s il y a des problèmes de communication avec le site et une fois les problèmes résolus de relancer les actions en file d attente afin de ne perdre aucune information Logs Cette section liste les logs de confirmations de transactions avec : chaîne envoyée et réponse de la page de confirmation du site (255 1 er caractères uniquement). A utiliser à des fins de débogage. 2. L affiliation Paysite Cash La plateforme Paysite Cash intègre un système d affiliation (publique et privée) avec paiement direct des affiliés. Ce chapitre va vous aider à en comprendre le fonctionnement Considérations sur les systèmes d affiliation Utilisation de l affiliation Paysite Cash Dans le cas ou vous voulez utiliser le système d affiliation Paysite Cash (affiliation activée pour votre site sur la plate forme), il vous suffit d encoder dans le champ divers la variable $partner (cf rubrique paramètres d entrée sur la page de paiement), le $partner envoyé doit être un id existant d affilié sur la plate forme. Les montants à reverser aux affiliés sont calculés automatiquement et les statistiques sont disponibles directement dans les zones affilié et éditeur. Paysite Cash gère automatiquement l attribution d un identifiant affilié aux nouvelles ventes réalisées par un client revenant sur le site après sa première visite et ayant le même id_client ou . Le lien généré pour les affiliés est de la forme : Ce lien redirige automatiquement vers votre site en passant dans l url partner=x. Si vous souhaitez mettre en place des pages de ventes ou une marque blanche il vous faut configurer une page d outils de promotion personnalisés qui gèrent des liens du type : Ce lien redirigera sur la page toto.php de votre site en passant dans l url partner=x. Utilisation d un système d affiliation externe Normalement, avant chaque paiement, un utilisateur est créé dans la base de données locale. L identifiant affilié doit donc être assigné à ce moment la. Dans tous les cas le champ «divers» peut contenir des informations propres au système d affiliation et avec le format désiré lors de l envoi des paramètres de retour pour la confirmation backoffice, la plate forme Paysite Cash renvoie la variable «divers» sans la modifier (voir chapitre 5 dédié aux paramètres renvoyés sur l url backoffice) Configuration de l affiliation : Paramètres généraux NB : cette partie ne concerne que les commerçants utilisant le système d affiliation Paysite Cash. Lien inscription/activation affiliés : insérez ce lien directement dans votre page web pour l enregistrement de vos affiliés. En cliquant sur ce lien, vos affiliés vont être invités soit à se créer un compte dans notre plateforme s ils n en ont pas encore, soit à se connecter avec leur compte affilié s ils ont déjà un compte, et ajoutera dans les deux cas votre site préconfiguré (avec les pourcentages par défaut que vous aurez spécifiés par exemple) à leur liste de sites. Sécurisation anti fraude affiliés : oui / non, vous
Search Related
We Need Your Support
Thank you for visiting our website and your interest in our free products and services. We are nonprofit website to share and download documents. To the running of this website, we need your help to support us.

Thanks to everyone for your continued support.

No, Thanks
SAVE OUR EARTH

We need your sign to support Project to invent "SMART AND CONTROLLABLE REFLECTIVE BALLOONS" to cover the Sun and Save Our Earth.

More details...

Sign Now!

We are very appreciated for your Prompt Action!

x