Page tree
Skip to end of metadata
Go to start of metadata



Contenu


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. Pour plus d'information sur les Notification par URL.

Valeur notificationType

Déclencheur de la notification

Paramètres envoyés dans l’URL

Action à effectuer par le marchand

WEBTRS

  • Après un doWebPayment, si le crédit est en cours d'instruction (non garanti et non refusé donc), une transaction de type { Commande } est créée. Elle est dans l'état "In progress" (code retour 02005)

  • Dans le même temps, une notification de type WEBTRS est envoyée au commerçant.
  • Une tâche est planifiée (batch consolidation) pour interroger le partenaire le lendemain (cf., plus haut, la ligne du tableau intitulée "Batch Consolidation").

Deux cas possibles :

1)    Suite à la demande d'initialisation du 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

TRS
  • Lorsque le financement est accepté par le partenaire, la tâche planifiée récupère l'information auprès de celui-ci.
  • Alors, une nouvelle transaction de type { Autorisation+Validation } est créée, et associée à la transaction de type { Commande }. Cette transaction est dans l'état "Approved" (code retour 00000).
  • Une notification de type TRS cette fois-ci est envoyée au commerçant.
transactionIdAppel getTransactionDetails

La durée de vie du token web pour les paiements Presto est 70 minutes et la durée d'inactivité maximale de la session est de 60 minutes.

  • 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 acheteurStatut dossier
(Cetelem)
Commentaires & Action marchand
02008

Dossier refusé

CancelURL

I IncompletL’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 GarantieCetelem 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 valeurCode retour de Presto inconnu.Ticket : paiement abandonné
02000Pas de retour de Presto





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.

Payline valorise cette donnée en déterminant dans la liste des articles commandés le code matériel Presto pour lequel la somme des montants des articles correspondants est la plus élevée.
Quand le même article est acheté plusieurs fois, Payline prend comme montant le prix des n articles.

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 :


Payline accepts numeric and alphanumeric product codes. Alphanumeric codes are not controlled by Payline, the merchant can use any value. Numeric codes must belong to the list below


Product CodeDescriptionFrench description (en français)
1Computer (hardware and software)Informatique (matériel et logiciel)
100010001ComputerOrdinateur
100010002PrinterImprimante
100010003To scanScanner
2Electronics - TV - HifiÉlectronique – TV - Hifi
20001VideoVidéo
200010001CamcorderCaméscope
200010002Video recorderMagnétoscope
200010003TVTV
200010004LCD screenÉcran LCD
200010005Plasma screenÉcran Plasma
200010006Home cinemaHome cinema
200010007HIFIHIFI
3PhoneTéléphone
4Home applianceÉlectroménager
40001ColdFroid
400010001FridgeRéfrigérateur
400010002FreezerCongélateur
40002WashingLavage
400020001DishwasherLave-vaisselle
400020002Washing machineLave-linge
400020003Tumble drierSèche-linge
40003bakingCuisson
400030001cookerCuisinière
400030002CooktopTable de cuisson
5Habitat and gardenHabitat et jardin
50001HeatingChauffage
500010001RadiatorRadiateur
50002sanitarySanitaires
50003window frameHuisserie
500030001ShutterVolet
50004Garden toolOutil de jardin
500040001MowerTondeuse
500040002tillerMotoculteur
500040003Chain sawTronçonneuse
500040004HedgeDébroussailleuse
599990001Kitchen delivered without layingCuisine livrée sans pose
599990002Kitchen deliveredCuisine livrée posée
6Fashion ClothingMode Habillement
7Beauty productProduit de beauté
8JewelryBijouterie
9SportSport
10HobbiesLoisirs
11Automobiles / motorcyclesAutomobiles / motos
110001QuadQuad
12furnishingAmeublement
120001Living room furnitureMobilier de salon
1200010001SofaCanapé
1200010002ArmchairFauteuil
1200010003cabinetArmoire
1200010004LibraryBibliothèque
120002Dining room furnitureMobilier salle à manger
120003BedroomChambre
1200030001BeddingLiterie
120004Office furnitureMobilier de bureau
120005Upholstery fabricTissu ameublement
120006Kitchen furnitureMobilier de cuisine
120007Bathroom furnitureMobilier de salle de bain
120008Garden furnitureMeuble de jardin
1200080001BarbecueBarbecue
13childrenEnfants
14Video gamesJeux vidéo
15ToysJouets
16AnimalsAnimaux
17FoodAlimentation
170001Food TRD eligible productsAlimentation produits éligibles TRD
170002Food products not eligible TRDAlimentation produits non éligibles TRD
18GiftsCadeaux
19ShowsSpectacles
20travelingVoyages
21AuctionEnchères
22Particular servicesServices aux particuliers
23Professional ServicesServices aux professionnels
24MusicMusique
240001Music instrumentInstrument de musique
2400010001PianoPiano
2400010002OrganOrgue
25BookLivre
26PhotoPhoto




