Contenu
Voir aussi
Comment configurer votre compte ?
Vous devez vous rapprocher de votre responsable de compte partenaire Cetelem pour obtenir les informations nécessaires permettant de configurer votre compte sur Payline (compte marchand avec un numéro de contrat).
Ensuite veuillez adresser un email à notre équipe support@payline.com avec les informations, afin qu'ils puissent 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 'pilote' pour valider le bon fonctionnement en production.
Vous devez modifier le paramètre "Délai de paiement"=32 du point de vente utilisant le moyen de paiement Cetelem 3x4x, ceci pour éviter d'avoir des dossiers non finalisées.
Comment proposer le paiement Cetelem 3xCB / 4xCB à vos clients ?
Les principes d’utilisation
Une fois le moyen de paiement activé, il vous suffit d'utiliser l'API Webpayment et les services doWebPayment et getWebPaymentDetails avec une version 14 ou supérieure.
La fonctionnalité de paiement à la commande est disponible en renseignant le champ payment.mode à CPT et payment.action à 101.
Les autres fonctions de l'API ne sont pas disponibles pour ce moyen de paiement.
Authentification 3D Secure
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.
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 champs obligatoires
Pré-renseigner les informations personnelles du consommateur sur les pages Cetelem
Vous pouvez transmettre les informations en votre possession afin de simplifier l'acte de paiement en 3xCB ou 4xCB de votre client. Les pages de paiement Cetelem utiliseront ces informations pour pré-renseigner les champs du formulaire.
Le tableau ci-dessous précise la liste des informations personnelles à transmettre. Le format indique le type et la longueur maximale autorisée. Si aucun format n'est indiqué, il faut se référer à la nomenclature Payline du service doWebPayment.
Voir le détail des objects : buyer, billingAddress, shippingAddress.
Information | Nom du champ de l'API WebPayment Payline | Format | Obligatoire | Commentaires |
---|---|---|---|---|
Civilité du consommateur | buyer.title | AN4 | X | voir la nomenclature des valeurs |
Nom du consommateur | buyer.lastName | AN40 | X | cf. restrictions de saisie définies ci-dessous |
Prénom du consommateur | buyer.firstName | AN40 | X | cf. restrictions de saisie définies ci-dessous |
Nom de la personne à facturer | buyer.billingAddress.lastName | AN40 | X | cf. restrictions de saisie définies ci-dessous |
Prénom de la personne à facturer | buyer.billingAddress.firstName | AN40 | X | cf. restrictions de saisie définies ci-dessous |
Adresse de facturation | buyer.billingAddress.street1 | AN60 | X | Le caractère [;] n’est pas autorisé |
Complément d'adresse de facturation | buyer.billingAdress.street2 | AN60 | Le caractère [;] n’est pas autorisé | |
Code postal de l'adresse de facturation | buyer.billingAddress.zipCode | AN5 | X | |
Ville de l'adresse de facturation | buyer.billingAddress.cityName | AN30 | X | Le caractère [;] n’est pas autorisé |
Pays de l'adresse de facturation | buyer.billingAddress.country | AN5 | X | |
Nom de la personne à livrer | buyer.shippingAddress.lastName | AN40 | X | cf. restrictions de saisie définies ci-dessous |
Prénom de la personne à livrer | buyer.shippingAddress.firstName | AN40 | X | cf. restrictions de saisie définies ci-dessous |
Adresse de livraison | buyer.shippingAddress.street1 | AN60 | X | Le caractère [;] n’est pas autorisé |
Complément d'adresse de livraison | buyer.shippingAddress.street2 | AN60 | Le caractère [;] n’est pas autorisé | |
Code postal de l'adresse de livraison | buyer.shippingAddress.zipCode | AN5 | X | |
Ville de l'adresse de livraison | buyer.shippingAddress.cityName | AN30 | X | |
Pays de l'adresse de livraison | buyer.shippingAddress.country | AN5 | X | |
Adresse e-mail du consommateur | buyer.email | AN150 | X | cf. restriction de saisie définies ci-dessous |
Numéro de téléphone du consommateur | buyer.mobilePhone | AN15 | X |
La référence commande doit être en format l’alphanumérique (pas de caractères spécial accepté).
Les champs firstName, lastName ne peuvent contenir que les caractères suivants
- Les lettres de l’alphabet [A-Za-z] (de A à Z en minuscules ou majuscules) ;
- Les lettres accentuées suivantes [àâáãäçèéêëîìíïôòóöùûúü] en minuscules ou majuscules ;
- Le caractère [-] est accepté à condition de ne pas être en début ou en fin ;
- Le caractère espace [ ] quelque soit sa position ;
- Le caractère d’apostrophe [‘] est accepté à condition de ne pas être en début ou en fin.
Tout caractère, autre que ceux cités précédemment, n'est pas autorisé.
La valeur doit contenir au moins 2 caractères.
Les champs email doivent être constitués de la manière suivante
Email au format user@host
La partie user ne peut contenir que les caractères suivants :
- Les lettres de l’alphabet [A-Za-z] (de A à Z en minuscule ou majuscule).
- Les chiffres [0-9] (de 0 à 9).
- L’ underscore [_]
- Le tiret [-]
- Le point [.]
- Le plus [+]
La partie host ne peut contenir que les caractères suivants :
- Les lettres de l’alphabet [A-Za-z] (de A à Z en minuscule ou majuscule).
- Les chiffres [0-9] (de 0 à 9).
- Le point [.]
- Se terminant par un point suivi de 2 à 6 caractères alphabétique [A-Za-z] (de A à Z en minuscule ou majuscule)
Comment réaliser des tests ?
Les données de tests vous seront communiquées par Cetelem avec votre compte de tests.
Les codes de retour
Avec l'API WebPayment, Payline vous informe du résultat d'un paiement via le shortmessage des services : 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).
Les codes spécifiques au moyen de paiement sont listés içi.