Vous devez vous rapprocher de votre responsable de compte Casino pour obtenir les informations nécessaires permettant de configurer votre compte sur Payline (Identifiants du compte et mot de passe). Vous pouvez procéder au paramétrage dans votre compte marchand Payline en indiquant l’ID Marchand et le nom de l’alias du contrat partenaire à créer. Vous devez réaliser des transactions tests pour valider le bon fonctionnement en production.
Afin de créer un moyen de paiement 3x4x Casino sur Payline, en homologation et en poduction, rendez-vous sur le centre d’administration dans l’onglet « Configuration » puis « Vos moyens de paiement ». Un écran de recherche s’affiche, cliquez sur le bouton « Nouveau moyen de paiement ».
Ecran de création de moyen de paiement 1/2:
Sélectionnez votre point de vente puis le type de moyen de paiement "Casino".
Cliquez ensuite sur le bouton « Suivant ».
Ecran de création de moyen de paiement 2/2:
Renseigner un libellé de votre choix par exemple "Casino", un numéro de contrat et un numéro de banque transmis par Casino puis sélectionner votre devise. Cliquez sur le statut « Actif » et n'activez pas le rejeu de la transaction ni la collecte du titulaire de la carte bancaire sans demande de l'équipe Support Payline. Renseignez ensuite vos informations bancaires.
Pour ces deux moyens de paiement, il est indispensable de renseigner 4 informations :
Identifiant STS
Mot de passe STS
Identifiant commerçant
Identifiant site commerçant
Si le contrat souscrit est un contrat 3DS ou non
Pour ces deux moyens de paiement, il est indispensable de renseigner 4 informations :
Identifiant STS
Mot de passe STS
Identifiant commerçant
Identifiant site commerçant
Si le contrat souscrit est un contrat 3DS ou non
REMARQUE Ces données sont fournies aux commerçants par Banque CASINO.
Comment proposer le paiement Casino 3xCB / 4xCB à vos clients ?
Le mode d'intégration est disponible avec l'API WebPayment : services doWebPayment et getWebPaymentDetail. Le mode d'intégration en API direct avec la fonction 3DS est disponible.
Les principes d’utilisation
Au moment dudoWebPayment, Payline réalise une demande d'éligibilité de paiement avant de proposer le moyen de paiement 3x ou 4x. Payline affiche les conditions de crédit : échéancier et CGV. Payline peut remplir les champs la date de naissance, département et nom de jeune fille s'ils sont fournis par le commerçant. Le moyen de paiement ne s'affiche pas si le score n'a pu être réalisé. L'échéancier s'affiche même en cas de données personnelles manquantes.
Les paiements Casino CB3x/CB4x sont éligibles au traitement par le module anti-fraude Payline, au même titre que les autres transactions. Si une authentification 3DSecure est nécessaire, Payline gère l’affichage de la page ACS. Seul un refus banque (FICP ou acquéreur) peut conduire à un refus du paiement. La fonction getWebPaymentDetail renvoie l’échéancier sélectionné par l'acheteur. Le marchand a la possibilité de modifier le montant de la commande après que le paiement ait été accepté. Le montant doit être inférieur ou égal à celui de la commande initiale .
Les web services en mode Web
Les servicesdoWebPaymentetgetWebPaymentDetailssont disponibles. L'objectPaymentsera transmis par le commerçant avec les valeurs Action = 101 et Mode = CPT. Le servicegetWebPaymentDetailsretourne l'échéancier : champ transaction.partnerAdditionalData avecpaymentSchedule. Cette fonction implique l'utilisation d'une baliseversionavec une valeur>= 16.
Le servicedoRefundpermet de rembourser la commande. La fonctiondoResetde l’API Payline permet au marchand de demander l’annulation totale ou partielle de la commande.
Les web services en mode Direct
Le mode d'intégration en API direct est disponible en utilisant le webserviceisRegistered.Ce service vous permet de récupérer le scoringdatanécessaire pour appeler le moyen de paiement Casino. Vous récupérezunregistrationTokenà renvoyer dans la demande de 3D SecureverifyEnrollmentpuis dans la demande de paiementdoAuthorization.
En entrée le commerçant indique le contrat, le montant, commande et les données personnelles. En retour, il reçoit un l'échéancier de paiement dont les frais de dossier et leregistrationTokenqui permettra de réaliser le paiement.
Les étapes :
Sur le site marchand, le consommateur valide son panier, puis le marchand appelle Payline avecle serviceisRegistered,
Paylineretourne un code02500 - Accepterpour valider la demande et renvoie leregistrationToken ainsi qu'une balise data contenant un objet JSON avec l'échéancierpaymentScheduleset le montanttotalAmount;
Puis il renvoie le jetonregistrationTokendans la balise payment en appelant leverifyEnrollmentpour réaliser le 3D Secure ;
Le consommateur saisie son mot de passe reçu par mobile ;
Le marchand réalise la demande de paiementdoAuthorizationavecregistrationTokendans la balise paymentet les données 3DS ;
Payline réalise la requête et la réponse du l'autorisation et renvoie une notification.
Lorsque un doAuthorization ou un verifyEnrollment est réalisé avec la balise registrationToken demandé qui est absente, vide ou incorrectement valorisée.
L'erreur suivante est remontée par le service : code 02999, short_message ERROR, long_message 'Invalid registration token'.
Exemples de web services
1. Branchement de la demande de scoring : isRegistered
Les paiements sont éligibles au traitement par le module anti-fraude Payline, au même titre que les autres transactions. Si une authentification 3DSecure est nécessaire, Payline gère l’affichage de la page ACS. Seul un refus banque (FICP ou acquéreur) peut conduire à un refus du paiement.
Les champs obligatoires
Les champs obligtoires doivent être renseignés lors de la demande de paiement, dans le cas contraire la demande sera refusée.
En complément des données obligatoires pour obtenir un paiement, vous devez transmettre les données obligatoires suivantes :
Code postal de la ville de naissance (1 ou 4 caractères refusés).
Facultatif : si non renseigné, Payline collectera cette information dans le formulaire
99 : si étranger 972 : pour la Martinique 06000 pour Nice et non 6000
CustomerMaidenName
Nom de jeune fille
Facultatif : si non renseigné, Payline collectera cette information dans le formulaire
OrderTag
Valeur du Tag de la commande (champ libre).
Facultatif.
Transmission des données clients
Pour transmettre les données 3DS, OTA, champs libre et historique, vous devez utiliser la balise <miscData></miscData> dudoWebPaymenten version 18 ou supérieure. Cette balise prend en compte un object JSON formaté qui sera retransmis à Casino. Les données OTA doivent être référencées par le numéro de contrat auquel elles font référence. Ces données sont facultatives.
Les balises<![CDATA[...]]>ne sont pas obligatoires.
Le numéro de contrat contenu dans le JSON doit être un numéro de contrat présent dans les balisesselectedContractListousecondSelectedContractList duservice doWebPayment appelé. S'ils ne sont pas non présent une erreur 'Invalid contractNumber' est levée avec le code retour 02303.
Le JSON doit être bien formaté de la manière suivante :
{"ContractNUMBER": "Contenu JSON ..."}
avec {"CASINO_3XCB":"{'optionalTravelDetails':{...}", 'additionalNumericFieldList':{...}",'additionalTextFieldList':{...}", 'MerchantCustomerHistory':{...}", }
Les données contenues dans le JSON correspondent aux données du service Score de Casino :
optionalTravelDetails
additionalNumericFieldList
additionalTextFieldList
MerchantCustomerHistory :
Champs
Description
Format
CanceledOrderAmount
Montant total en centimes des commandes annulées durant les 2 dernières années
Integer
CanceledOrderCount
Nombre de commandes effectuées puis annulées par le client durant les 2 dernières années
Integer
FirstOrderDate
Date de la première commande du client Format AAAA-MM-JJ
DateTime
FraudAlertCount
Nombre d’alertes de fraude concernant les commandes du client durant les 2 dernières années
Integer
LastOrderDate
Date de la dernière commande du client Format AAAA-MM-JJ
DateTime
PaymentIncidentCount
Nombre d’incidents de paiement concernant les commandes du client durant les 2 dernières années
Integer
RefusedManyTimesOrderCount
Nombre de commandes dont le paiement en plusieurs fois a été refusé au cours des 2 dernières années
Integer
UnvalidatedOrderCount
Nombre de commandes refusées dans la phase de validation au cours des 2 dernières années
Integer
ValidatedOneTimeOrderCount
Nombre de commandes ayant été réglées en 1 fois au cours des 2 dernières années
Integer
ValidatedOrderCount
Nombre de commandes validées ces 2 dernières années.
Vous devez demander un compte de test ainsi que des cartes de test à Banque Casino.
Pour pouvoir faire des tests sur l'API, vous pouvez utiliser la carte de test ci-dessous :
Numéro
5017670000001800
CVV
000
Date d'expiration
> à la dernière échéance
Les codes de retour
Avec l'API WebPayment, Payline vous informe du résultat d'un paiement via le code retour des messagesgetWebPaymentDetailsetgetTransactionDetails. Avec l'API DirectPayment, Payline vous informe du résultat de manière synchrone en réponse dudoAuthorization. Lorsque le paiement est accepté, Payline renvoie le code retour à la valeur 00000. Pour un paiement refusé, le code varie en fonction du motif de refus (Par exemple : 04xxx pour une suspicion de fraude).
Les codes spécifiques au moyen de paiement sont listés ci dessous.
Les codes spécifiques au moyen de paiement
État de la transaction
Code partenaire
Statut – code - Motif
autorisation réussi
0
ACCEPTED – 00000 – Transaction accepted
Refus - requête invalide
1
REFUSED – 02020 - Transaction refused by partner
Refus - autorisation refusée par la banque
2
REFUSED – 02020 - Transaction refused by partner
Échec technique
3
ERROR – 02106 - Payment partner error
En attente
4
ONHOLD_PARTNER – 02005 - Transaction in progress, please wait for payment status