Comment réaliser des tests ?


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).


Code

Short message

Long message

00000

ACCEPTED

Transaction approved

02005

ONHOLD_PARTNER

Transaction in progress, please wait for payment status.

02008

CANCELLED

Transaction canceled by user

02009

CANCELLED

To be reversed, Payline fallback process

02011*

ERROR

To be reversed in fallback mode

02012

ERROR

Unmatched partner return code

02102**

ERROR

External server communication error

02640

REFUSED

Credit refused by custommer

02998

REFUSED

Transaction refused

04001

PENDING_RISK

Transaction accepted

04002

REFUSED

Fraud Detected

CodeShortMessageLongMessage
43001ERRORThe service encountered an exception while trying to store the order information.
43002ERRORThe service encountered an exception while trying to store the order information.
43003ERRORError ¿ Exchange server error
43004ERRORError ¿ Subsidiary error
43005ERRORFatal error while querying web-service.
43006ERRORSome of the required parameters are invalid : <company code>, <country code>, <amount>, <material code>.
43007ERRORUnable to identify the company.
43008ERRORUnauthorized material code.
43009ERRORInvalid format for the desired guarantee. Authorized values are 0, 1, 2 and 3.
43010ERRORThe ¿bankCardType¿ field should be empty if financialProductType is ¿CLA¿.
43011ERRORUnhandlable request.
43012ERRORThe service encountered an exception while trying to retrieve the order information.
43013ERRORThe service was not able to retrieve the status of this loan application.
43014ERRORThe service encountered an exception while trying to retrieve the order information.
43015ERRORError ¿ Subsidiary error
43016ERRORFatal error while querying web-service.
43017ERRORSome of the required parameters are invalid : <company code>, <country code>, <cetelem transaction id>.
43018ERRORUnable to identify the company.
43019ERRORThere is no valid order information with this identifier.
43020ERRORThe service encountered an exception while trying to retrieve the order information.
43021ERRORThe service encountered an exception while trying to update the order information.
43022ERRORThe instance could not be written.
43023ERRORThe service encountered an exception while trying to update the order information.
43024ERRORError ¿ Subsidiary error
43025ERRORFatal error while querying web-service.
43026ERRORSome of the required parameters are invalid : <company code>, <country code>, <cetelem transaction id>, <webmerchant order id>.
43027ERRORUnknown company
43028ERRORThere is no valid order information with this identifier.
43029ERROROrder id received from client has an invalid format 
43100ERRORAt least one of the following parameters is missing: Category, Quantity or Price

 *02011 : Dans ce cas Payline retourne un message d’attente à l’acheteur l’invitant à se rapprocher du marchand, transfère l’acheteur sur la cancel URL et envoie la notification au marchand.

**02102 : Dans ce cas Payline refuse la transaction à l’acheteur et au commerçant, transfère l’acheteur sur la cancel URL et envoie la notification au marchand.