Contenu
Plus d'information
Comment configurer votre compte ?
Vous devez vous rapprocher de votre responsable de compte partenaire pour obtenir les informations nécessaires permettant de configurer votre compte sur Payline (num. magasin, key, merchant code).
Afin de créer le moyen de paiement CETELEM PRESTO sur Payline, en homologation et en production, 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 PRESTO.
Cliquez ensuite sur le bouton « Suivant ».
Ecran de création de moyen de paiement 2/2:
Renseigner un libellé, un numéro de contrat de votre choix puis sélectionner votre devise. Cliquez sur le statut « Actif » et renseigner les valeurs ci-dessous:
Le numéro de magasin ;
Key : indique le type de l'offre commerciale CLA ou CCH ;
Merchant Code : le commerçant est défini et identifié par Cetelem au niveau du contrat.
Vous devez réaliser des transactions tests pour valider le bon fonctionnement en production.
Comment proposer le paiement Cetelem Presto à vos clients ?
Les principes d’utilisation
Une fois le moyen de paiement activé, il vous suffit d'utiliser l'API Webpayment et les fonctions doWebPayment et getWebPaymentDetails avec une version 8 ou supérieure.
La fonctionnalité de paiement à la commande est disponible en renseignant le champ payment.mode à CPT et payment.action à 101.
Les services transactionsSearch, getTransactionDetails et getAlertDetails sont également disponibles.
Les autres fonctions de l'API ne sont pas disponibles pour ce moyen de paiement.
Les API DirectPayment, Ajax, Batch et TPEV ne sont pas disponibles.
Cetelem propose deux offres commerciales à ses commerçants :
- Produit de crédit classique (CLA) ;
- Produit de crédit classique (CLA) ET ouverture de compte renouvelable avec carte (CCH).
Le fonction de Remboursement est disponible avec le service doRefund de l'API Payline.
L’intégration de Cetelem Presto dans Payline consiste à :
- Contacter l’API Cetelem pour initialiser un dossier de crédit ;
- Rediriger le consommateur vers les pages de Cetelem ;
- Gérer le retour ou le non retour du consommateur (dossier accepté, refusé, abandonnée, etc.) ;
- Contacter l’API Cetelem pour obtenir le statut d’un dossier ;
- Gérer le statut « pending » et appeler le web service getWebPaymentDetails afin que le statut soit à jour.
Les notifications Payline
Le traitement des notifications est obligatoire pour tout commerçant voulant accepter les paiements Presto nécessitant une réponse différée.
Un dossier de financement Cetelem Presto nécessite une étude qui peut prendre plusieurs jours. Afin de vous prévenir de la mise à jour de l'état d'un dossier, Payline vous informe par notification lorsque le dossier passe à l'état accepté ou refusé. Le commerçant reçoit une notification WEBTRS pour lui permettre d’aller interroger le SI Payline à l’aide d’un getWebPaymentDetails et récupérer l’état de traitement du dossier.
Les notifications http (serveur à serveur) sont destinés aux commerçants : elles sont fortement préconisées et paramétrées au niveau de chaque point de vente.
Valeur notificationType | Déclencheur de la notification | Paramètres envoyés dans l’URL | Action à effectuer par le marchand |
WEBTRS | 1) Fin de traitement de la demande de paiement de l’acheteur (accord, refus, abandon) 2) Échéance du token web (*) et l’acheteur n’est pas revenu sur les pages Payline et pas de notification de Presto | token | Appel getWebPaymentDetails |
- Notification courriel : pour chaque demande de crédit Presto à la commande, Payline envoie en fonction de la configuration du point de vente un mail pouvant contenir le ticket au commerçant ou/et au vendeur (fonctionnement standard Payline).
Référence Cetelem
Payline indique la référence partenaire dans le champ ExternalTransactionID de Payline.
Identifiant acheteur
Il s’agit d’un identifiant Payline qui intervient comme critère de recherche d’une transaction Presto à partir du centre d’administration.
Payline utilise l’adresse mail de l’acheteur comme Identifiant acheteur.
Les réponses possibles d'un dossier
La balise Payline utilisée est :
| Code retour Payline | Renvoi acheteur | Statut dossier (Cetelem) | Commentaires & Action marchand |
|---|---|---|---|
| 02008 | Dossier refusé CancelURL | I Incomplet | L’acheteur a abandonné la demande de crédit. Payline refuse le paiement de la commande. Le commerçant ne procède à aucune expédition. |
| 02998 | Dossier refusé CancelURL | R Refusé | Cetelem refuse la demande de crédit. Payline refuse le paiement de la commande. Le commerçant ne procède à aucune expédition. |
| 00000 | Dossier accepté ReturnURL | G Garantie | Cetelem garantit le paiement au commerçant. Payline accepte le paiement de la commande. Le commerçant procède à l’expédition de la commande. |
| 02005 | Dossier en cours d’instruction ReturnURL | A (ou E) En cours d’instruction | Cetelem a créé un dossier de crédit, dont le résultat est communiqué ultérieurement. Payline retourne au commerçant un code retour avec un short message à ONHOLD_PARTNER. Le commerçant attend la notification d’acceptation du dossier de crédit (TRS) avant d’expédier la commande |
| 02012 | Dossier en erreur technique CancelURL | Toute autre valeur | Code retour de Presto inconnu.Ticket : paiement abandonné |
| 02000 | Pas de retour de Presto |
nouvelle api nouveau mpd presto 2 43030 Dossier refusé CancelURL L'acheteur souhaite modifier son adresse. Renvoi de l'acheteur sur les pages du marchand. Le commerçant doit revenir avec une nouvelle référence de commande une fois que l'acheteur a modifié ses données. V4.65 - Nouelle API sur un nouveau MDP.R Refusé
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.
Données acheteur disponible pour la constitution d’un dossier de crédit
Le tableau ci-dessous donne la liste des informations du dossier que peut fournir Payline s’ils sont donnés par le commerçant :
Paramètres | Requis | Balises Payline |
Civilité | Yes | buyer.Title |
Prénom | Yes | buyer.firstName |
Nom | Yes | buyer.lastName |
Nom de jeune fille | No | - |
Identifiant national | Yes | buyer.legalDocument |
Date de naissance | Yes | buyer.birthDate |
Adresse e-mail | Yes | buyer.email |
Numéro et rue de l’adresse | Yes | buyer.shippingAddress.street1 |
Complément d’adresse | Yes | buyer.shippingAddress.street2 |
Ville | Yes | buyer.shippingAddress.cityName |
Code postal | Yes | buyer.shippingAddress.zipCode |
Téléphone domicile | No | - |
Téléphone mobile | No | - |
Téléphone professionnel | No | buyer.shippingAddress.phone |
Vous pouvez consulter l'object buyer pour lister les valeurs possibles.
Le code matériel
Le code matériel caractérise le type d’achat effectué lors de la commande. Il est global à toute la commande.
Par exemple une commande composée de :
- Article 1 ; Électroménager ; 854,00€ ;
- Article 2 ; Loisir ; 575,00€ ;
- Article 3 ; Loisir ; 330,00€.
est caractérisée par Payline comme une commande ‘Loisir’.
Cela implique que le commerçant doit nécessairement alimenter le détail de la commande avec à minima les champs suivants :
order.orderDetail.category: le code produit de l'article (cf. tableau ci-dessous) ;order.orderDetail.price: le prix unitaire de l'article ;order.orderDetail.quantity: la quantité d'articles.
Le tableau ci-dessous donne les codes catégorie Payline à renseigner dans la demande de paiement :
Il vous faut obtenir un compte de test auprès de Cetelem-Presto.
Les données de tests vous seront communiquées par Cetelem avec votre compte de tests.
Pour obtenir un paiement accepté (A, E) :
Utiliser un compte (nom, prénom, @mail) vierge :
célibataire ;
> 35 ans ;
sans enfant ;
propriétaire de son logement ;
revenus confortables ;
pas de crédit en cours.
Pour obtenir un paiement refusé (R) :
Utiliser un compte (nom, prénom, @mail) déjà utilisé ;
Montant > 1500 €] ;
locataire ;
faibles revenus ;
crédits en cours.
Les codes de retour
Avec l'API WebPayment, Payline vous informe du résultat d'un paiement via le code retour des messages getWebPaymentDetails et getTransactionDetails.
Avec l'API DirectPayment, Payline vous informe du résultat de manière synchrone en réponse du doAuthorization.
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).