Swissbilling

Introduction

Avec SwissBilling™, vous obtenez un moyen simple d’offrir le paiement par facture dans votre propre boutique sans grand risque. Dans la plupart des cas, cela augmentera les ventes et la taille du panier, d’autant plus que les clients peuvent également payer en plusieurs fois et qu’aucune carte de crédit n’est requise.

Contrairement aux systèmes classiques de vérification de crédit, cette solution va quelques étapes plus loin : Essentiellement, SwissBilling™ achète la créance, vous recevez votre argent dans tous les cas à une échéance préalablement convenue et vous n’avez plus d’efforts dans la gestion des débiteurs - ne plus jamais écrire de rappels !

Dès qu’une commande avec le mode de paiement ‘Facture avec SwissBilling’ a été sélectionnée dans PepperShop, la boutique redirige l’acheteur vers SwissBilling après les conditions générales. Là, après une vérification de risque réussie, le client se voit proposer de recevoir la facture par courrier ou par e-mail et le paiement dans la boutique est terminé.

Dès que les marchandises sont expédiées, SwissBilling reçoit automatiquement un message d’information correspondant de la boutique (il en va de même pour les annulations). La facture est envoyée séparément.

SwissBilling est disponible pour les clients de Suisse et du Liechtenstein. Actuellement, les paiements ne sont acceptés qu’en devise franc suisse (état juin 2012). PepperShop utilise actuellement la connexion Gateway en version 1.0 sans présélection et sans mode Hidden.

Ajustements de configuration du système de boutique

Activation des modes de paiement et groupes de pays

Le module SwissBilling utilise l’interface de paiement v.2 de PepperShop. Un nouveau mode de paiement ‘Facture avec SwissBilling’ est inséré. Par conséquent, nous devons passer au menu ‘Pays de livraison / Expédition’ dans l’administration de la boutique et cliquer sur le bouton ‘Modifier’ là au groupe de pays où la Suisse est incluse. Sur cette page, nous configurons la disponibilité de SwissBilling pour la Suisse. Au point ‘Modes de paiement acceptés’ nous devons maintenant ajuster certains paramètres :

1. Ici, vous devez d’abord définir un nouveau montant d’intervalle : Dans la ligne “À partir du montant (CHF)", entrez le montant maximum convenu avec SwissBilling dans la devise de base de la boutique dans un champ (limite maximale).
2. Pour le mode de paiement “swissbilling”, vous devez cocher jusqu'à ce que vous arriviez à la colonne correspondante qui décrit la limite maximale.
3. Enfin, il doit être assuré que dans la colonne avec la limite maximale et toutes les colonnes derrière, aucune coche n’est définie pour “swissbilling”.
4. Maintenant, nous confirmons en cliquant sur le bouton “Enregistrer les modes de paiement”.
5. Veuillez désactiver le mode de paiement Facture !

Attention : S’il y a une mauvaise configuration ici, le mode de paiement sera affiché dans la caisse mais après la finalisation de la commande lors de l’appel de la page de paiement SwissBilling, un message de rejet sera affiché.

Paramètre RGPD - Informez votre client sur la requête

Depuis le 25 mai 2018, le RGPD est actif, les requêtes ne peuvent être faites que pour le mode de paiement facture. Veuillez le configurer de manière à ce que le client soit informé, ou dans le meilleur des cas, que sa permission soit obtenue.

Attributs clients

Pour que SwissBilling ait toutes les données disponibles pour effectuer une vérification de risque, un certain nombre d’attributs clients doivent être demandés dans la boutique pour la caisse. La configuration minimale peut être trouvée affichée dans la figure suivante (colonne marquée en rouge “utiliser”). Cela peut être défini dans votre propre boutique web à l’emplacement suivant : Administration de la boutique → Attributs clients :

Si votre propre boutique web fonctionne avec des adresses de livraison différentes, il doit être assuré qu’au moins les attributs clients mentionnés dans l’image ci-dessus y sont demandés (voir colonne marquée en rouge “dans adresse de livraison”).

Attention : Il est particulièrement important que la date de naissance soit demandée (colonne : utiliser), de préférence avec “vérifier” également coché.

Configuration du module SwissBilling

Veuillez aller à l’emplacement suivant : ‘Administration de la boutique’ > ‘Modules’ > ‘SwissBilling’ :

