Contenu
Sommaire | ||||
---|---|---|---|---|
|
hidden | true |
---|
Le tableau ci-dessous liste les dernières modifications effectuées sur ce document.
Version
Modification
A
13/03/15
Création du document
1.B
17/03/15
Validation du document
Qu'est ce que Clearsale ?
ClearSale est un système de prévention de la fraude brésilien. Il s'agit d'un outil de scoring qui renvoit renvoie une valeur décrivant le risque associé à une commande et un statut (accepté, refusé ou en attente) de la commande analysée.
Les moyens de paiement éligibles au Brésil à cet outil de scoring pourront bénéficier de ClearSale dans Payline : Visa, Mastercard, Maestro, American Express et Boleto Bancario.
Cette fonction n'est proposée qu'aux marchands qui ont souscrit à cette option : "permettre l'appel au scoring externe".
Pour les marchands qui disposent de cette option, un bloc de configuration au niveau de contrat est ajouté pour le choix du module de scoring Ce bloc permet de configurer les paramètres pour la connexion vers le Scoring externe.
Vous devez être enregistré au préalable auprès de ClearSale.
Lors de votre souscription, ClearSale vous fournit un identifiant client unique pour votre compte marchand. Cet identifiant client ou « EntityCode » devra être transmis à Payline pour activer le module de scoring ClearSale via Payline.
Principe général
L’appel au module de scoring sera effectué en amont du LCLF pour tous les contrats qui ont souscrit à cette option.
Clearsale donne un avis (ok, ko, pending) et un score pour chaque transaction.
Les actions possibles en sortie du module LCLF diffèrent selon le moyen de paiement:
- Pour un paiement par carte, le résultat du LCLF est inchangé: aucun, 3dsecure, en attente pour analyse manuelle, refus.
- Pour Boleto Bancario, le résultat du LCLF est : aucun ou refus.
Dans tous les cas, Clearsale sera notifié du choix final de chaque commande : acceptation ou de refus du paiement.
Utiliser Clearsale sur sa boutique
Pour intégrer le module ClearSale via Payline dans votre site e-commerce, vous avez 3 actions à mener :
- Demander à notre équipe support l'activation du module ClearSale sur le ou les moyens de paiements que vous choisissez. Lors de cette demande, vous devez nous fournir votre identifiant ClearSale ou « EntityCode ».
- Mettre à jour les données transmises dans votre demande de paiement vers Payline :
- Ajouter le code JavaScript ClearSale si vous utilisez un Template hébergé ou sur vos propres pages de paiement ;
- Mettre à jour votre demande de paiement web service avec les données acheteurs de l'acheteur demandées par ClearSale.
- Créer des règles une règle anti fraude 'SCORE ANTI-FRAUDE' pour utiliser le résultat du scoring ClearSale.
Activation du module de scoring ClearSale
Dans un premier temps, vous devez contractualiser avec Clearsale (cf. contact commercial) et obtenir vos données de configuration (identifiant client ou EntityCode).
Vous pouvez ensuite contacter le support Payline pour activer le scoring ClearSale sur un ou plusieurs moyens de paiement : votre demande à notre équipe support devra être accompagnée des éléments suivants :
- Les numéros de contrat ou moyen de paiement Payline sur lesquels vous souhaitez activer le scoring ;
- Votre identifiant Client ClearSale.
Comment proposer ClearSale avec la demande de paiement
Utilisation du « devicefingerprint »
ClearSale utilise la technologie FingerPrint pour améliorer son dispositif de lutte contre la fraude. Aussi, ClearSale demande de fournir les informations de configurations matérielles et logicielles du terminal utilisé par l'acheteur.
Si vous utilisez l'interface directe Payline ou intégration Payline en mode Widget, direct ou basée sur un Template hébergé Payline, il vous faut ajouter ce code JavaScript sur votre page de paiement ou votre Template hébergé. Il faut également calculer un identifiant unique de session et y faire référence dans ce script (à la place du texte UNIQUE_SESSION_ID.
Ensuite, il faudra nous transmettre dans l'appel web service Payline « doAuthorization » ou « doWebPayment »« doWebPayment », la donnée correspondant à la valeur du « UNIQUE_SESSION_ID » dans la balise « buyer.fingerprintID ».
Bloc de code | ||||
---|---|---|---|---|
| ||||
<!-- BeginProfiling CSTags TagsStart--> <p<script stylesrc="background:url(https://h.online-metrix.net/fp/clear.png?org_id=k6dvnkdk&session_id=UNIQUE_SESSION_ID&m=1)"></p> <img src="https://h.online-metrix.net/fp/clear.png?org_id=k6dvnkdk&session_id=UNIQUE_SESSION_ID&m=2" alt=""> <scriptdevice.clearsale.com.br/v1.0.0/JS/FingerPrintLib.js" type="text/javascript"></script> <script type="text/javascript"> fp_lib_execute({ useIFrame: true, sessionId:"UNIQUE_SESSION_ID", key: "DEFAULT", technologies: "100" } ); </script> <img src="https://h.online-metrix.net/fp/check.js?org_id=k6dvnkdk&session_id=device.clearsale.com.br/v1.0.0/clearsale_logoweb_vert.png?SessionID=UNIQUE_SESSION_ID" alt="" typestyle="text/javascript"></script>display:none!important" /> <!-- End CSof the Profiling Tags --> <script> (function (a, b, c, d, e, f, g) { a['CsdpObject'] = e; a[e] = a[e] || function () { (a[e].q = a[e].q || []).push(arguments) }, a[e].l = 1 * new Date(); f = b.createElement(c), g = b.getElementsByTagName(c)[0]; f.async = 1; f.src = d; g.parentNode.insertBefore(f, g) }) (window, document, 'script', '//device.clearsale.com.br/p/fp.js', 'csdp'); csdp('app', 'ClientID'); csdp('sessionid', 'UNIQUE_SESSION_ID'); </script> |
Le numéro unique de session doit être alphanumérique (type CHAR) et avoir 128 octets. Les caractères valides sont des chiffres ou des lettres (majuscule ou minuscules), des tirets ou des blancs soulignés ([a-z], [A-Z], [0-9], _, -). Si vous intégrez Payline en mode web (Widget ou page de paiement), vous pouvez utiliser le jeton de session Payline comme identifiant uniqueLe script a jour est disponible sur le site de ClearSale.
Si vous utilisez les pages Web Payline standard ou avec une personnalisation avancée, vous n'avez pas à intégrer ce code JavaScript : Payline l'intègre nativement dans ses pages et transmet la valeur du « UNIQUE_SESSION_ID » directement à ClearSale.
Les données
acheteurs àde l'acheteur à transmettre à Payline
ClearSale réalise un contrôle à partir des données acheteurs que de l'acheteur que nous lui transmettons. Ces données ne sont pas obligatoires.
Pour que le scoring soit le plus performant possible, nous vous recommandons de fournir le maximum de ces d'informations dans les web services « doAuthorization » en interface directe ou « doWebPayment » en interface Web :
Extrait | ||
---|---|---|
| ||
N. | Structure | Description | Requis | Format | Commentaire |
---|---|---|---|---|---|
1 | Buyer.customerID | Identifiant client unique par acheteur | N | AN50 | Par exemple : 12AC45 |
2 | Buyer.legalStatus | Statut pour distinguer un particulier d'une entreprise | N | AN50 | Liste des valeurs possibles fournies en annexe |
3 | buyer.legalDocument | Libellé Numéro du document identifiant le consommateur | N | AN30Liste des valeurs possibles en annexe | Par exemple numéro du CPF ou CNPJ (numéro fisical) |
4 | buyer.birthDate | Date de naissance | N | Date | De la forme Format : YYYY-MM-DD |
5 | buyer.firstName | Prénom | N | AN50 | Par exemple : PédroPedro |
6 | buyer.lastName | Nom | N | AN50 | Par exemple : Almodo |
7 | buyer.streetNumber | Numéro de la rue | N | N | |
8 | buyer.shippingAddress.street1 | Adresse de livraison 1 | N | AN50 | |
89 | buyer.shippingAddress.street2 | Adresse de livraison 2 | N | AN50 | |
910 | buyer.shippingAddress.county | District ou ville de résidence | N | AN50 | Par exemple : Sao Paulo |
1011 | buyer.shippingAddress.cityName | Ville de résidence | N | AN50 | Par exemple : Sao Paulo |
1112 | buyer.shippingAddress.state | District | N | AN50 | Par exemple : Sergipe |
1213 | buyer.shippingAddress.zipCode | Code postal | N | AN50 | Par exemple : 49000999 |
1314 | buyer.shippingAddress.PhoneType | Type de téléphone de l'acheteur | N | AN50 | Liste des valeurs possibles en annexe |
1415 | buyer.billingAddress.county | District ou ville de résidence | N | AN50 | Par exemple : Arnapa |
1516 | buyer.billingAddress.PhoneType | Type de téléphone de l'acheteur | N | AN50 | Liste des valeurs possibles en annexe |
1617 | buyer.fingerprintID | Identifiant unique de session acheteur | N | AN50 | A remplir avec la valeur « UNIQUE_SESSION_ID » récupéré récupérée par le code JavaScript sur la page de paiement |
Définir vos règles
antifraudesanti-fraude
Pour exploiter le résultat du scoring ClearSale, vous devez créer à minima une règle de type « Appel d'un module de scoring » dans le module anti-fraude Payline.
Pour cela, rendez-vous dans le module anti-fraude Payline, dans la partie « Mes actions anti fraudes > Configurer mes règles », sélectionnez la règle « Appel d'un module de scoring » puis cliquez sur « Valider ».
Pour configurer la règle « Appel d'un module de scoring », vous devez renseigner 3 conditions de déclenchement :
- Un score de déclenchement minimum
- Un score de déclenchement maximum
- Un statut résultat du scoring ou « Avis »
Ancre ContactCommercial ContactCommercial
Contact commercial ClearSale
ContactCommercial | |
ContactCommercial |
Sirlei Aquino - Consultora Comercial
email : sirlei.aquino@clear.sale
téléphone fixe : +55 11 3728-8788 ramal 5023
téléphone mobile : +55 11 99550-4744
Skype : sirleicandidoaquino
Annexe
Liste des valeurs
possiblepour le champ « PhoneType»
Code Payline
Libellé court
0
Undefined
1
Home Phone
2
Work Phone
3
Messages
4
Billing Phone
5
Temporary Phone
6
Mobile Phone Code
Inclusion d'extrait | ||||||
---|---|---|---|---|---|---|
|
Liste des valeurs
Liste des valeurs possible pour le champ «LegalDocument »
Code Payline
Libellé court
1
CPF
2
CNPJ
3
RG
4
IE
5
Passport
6
CTPS
7
Voter ID Card
pour le champ «LegalStatus»
Code Payline | Libellé court |
---|---|
1 | Person |
2 | Company |