Module RBSChange

S’abonner


Présentation du module pour RBS Change

Structure

Le module pour RBS Change est mis à disposition sous la forme d'un dossier compressé nommé paylineForRBSChange.zip contenant un unique répertoire : payline.
Il contient les éléments permettant l'appel des web services Payline, ainsi que l'intégration de Payline au sein des parties front-office (paiement) et back-office (configuration) de votre boutique réalisée sous RBS Change.

Compatibilité du module

Le module pour RBS Change est développé et testé avec l'environnement suivant :

  • RBS Change complet - Open Source 3.6.8
  • systèmes d'exploitation Windows 7 Professionnel
  • Apache 2.2.22
  • PHP 5.3.13


Télécharger le module ici :

paylineForRBSChange.zip


Intégration du module dans votre boutique

Pré-requis

Le module Payline pour RBS Change est construit autour du kit Payline PHP, dont le fonctionnement nécessite l'activation des extensions PHP php_curl, php_http, php_openssl et php_soap.
Vous devez également disposer d'un compte Payline pour configurer votre module.
La solution Payline repose sur l'appel de web services, assurez-vous que l'appel de web services sécurisés est donc possible avec votre solution d'hébergement (l'ouverture des ports 8080 et 443 en entrée/sortie est nécessaire).

Installation

Prérequis sous Windows

Pour la bonne interprétation de l'instruction php en ligne de commande, il est nécessaire j'ajouter le chemin du répertoire local contenant php.exe dans la variable d'environnement Path.

  • Cliquer sur l'icône Système dans le panneau de configuration
  • Sélectionner Paramètres système avancés
  • Cliquer sur le bouton Variables d'environnement…
  • Dans la liste Variables système, sélectionner Path et cliquer sur le bouton Modifier…
  • Dans le champ Valeur de la variable, insérer le chemin en veillant à séparer par ;
    • Ex : D:\wamp\bin\php\php5.3.13\;D:\wamp\bin\mysql\mysql5.5.24\bin\


Le répertoire contenant l'installation de RBS Change (et tous ses sous répertoires) doit être accessible en lecture/écriture.
L'invite de commande doit être lancée en mode administrateur.

Intégration

  • Décompresser paylineForRBSChange.zip dans le répertoire modules de votre installation RBS Change.
  • Depuis votre terminal (invite de commande sous Windows ou console Shell sous Linux) :
  • Positionnez-vous à la racine de votre installation RBS Change
  • Entrez la commande php framework/bin/change.php compile-all –clear afin de vider le cache.
  • Entrez la commande php framework/bin/change.php update-autoload afin de recharger les autoload
  • Vérifiez que les colonnes relatives à Payline ont été ajoutées dans la table _m_payment_doc_connector : _merchant_id, access_key, proxy_host,…
    • Si ces colonnes ne sont pas présentes, exécutez manuellement le script _m_payment_doc_connector_payline_paylineconnector.mysql.sql, généré à l'étape précédente sous _build/default/modules/payline/dataobject/
  • Entrez la commande php framework/bin/change.php import-init-data payline pour insérer les données Payline
  • Entrez la commande php framework/bin/change.php init-webapp pour intègrer les images dans le dossier media

Configuration


  • Connectez-vous à votre back office RBS Change. Un message indique que l'interface a été mise à jour, cliquez sur le bouton de rechargement :
  • Allez dans Tools > Payment methods
  • Sélectionnez Root folder dans l'arborescence de gauche



  • La méthode Payline créée par l'installation est affichée dans la liste :
  • Sélectionnez-la et cliquez sur l'icône (Edit)
  • Dans l'écran affiché, sélectionnez l'onglet Properties et renseignez vos paramètres