Le masque de configuration central du module SwissBilling ressemble à ce qui suit :

Configuration :

• Activation : Ce n’est qu’après avoir coché ici que le module devient disponible pour le processus de paiement. De plus, il doit être activé dans ‘Pays de livraison / Expédition', comme décrit en détail dans le chapitre plus haut.
• Merchant ID : Identifie le commerçant (opérateur de boutique), est attribué par SwissBilling.
• E-Shop ID : Identifie la boutique web, est attribué par SwissBilling.
• Mot de passe : Le mot de passe est attribué par SwissBilling.
• Clé privée : (parfois également décrite comme Clé publique dans la documentation). Est attribuée par SwissBilling.
• Exploitation : Ici, vous pouvez définir si la connexion à SwissBilling est uniquement utilisée pour les tests (AUCUNE TRANSACTION FINANCIÈRE RÉELLE !), ou si l’exploitation productive doit être activée.
• Confirmer la transaction : Il s’agit de l’appel dit ‘Acknowledge Call’ à SwissBilling. Ce n’est que lorsque cet appel a été envoyé que la transaction est libérée pour la facturation !
• Quand la boutique doit-elle envoyer cela à SwissBilling ?
  • Il est recommandé de choisir ‘À l’expédition’ ici, alors votre PepperShop informe automatiquement SwissBilling via appel lorsque le statut de commande change en “expédié”.
  • Si “À la réception de la commande” est choisi ici, la boutique web envoie l’appel Acknowledge immédiatement après une transaction SwissBilling réussie. Cela n’a de sens que si vous pouvez expédier les marchandises à cent pour cent. Sinon, vous avez le problème que cette facture sera définitivement émise.
  • Si vous choisissez “Jamais”, vous devez envoyer la confirmation de transaction (Acknowledge Call) manuellement à SwissBilling (ou automatiquement via un système connecté, tel qu’un système ERP avec interface à SwissBilling).

Info sur EshopTransactionCancel. Ceci n’a pas besoin d'être envoyé par la boutique. Si vous n’exécutez pas ou ne supprimez pas une commande, vous devez simplement vous assurer qu’aucun appel Acknowledge n’est envoyé / n’a été envoyé à SwissBilling.

Aide en ligne

Dans le module SwissBilling, vous pouvez trouver l’accès aux textes d’aide en ligne pour ce module en cliquant sur le bouton d’aide. Les textes d’aide sont également accessibles via l’archive d’aide ou via les sujets d’aide du menu principal de l’administration de la boutique.

D’ailleurs, ce manuel est également lié en PDF dans la version la plus récente dans l’aide en ligne.

Utilisation

Côté client

