Manuel utilisateur de la fonction scoring cheque Version 1.C Payline PROPRIETAIRE Page 1/12 Version du modèle : DocStd_50
Page des évolutions Le tableau ci-dessous liste les dernières modifications effectuées sur ce document. Date Version Modifications 01/06/10 1. A Livraison version initiale 17/02/12 1.B Mise aux nouvelles couleurs Monext 19/02/13 1.C Nouvelles copies d écran et API décrite
Table des matières 1 INTRODUCTION...4 1.1 OBJET DU DOCUMENT...4 1.2 PUBLIC VISÉ...4 1.3 AVERTISSEMENT...4 1.4 CONTACT...4 2 PRINCIPE GENERAL...5 2.1 FONCTIONNALITÉS...5 2.2 TERMINAL DE PAIEMENT VIRTUEL (TPEV)...5 2.2.1 Ecran accueil du TPEV...5 2.2.2 Choix du moyen de paiement...6 2.2.3 Saisie des données chèque...6 2.2.4 Résultat du scoring cheque...6 2.3 CENTRE ADMINISTRATION...7 2.4 MODE API: WEB SERVICE DOSCORINGCHEQUE...8 2.4.1 Requête à envoyer...8 2.4.2 Requête en réponse...10 3 CODES RETOUR LIE AU SCORING CHEQUE...12 3.1 SCORING CHEQUE...12
1 Introduction 1.1 Objet du document Ce document décrit l utilisation du moyen de paiement scoring cheque, il permet de valider les chèques de vos clients 1.2 Public visé Ce document est destiné aux commerçants qui utilisent la solution de paiement Payline.. 1.3 Avertissement Ce document est la propriété exclusive de Monext. Toute reproduction intégrale ou partielle, toute utilisation par des tiers, ou toute communication à des tiers, sans accord préalable écrit de Monext est illicite. Monext, marque communautaire et internationale propriété exclusive de Monext Ltd et/ou des sociétés du groupe. Payline, marque nationale et internationale propriété exclusive de Monext et/ou des sociétés du groupe. 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.
2 Principe general 2.1 Fonctionnalités L utilisation du moyen de paiement scoring cheque est disponible à tous les commerçants Payline. Il permet de vérifier que les chèques reçus par vos clients ne figurent dans le fichier National des chèques irréguliers. Pour activer cette fonctionnalité, le commerçant souscrit un contrat auprès de l organisme «Vérifiance» et le transmettra au support Payline. Ce moyen de paiement est disponible sur les interfaces : Terminal de paiement Virtuel Centre Administration En mode API : en utilisant le webservice «doscoringcheque» 2.2 Terminal de Paiement Virtuel (TPEV) 2.2.1 Ecran accueil du TPEV
2.2.2 Choix du moyen de paiement Dans le cas où le commerçant a configuré plusieurs contrats de type «CHEQUE», il doit pouvoir sélectionner le contrat sur lequel il va faire la demande de scoring Cheque. 2.2.3 Saisie des données chèque L écran suivant invite l utilisateur à entrer les données nécessaires au scoring cheque Le numéro de chèque (Piste ISO) et la référence sont des données obligatoires. 2.2.4 Résultat du scoring cheque
2.3 Centre administration Etape 1 : Formulaire «Choisir un moyen de paiement» La saisie de transaction manuelle à partir du centre d administration est possible. L écran permettant de choisir le type de transaction et le contrat utilisé ne change pas. Les contrats de type CHEQUE s ajouteront automatiquement à la liste des contrats (en supposant évidemment que le contrat CHEQUE a été au préalable créé sur le point de vente choisi). Seuls les types de transactions suivants sont possibles avec un contrat CHEQUE : Autorisation. Si un autre type de paiement est choisi, le message d erreur suivant est affiché : «Type de transaction non autorisé pour ce type de contrat (CHEQUE)». Etape 2 : Saisie des données chèque Cet écran permet à l acheteur de remplir les données nécessaires au Scoring cheque. Sur ce formulaire le commerçant doit renseigner le numéro de cheque. Il clique ensuite sur le bouton Valider.
Etape 3 : Affichage résultat transaction Cet écran ne change pas, le code retour et le message d erreur est affiché, ainsi que l id de la transaction et son état (acceptée ou refusée). 2.4 Mode API: Web service doscoringcheque Ce Web Service permet au commerçant de vérifier la validité d un chèque bancaire. 2.4.1 Requête à envoyer Le message «doscoringchequerequest» doit avoir la structure suivante : Elément Commentaire Requis Type Exemple version Version des web services Payline Oui 1 N1 A valoriser à la valeur 3 Requis depuis 2011 payment.amount le montant du chèque. Le montant doit oui N12 pour un montant de 60, être formulé dans la plus petite unité de vous devez mettre la la devise. valeur 6000. payment.currency le code ISO de la devise du paiement oui N3 978 : euros 840 : dollars US cf. liste complète en annexe tableau «Liste des devises» payment.action Code de la fonction de paiement oui N3 100 : Autorisation payment.mode Mode CPT oui AN3 CPT : Comptant payment.contractnum Le numéro du contrat de paiement qui oui AN50 ber représente un moyen de paiement payment.differedaction Date effective de l action. Elle doit être non 2 AN8 Format à respecter : Date inférieure à la date du jour + 7 jours. dd/mm/yy
Elément Commentaire Requis Type Exemple media Détection du média utilisé lors du Non 1 AN25 Mobile paiement Les valeurs possibles de cette balise sont : Internet Mobile Tablet TV Console Undefined cheque.number Numéro de chèque oui N35 order.ref Référence de la commande. Cette oui AN50 12345678 référence doit être unique car elle est utilisée pour le contrôle des doublons. order.origin Origine de la commande (utilisée non 3 AN50 SVI_#12 uniquement si vous avez souscrit à l option Mail Order et Téléphone Order) order.country Le code du pays dans lequel la non AN3 FR commande a été effectué order.taxes Le montant des taxes sur la commande non N12 la valeur 100 correspond dans la plus petite unité de la devise à 1 order.amount Le montant de la commande dans la oui N12 la valeur 100 correspond plus petite unité de la devise. à 1 Généralement le même montant que payment.amount order.currency Le code de la devise utilisée lors de la oui N3 978 : euros commande. 840 : dollars US cf. liste complète en annexe tableau «Liste des devises» order.date La date de la commande chez le oui AN18 Format à respecter : commerçant dd/mm/yyyy HH24:mi privatedatalist Vos propres informations personnelles non Tableau «PrivateData» 1 - Evolution livrée en octobre 2012, dans la version V4.31 de Payline. 2 - Lorsque le champ payment.mode prend la valeur «DIF», la date payment.differedactiondate est obligatoire. Dans les autres modes de paiement, ce champ doit être vide. 3 - Si vous avez souscrit à l option Mail Order et Telephone Order MO TO et elle est activée, alors la valeur de l attribut order.orign sera «MO» ou «TO».
Pour chaque donnée privée (PrivateData) : Elément Commentaire Requis Format Exemple key La clé qui vous permet de filtrer vos Oui AN50 User transactions de paiement value La valeur associée à la clé Oui AN50 dupond or durand, etc 2.4.2 Requête en réponse Le message «doscoringchequeresponse» est la réponse faite par Payline à une demande de scoringcheque. Il vous permet d obtenir, entre autres, le numéro unique de la transaction sur Payline et de connaître la validité du chèque. La réponse a la structure suivante : Elément Description Format Exemple result.code Le code de retour du web service : N5 cf. liste complète en annexe tableau «Liste des codes retours» 00000 : Transaction approved 014xx : Invalid Cheque 02101 : Internal Error result.shortmessage Message court du résultat de la AN50 transaction result.longmessage Message du résultat de la AN255 transaction transaction.id Identifiant unique de la AN50 transaction Payline transaction.ispossiblefrau d Cet indicateur est calculé en fonction des critères définis par le commerçant AN1 1 = Il existe un risque de fraude 0 = Aucun risque de fraude détecté transaction.isduplicated Cet indicateur est retourné par AN1 1 = Il existe un risque de fraude Payline dans le cas de 0 = Aucun risque de fraude détecté transaction en doublon transaction.date Date et heure de la transaction AN16 Format : dd/mm/yy HH24:MI Payline transaction.fraudresult Code de la fraude AN50 transaction.explanation Motif du refus en cas de fraude AN50 transaction.score Scoring de la possibilité de N5 Score de 0 à 10 fraude scoringcheque.chequenu Numéro de cheque à valider N35 mber scoringcheque.terminalid Identifiant du terminal de N3 Ex : 001 paiement
Elément Description Format Exemple result.code Le code de retour du web service : N5 cf. liste complète en annexe tableau «Liste des codes retours» 00000 : Transaction approved 014xx : Invalid Cheque 02101 : Internal Error scoringcheque.additionalp rivatedata Code couleur permettant de connaitre validité du chèque AN 50 Tableau «codes données privées» Tableau des codes donnés privées pour le scoringcheque : Code couleur Description Code résultat correspondant VERT Le chèque ne fait l'objet d'aucune cf. liste complète en annexe tableau interdiction ORANGE Alerte sur le compte cf. liste complète en annexe tableau ROUGE Chèque irrégulier cf. liste complète en annexe tableau BLANC Chèque non référencé cf. liste complète en annexe tableau ABONNE REFUSE Abonné refusé cf. liste complète en annexe tableau APPEL IMPOSSIBLE Appel impossible cf. liste complète en annexe tableau ERREUR CHEQUE Erreur chèque cf. liste complète en annexe tableau IDC INCORRECT IDC incorrect cf. liste complète en annexe tableau
3 Codes retour lié au scoring cheque 3.1 Scoring cheque Code Payline Signification 00000 Réponse Vert : pas d'interdiction 01401 Réponse Orange : opposition sur le compte (transitoire) 01402 Réponse Rouge : chèque irrégulier 01403 Réponse Blanc : chèque non référencé 01404 Numéro d'abonné (IDCF) incorrect 01405 Erreur serveur FNCI 01406 Piste CMC7 incorrecte 01407 Numéro IDC incorrect 01430 Numéro de chèque incorrect Erreur temporisateur interne MIGO Non réponse du serveur RESIST Serveur RESIST indisponible 01942 Transaction refusée