Description des paramètres

  • merchant_id est l'élément qui vous a été communiqué lors de la création de votre compte. Vous disposez d'un identifiant par environnement (homologation et production), ce champ doit donc être rempli en cohérence avec ce qui sélectionné pour production
  • access_key est votre clé pour l'appel des web services Payline. Une clé vous été communiquée lors de la création de votre compte. Vous pouvez à tout moment en créer d'autres via le centre d'administration Payline.
  • proxy_host, proxy_port, proxy_login et proxy_password doivent être valorisés avec les mêmes paramètres que ceux éventuellement utilisés pour accéder à Internet depuis votre serveur. Laissez ces champs vides si vous n'utilisez pas de proxy.
  • production indique si les paiements sont effectués dans l'environnement de production Payline. Sélectionner No pour pointer vers l'homologation et effectuer vos tests (les paiements y sont fictifs).
  • payment_currency est le code ISO de la devise de paiement (par défaut 978 pour l'euro)
  • order_currency est le code ISO de la devise de commande (par défaut 978 pour l'euro)
  • security_mode doit rester valorisé avec SSL
  • language_code est la langue dans laquelle la page de paiement est affichée. Laissez ce champ vide pour un affichage dans la langue du navigateur client.
  • payment_action détermine le type de transaction effectuée lors d'un paiement :
    • Une transaction de type authorization (code 100) doit être validée dans le centre d'administration Payline sous 7 jours pour que le paiement soit effectif. Ceci vous permet par exemple de ne débiter votre client qu'au moment où son achat lui est expédié.
    • Une transaction de type authorization + Capture (code 101) correspond à un paiement complet, l'acheteur est immédiatement débité.
  • payment_mode doit rester valorisé avec CPT
  • custom_payment_template_url permet de renseigner l'URL du template dynamique de personnalisation des pages de paiement
  • custom_payment_page_code sert à la saisie d'un code de personnalisation de vos pages de paiement, créé depuis le centre d'administration Payline.
  • contract_number est votre numéro de contrat qui détermine le point de vente utilisé
  • contract_number_list doit être rempli avec les numéros de contrat (séparés par des points-virgules) correspondant aux moyens de paiement que vous souhaitez proposer à vos clients pour un premier essai de paiement.
  • second_contract_number_list doit être rempli avec les numéros de contrat (séparés par des points-virgules) correspondant aux moyens de paiement que vous souhaitez proposer à vos client pour une deuxième tentative de paiement, si le premier essai a échoué.

Activation

Une fois le module intégré et configuré, un filtre de paiement doit être créé pour que vos acheteurs puissent choisir Payline pour effectuer leur paiement.

  • Allez dans E-commerce > Catalogue et boutiques
  • Sélectionnez votre boutique dans l'arborescence de gauche, puis cliquez sur l'icône Create…



  • Dans la liste proposée, sélectionnez Créer un filtre de paiement pour obtenir cet écran :
  • Dans l'écran affiché, renseignez le libellé que vos acheteurs verront lors du choix de la méthode de paiement dans le champ Label
  • Cliquez sur l'icône à côté du champ Payment method pour sélectionner la méthode Payline configurée à l'étape précédente.
  • Sélectionnez une zone de facturation puis cliquez sur le bouton pour finaliser la création.

Fonctionnement

Sélection de la méthode de paiement

Une fois le module installé, configuré et activé, Payline peut être sélectionnée par les clients de votre boutique RBS Change à l'étape 3 du processus de commande (Paiement), dans l'encart Moyen de paiement et sous le libellé renseigné dans la configuration :




Après la validation de cet écran, un écran final de confirmation est affiché :



Redirection vers la page web de paiement Payline

La redirection vers la page de paiement se fait après le clic sur le lien paiement par carte bancaire de l'écran de confirmation présenté précédemment.
Les moyens de paiement correspondant aux contrats choisis dans la configuration du module sont proposés à l'acheteur, il peut procéder à la saisie de ses informations de paiement en toute sécurité.
Dès cette étape, la commande est créée à l'état Initié et peut être consultée dans le back office de la boutique

Retour à la boutique

Une fois la saisie de ses informations de paiement validée, le client obtient un écran de confirmation l'informant du résultat de sa transaction. Sur cet écran un bouton « retour à la boutique » lui permet d'être redirigé vers la page de confirmation de commande dans la boutique RBS Change, qui se présente comme suit en cas de paiement réussi :



Si le paiement est annulé ou refusé, la page de confirmation indique l'échec :




Dans ce cas de figure, le panier n'est pas vidé, pour permettre à l'acheteur d'effectuer une nouvelle tentative.
Le retour à la boutique met immédiatement le statut de la commande à jour. Si le paiement est refusé ou annulé, la commande est passée au statut correspondant.
Lorsque le paiement est accepté, la commande passe à l'état En cours.
Si la page web de paiement est fermée sans que le client retourne à la boutique, la mise à jour dans votre boutique RBS Change sera automatiquement effectuée par le traitement de notification Payline.

Détail de la commande

Les informations relatives à Payline apparaissent dans l'onglet Paiement du détail de la transaction.


Vous avez d’autres questions ? Envoyer une demande

Commentaires

Réalisé par Zendesk