Guide utilisateur du moyen de paiement MaxiCheque Version 1.B Payline Monext Propriétaire Page 1 / 15
Page des évolutions Le tableau ci-dessous liste les dernières modifications effectuées sur ce document. Date Version Modifications 29/01/2013 1.A Livraison version initiale 13/12/2013 1.B Validation par MaxiCheque Monext Propriétaire Page 2 / 15
Table des matières 1. Introduction... 4 1.1. Objet du document... 4 1.2. Public visé... 4 1.3. Liste des documents de référence... 4 1.4. Contact... 4 2. Présentation... 5 2.1. Qu'est ce que MAXICHEQUE?... 5 2.2. Comment proposer MAXICHEQUE à mes clients... 6 2.2.1. Pré requis... 6 2.2.2. Intégration MAXICHEQUE en homologation... 6 2.2.3. Intégration MAXICHEQUE en production... 7 2.3. Quelles sont les fonctionnalités de paiements disponibles... 7 2.4. Cinématique de paiement MaxiChèque par page WEB... 7 2.5. Cinématique d un remboursement MaxiChèque... 7 3. Utiliser MAXICHEQUE sur votre boutique... 8 3.1. Réaliser un paiement MaxiChèque par pages de paiement... 8 3.1.1. Appel au web service DoWebPayment... 8 3.2. Les pages de paiement vues par le consommateur...10 4. Gérer vos transactions MAXICHEQUE...12 4.1. Configurer l ordre d affichage du moyen de paiement MAXICHEQUE...12 4.2. Analyser le résultat d un paiement MAXICHEQUE...13 4.3. Gestion et reporting des transactions...15 4.3.1. Suivi des transactions depuis le backoffice Payline... 15 4.3.2. Fichier reporting... 15 Monext Propriétaire Page 3 / 15
1. Introduction 1.1. Objet du document Ce document est un guide d intégration du moyen de paiement MaxiCheque dans la plateforme de paiement Payline. 1.2. Public visé Ce document est destiné aux commerçants et intégrateurs qui souhaitent utiliser le moyen de paiement MaxiCheque dans la solution de paiement Payline. 1.3. Liste des documents de référence La documentation suivante est disponible sur notre site internet section documentation : www.payline.com ou sur simple demande auprès de notre service support : support@payline.com 1.4. Contact Vous avez besoin d aide, de conseil ou vous souhaitez simplement nous poser une question. Contactez l Assistance Payline par : Email : support@payline.com Pour toute question liée à la mise en place de la solution Payline, vous pouvez joindre notre assistance technique par mail support@payline.com, du lundi au vendredi de 09h00 à 18h00. Monext Propriétaire Page 4 / 15
2. Présentation 2.1. Qu'est ce que MAXICHEQUE? MaxiCheque est un moyen de paiement par chèque cadeau sur Internet. Il est utilisable auprès des sites commerçants adhérents. 2.1.1. Côté client : «J offre un MaxiCheque en quelques clics sur MaxiChequePro.com!» Je choisis mon MaxiCheque Je personnalise mon MaxiCheque Je renseigne les coordonnées du bénéficiaire Je crée mon compte et je paye en CB / virement Mon MaxiCheque est envoyé instantanément par mail à mon/mes Bénéficiaires 2.1.2. Côté bénéficiaire : «Je reçois et j utilise mon MaxiCheque» Monext Propriétaire Page 5 / 15
2.2. Comment proposer MAXICHEQUE à mes clients 2.2.1. Pré requis Vous devez au préalable avoir souscrit un contrat auprès de MaxiCheque.com. Support MaxiCheque : contact.kit@maxicheque.com 09 62 53 27 05 2.2.2. Intégration MAXICHEQUE en homologation Lors de votre souscription, MaxiCheque.com réalisera la création d un compte de test MaxiCheque et vous transmettra, ainsi qu au support Payline, une clef marchand de test ainsi qu une clef marchand de production. A réception de cet email, notre équipe support réalisera la mise en place d un moyen de paiement MaxiCheque sur votre compte commerçant Payline d homologation puis un email vous sera envoyé pour vous confirmer la création du moyen de paiement MaxiCheque sur votre compte Payline. Grâce à votre numéro de contrat Payline figurant sur le moyen de paiement MaxiChèque, vous pouvez commencer vos tests sur Payline. Une fois vos tests de paiements MaxiChèque réalisés avec succès sur l environnement d homologation Payline, votre qualification s achève. Pour terminer votre intégration MaxiChèque en pré production, il vous faut informer le support Payline de la fin de votre qualification et de votre souhait de passage en production en écrivant à cette adresse : support@payline.com Notre équipe vous transmettra un PV de recette pour valider la fin de votre qualification. Monext Propriétaire Page 6 / 15
2.2.3. Intégration MAXICHEQUE en production A réception du PV de recette signé et complété par vos soins, le support Payline réalise la création du moyen de paiement MaxiChèque sur l environnement de production Payline. Vous recevrez un email vous avertissant de la mise en place du moyen de paiement en production Payline. 2.3. Quelles sont les fonctionnalités de paiements disponibles Les fonctionnalités de paiement et remboursement sont disponibles avec ce moyen de paiement. Le paiement simple avec validation immédiate est disponible par : Pages WEB de paiement Le remboursement peut se réaliser par : Interface Directe : Web Services Le centre d administration 2.4. Cinématique de paiement MaxiChèque par page WEB Le paiement par MaxiChèque sur les pages Web de paiement Payline suit cette cinématique : Vous effectuez un appel au web service «dowebpayment» Le client est redirigé vers les pages web de paiement Payline Le client choisi le moyen de paiement MaxiChèque Payline redirige le client vers maxicheque.com en mode redirection ou iframe Le client se connecte, saisie le(s) MaxiChèque(s) à utiliser et effectue son paiement Le client a la possibilité de compléter la somme via le moyen de paiement CB si elle est insuffisante Payline affiche le ticket de paiement 2.5. Cinématique d un remboursement MaxiChèque Le remboursement avec MaxiChèque peut se réaliser en mode direct ou depuis le Centre d Administration : Vous pouvez effectuer un remboursement via le web service «dorefund» ou effectuer un remboursement via le centre d administration depuis le menu «Gestion des transactions» Payline envoie la demande de remboursement à MaxiChèque. Payline affiche le résultat du remboursement Monext Propriétaire Page 7 / 15
3. Utiliser MAXICHEQUE sur votre boutique Ce chapitre explique comment intégrer rapidement MaxiChèque via Payline dans votre boutique. Nous vous recommandons de réaliser chaque étape afin de garantir une bonne intégration de MaxiChèque dans Payline. 3.1. Réaliser un paiement MaxiChèque par pages de paiement 3.1.1. Appel au web service DoWebPayment L affichage des pages de paiement Payline nécessite simplement de contacter le service web «dowebpayment». Ce web service retourne à votre serveur l url sur laquelle vous devez rediriger votre client afin qu il réalise son paiement. 3.1.1.1. Champs et valeurs obligatoires Champs Valeur Format Requis Commentaire action 101 N3 Oui Action Autorisation + validation Exemple : <obj:action>101</obj:action> Mode CPT AN3 Oui Mode comptant Exemple : <obj:mode>cpt</obj:mode> ContractNumber AN50 Oui Numéro de contrat MaxiChèque selectedcontractnumber secondselectedcontractlist Non Non Exemple : <obj:contractnumber>maxichq</obj:contractnumber> Exemple : <impl:selectedcontractlist> <obj:selectedcontract>1234567</obj:selectedcontract> <obj:selectedcontract>maxichq</obj:selectedcontract> </impl:selectedcontractlist> privatedata Oui Cette balise doit être présente pour les paiements Maxichèque. La valeur «XXX» est à remplacer par votre famille de produit transmis par le support Maxichèque lors de votre souscription de contrat. <impl:privatedatalist> <!--0 to 100 repetitions:--> Monext Propriétaire Page 8 / 15
<obj:privatedata> <obj:key>productfamily</obj:key> <obj:value>xxx</obj:value> </obj:privatedata> </impl:privatedatalist> Enfin, dans le cas où vous souhaitez afficher uniquement les pages de paiement MaxiCheque, vous devez renseigner le champ «contractnumber» par le numéro de contrat que vous avez renseigné lors de la configuration du moyen de paiement. Monext Propriétaire Page 9 / 15
3.2. Les pages de paiement vues par le consommateur Sur votre site d e-commerce, votre client clique sur le bouton «payer» pour procéder au paiement de sa commande. Votre site contacte Payline pour effectuer une transaction. Payline renvoi un jeton de session et l URL à utiliser pour rediriger votre client vers les pages web Payline. Dans le cas de l interface direct, le choix du moyen de paiement sera effectué sur le site marchand. Cette page n apparait pas. Etape 1 Le client choisi le paiement MAXICHEQUE et valide. Etape 2 Le client est redirigé vers la page de saisie de ses identifiants MAXICHEQUE, que ce soit via les pages web de paiement ou l interface direct. Monext Propriétaire Page 10 / 15
Puis vers la page de sélection du ou des MaxiCheque pour le paiement de sa commande Monext Propriétaire Page 11 / 15
4. Gérer vos transactions MAXICHEQUE Ce chapitre explique comment intégrer rapidement MAXICHEQUE via Payline dans votre boutique. Nous vous recommandons de réaliser chaque étape afin de garantir une bonne intégration de MAXICHEQUE dans Payline. 4.1. Configurer l ordre d affichage du moyen de paiement MAXICHEQUE Il est possible de configurer l ordre d affichage des moyens de paiements sur la page lors de l affichage des choix sur la page Web de paiements Cette configuration est faite a partir du centre d administration Payline, dans le menu Configuration, cliquez sur Vos points de vente. Dans le pavé Personnalisation du point de vente, cliquez sur le lien Définir l ordre des moyens de paiements. La liste des moyens de paiements s affiche et permet de faire monter ou descendre le moyen de paiement pour obtenir l ordre souhaité Monext Propriétaire Page 12 / 15
4.2. Analyser le résultat d un paiement MAXICHEQUE Payline vous informe du résultat d un paiement via le code retour des messages getwebtransactiondetails et gettransactiondetails. Lorsque le paiement est accepté, Payline renvoi le code retour à la valeur «00000». Pour un paiement refusé, le code varie en fonction du motif de refus Les codes spécifiques au moyen de paiement MAXICHEQUE sont listés dans le tableau ci-après. return_code short_message long_message 18000 No treatment TRAITEMENT (Interne) : Aucun traitement effectué 18001 Transaction accepted OK/SOLDE : Panier soldé (Vérification/Réservation) 18002 Transaction refused PAIEMENT PARTIEL : Montant maximum autorisé atteint 18003 Transaction refused PAIEMENT PARTIEL : Aucun MaxiCheque sélectionné 18004 Partial refused PAIEMENT PARTIEL : Paiement partiel 18005 Transaction refused PAIEMENT PARTIEL : Annulation des MaxiCheque réservés (Modification du panier) 18101 Transaction refused PARAMETRES : Paramètres du web service manquants 18102 Transaction refused PARAMETRES : Clé marchand incorrecte 18103 Transaction refused PARAMETRES : Transaction inexistante 18104 Transaction refused PARAMETRES : Montant du panier inférieur ou égal à 0 18105 Transaction refused PARAMETRES : Etat de la transaction incorrect 18110 Transaction refused CONNEXION : Erreur lors de l''appel du web service 18111 Transaction refused CONNEXION : Clé marchand de retour différente de celle d''envoi 18112 Transaction refused CONNEXION : Id Transaction de retour différente de celle d''envoi 18113 Transaction refused CONNEXION : Montant du panier de retour différent de celui d''envoi 18114 Transaction refused CONNEXION : URL marchand de retour différent de celui d''envoi 18115 Transaction refused SQL (Interne): Erreur SQL 18116 Transaction refused ADRESSE IP : Referer non reconnu 18117 Transaction refused ADRESSE IP : Adresse IP non reconnue 18120 Transaction refused MAXICHEQUE : Numéro de MaxiCheque Monext Propriétaire Page 13 / 15
incorrect 18121 Transaction refused MAXICHEQUE : Vérification email erronée 18122 Transaction refused MAXICHEQUE : MaxiCheque en Quarantaine (pendant 3 jours après l''achat) 18123 Transaction refused MAXICHEQUE : MaxiCheque refusé par ce marchand 18124 Transaction refused MAXICHEQUE : MaxiCheque déjà enregistré pour cette commande 18125 Transaction refused MAXICHEQUE : MaxiCheque reservé chez un autre marchand (restitution dans moins d''une heure) 18126 Transaction refused MAXICHEQUE : 1 seul MaxiCheque Découverte autorisé par commande 18127 Transaction refused MAXICHEQUE : Montant maximum autorisé atteint 18128 Transaction refused MAXICHEQUE : Compte refusé par ce marchand 18129 Transaction refused MAXICHEQUE : Famille(s) produits refusée(s) par MaxiCheque (préfix) 18130 Transaction refused MAXICHEQUE : Famille(s) produits refusée(s) par MaxiCheque (visuel) 18131 Transaction refused MAXICHEQUE : Le panier est soldé par les MaxiCheque sélectionnés 18999 Pending transaction MAXICHEQUE : Initialisation à une connexion 18006 Transaction accepted REMBOURSEMENT : Remboursement total (tous les MaxiCheque ont étés remboursés totalement) 18007 Partial transaction REMBOURSEMENT : Remboursement partiel (d''autres remboursements sont possible) 18106 Transaction refused REMBOURSEMENT : Demande de remboursement incorrecte (MaxiCheque inexistant pour cette transaction ou son état est invalide) 18107 Transaction refused REMBOURSEMENT : Le montant passé est invalide, trop élevé ou dépasse le montant réservé Monext Propriétaire Page 14 / 15
4.3. Gestion et reporting des transactions 4.3.1. Suivi des transactions depuis le backoffice Payline Sur le centre d administration vous avez la possibilité de visualiser la transaction effectuée avec le moyen de paiement MAXICHEQUE. 4.3.2. Fichier reporting Payline intègre les fichiers de reporting de MAXICHEQUE, ce qui permet le suivie dans le centre d administration les transactions MAXICHEQUE et de pouvoir retrouver ces informations dans le fichier de reporting consolidé. Ce fichier peut être : Soit généré manuellement via le centre d administration. Dans le menu Transactions de paiement, cliquez sur Exporter vos transactions. Soit généré en automatique quotidiennement en envoyé par un flux sécurisé. Monext Propriétaire Page 15 / 15