1. Le client place des articles dans le panier
2. Il ou elle entre dans la caisse et entre ici les données d’adresse et sélectionne “Facture avec SwissBilling” comme mode de paiement (ce mode de paiement est affiché pour la Suisse et la Principauté du Liechtenstein lorsque le total du panier est inférieur à la limite maximale individuellement convenue avec SwissBilling.
3. Le client voit la confirmation de commande
4. Le client accepte les conditions générales
5. SwissBilling affiche la sélection du type d’adresse et de facture ou signale une décision de risque négative qu’un autre mode de paiement doit être sélectionné.

1. La transaction SwissBilling est terminée. Le client est de retour dans votre PepperShop et y voit la page “merci”. Si le module d'évaluation d’articles est installé, le client peut maintenant également donner des évaluations.

Administration de la boutique

Traitement des commandes

Si une commande a été reçue qui est payée via SwissBilling, le commerçant peut supposer que ce montant sera reçu. Il peut immédiatement commencer le traitement ultérieur de la commande. Si toutes les marchandises sont disponibles, le colis peut être préparé et affranchi¹. Dans ce cas, le statut de commande est ajusté à “expédié”.

Vous pouvez sélectionner le nouveau statut dans le menu déroulant “Statut de commande”, ou cliquer sur le bouton “Expédier”. Toujours lors du passage au statut “expédié”, cette action est exécutée.

La boutique envoie maintenant au client un e-mail avec la note que sa commande est expédiée.

Attention : SwissBilling ne libérera la transaction pour la facturation que lorsque la commande a été explicitement confirmée chez SwissBilling. C’est automatiquement le cas si vous cliquez manuellement sur le statut de commande “expédié” dans l’administration de la boutique et dans la configuration du module SwissBilling, le point “Confirmer la transaction” = “À l’expédition” est défini.

Info : Voir aussi le manuel PepperShop “Procédure après réception d’une commande".

Info : Si un client annule la commande. Veuillez également supprimer la commande dans l’administration de la boutique. Cela provoque dans la configuration par défaut une annulation des niveaux de stock dans PepperShop.

Si vous visualisez une commande dans la gestion des clients (clic sur le bouton “afficher”), vous pouvez voir toutes les réponses de la communication avec SwissBilling en bas. Voir une capture d'écran d’exemple dans le chapitre Annexe 1.

Connexion ERP / Enterprise Business Connector / Intégration Caller

Si PepperShop est utilisé dans la version Enterprise, vous pouvez soit envoyer les messages Acknowledge vous-même, soit plus simple : Utiliser l’API set_lieferstatus. Si ‘Confirmer la transaction’ est configuré à ‘À l’expédition’ dans le module, vous pouvez simplement spécifier le numéro de facture et le statut de commande = 0020 dans l’import de statut de livraison. La boutique change alors le statut de cette commande à expédié et envoie automatiquement l’appel Acknowledge à SwissBilling. Voir aussi Annexe 3 comme exemple.

Info sur l’export de commande : Le mode de paiement des commandes payées via SwissBilling est ‘swissbilling’.

Évaluation de la communication SwissBilling via les journaux

La boutique web enregistre tous les appels à SwissBilling qui n’ont pas été complétés avec succès, ainsi que tous les appels Acknowledge, Cancel et Credit. Ainsi, les données pertinentes devraient être disponibles pour tout problème pour trouver l’origine (principalement pour un rejet dans le processus de commande). Les journaux peuvent être trouvés comme suit : _‘Administration de la boutique’ > ‘Modules’ > ‘Log Viewer’ _(voir image).

Installation

Exigences système

Pour utiliser le module SwissBilling, un PepperShop v.3.0 Standard ou Connect est requis. Ce module est disponible en option et ne fait pas partie de la portée de livraison standard.

Copier et télécharger les fichiers

Le module SwissBilling consiste essentiellement en quatre fichiers qui doivent être copiés dans votre PepperShop installé. D’abord, extrayez l’archive ZIP fournie. Les fichiers suivants sont inclus, montrés ici avec les répertoires cibles :

{shopdir}/shop/swissbilling_def.php
{shopdir}/shop/swissbilling_caller.php
{shopdir}/shop/swissbilling_payment.php
{shopdir}/shop/Admin/module/swissbilling

Les fichiers peuvent être facilement téléchargés vers le serveur web via (S)FTP ou SCP. Le placeholder {shopdir} représente le répertoire du shop sur le serveur web, où le fichier index.php ainsi que le fichier README.txt peuvent être trouvés.

Installation du module

Après avoir copié les fichiers, vous pouvez aller dans l’administration de la boutique et passer au menu Modules là.

Ici, vous cliquez sur “Gestion des modules PepperShop” et voyez ensuite l’affichage suivant avec les modules et leur statut d’installation :

Ici, nous cliquons sur SwissBilling dans la fenêtre de gauche et ensuite sur le Bouton* ‘Installer’*. Nous confirmons le processus d’installation en cliquant sur le bouton ‘*Retour à la gestion des modules’*. Le module est maintenant listé sur le côté droit ‘Modules déjà installés’.

Installation du Log Viewer

Avant d’utiliser maintenant la fonctionnalité SwissBilling, nous devons également installer le module externe PepperShop “Log Viewer” (si cela n’a pas déjà été fait), car il est utilisé par le module SwissBilling. Nous cliquons maintenant là sur le bouton intitulé Gestion des modules PepperShop et effectuons l’installation de manière analogue au module SwissBilling.

Après l’installation du Log Viewer, il apparaît maintenant également dans la fenêtre de droite.

Info : Le module SwissBilling n’utilise pas de fichiers journaux rotatifs. Il est recommandé de supprimer les journaux de temps en temps.

Nous revenons maintenant au menu principal de l’administration de la boutique : Cliquez respectivement sur Retour à l’administration des modules et Retour au menu principal.

Liste blanche / Livraison de facture sans transmission à SwissBilling

Souvent, il est souhaité de fournir encore classiquement certains segments de clients avec une facture. C’est ce qu’on appelle ‘whitelisting’. Les comptes clients dans la boutique peuvent donc être modifiés en définissant le champ ‘Livraison de facture’ = ‘Oui’.

À partir de ce moment, les clients avec ce paramètre se voient également offrir la “Facture” classique en plus du mode de paiement “Facture avec SwissBilling”. Les commandes via ce type de facture ne sont pas transmises à SwissBilling. La facture peut alors être générée vous-même, par exemple avec le module PDF PepperShop et l’option module Bordereaux de versement.

Codes d’erreur SwissBilling

• NULL: Limite débiteur dépassée
• 100: Adresse de facturation et de livraison
• 101: Pas de livraison physique
• 102: Vérification de la limite de transaction marchande échouée
• 103: Le débiteur n’est pas autorisé à la facturation
• 104: Le débiteur a une facture impayée
• 105: Le débiteur n’est pas autorisé à la facturation
• 106: Limite débiteur dépassée
• 107: Vérification de la limite de transaction marchande
• 108: Le débiteur n’est pas autorisé à la facturation
• 110: Le débiteur est sur liste noire / L’ip du débiteur est sur liste noire
• 111: IP rejetée dans les 5 derniers jours

Notes importantes pour la communication écrite avec les clients

Attention : Veuillez vous assurer que les conditions suivantes sont remplies :

• Ne pas afficher le numéro de facture sur le bon de livraison
• Ne pas spécifier les données de connexion bancaire/postale sur le bon de livraison
• Ne pas inclure votre propre facture, seulement un bon de livraison

Questions ouvertes ?

Veuillez d’abord vous demander quel partenaire (PepperShop ou SwissBilling) pourrait le mieux répondre à votre question et le contacter. Pour les questions liées à PepperShop, le forum client est disponible avec des réponses rapides et compétentes 24 heures sur 24 :

http://www.peppershop.com, les coordonnées SwissBilling peuvent être trouvées sur http://www.swissbilling.ch.

Annexe 1 : Exemple de commande avec communication SwissBilling

Annexe 2 : Codes de statut SwissBilling acceptés par la boutique

SwissBilling est interrogé à nouveau pour le statut actuel de la transaction avant que la commande ne soit prise en charge. Il y a diverses réponses ici. Cependant, PepperShop n’accepte que les deux codes de statut suivants en exploitation productive :

• Answered
• Acknowledged

En exploitation de test, le code suivant est également accepté :

• Test approved

Toutes les autres réponses de statut font que la boutique marque la transaction comme échouée et signale un message d’erreur correspondant au client.

En plus de la vérification du code de statut SwissBilling, une comparaison de la devise et du montant de la facture (sans les coûts de facturation SwissBilling) est effectuée lors du traitement de la réception de commande. Si ces valeurs diffèrent, la transaction n’est également pas acceptée par la boutique.

Annexe 3 : Exemple d’import de ‘set_lieferstatus’ pour la version Enterprise

Dans l’exemple suivant, les commandes avec les numéros de facture spécifiés reçoivent le statut de paiement

Contenu du fichier (fichier texte set_lieferstatus_inp.csv) :

Rechnungs-Nr;Bestellung-Status
RE548361;0020
RE548362;0020
RE548363;0020
RE548364;0020
RE548365;0020

Affichage dans Excel / OpenOffice.org :

Info : Attention, lorsque le document est ouvert dans Excel / OpenOffice.org, les programmes ont tendance à effectuer une sélection automatique de type de données par colonne. Dans le processus, la colonne ‘Statut de commande’ est généralement détruite - de 0020 elle devient par ex. 20.

Aide supplémentaire

Avez-vous des questions ou avez-vous besoin d’assistance ? Avez-vous des exigences particulières ou souhaitez-vous une solution individuelle pour votre système ? Notre équipe de support se fera un plaisir de vous aider. Les prestations de support sont facturées au temps passé au tarif de CHF 195.- / heure. Voici comment nous joindre :

• E-Mail : support@glarotech.ch
• Téléphone : +41 (0)71 923 08 58
• Heures d’ouverture : Lundi – Vendredi I 08:00h – 12:00h I 13:30h – 17:00h

Autres pages utiles

• FAQ (Foire aux questions)
• Modules & Fonctions
• Interfaces