Arborescence des pages



Contenu


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 Monext Online (compte marchand avec un numéro de contrat).
Ensuite veuillez adresser un email à notre équipe support avec les informations, afin qu'ils puissent procéder au paramétrage dans votre compte commerçant Monext Online en indiquant l’ID commerçant 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.

Contactez le support Monext Online.


Le code (card_code) du moyen de paiement est : FCB3X ou FCB4X


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 ?

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 services doRefund, transactionsSearch et getTransactionDetails sont également disponibles.
Les autres fonctions de l'API ne sont pas disponibles pour ce moyen de paiement.

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

FormatObligatoireCommentaires

Civilité du consommateur

buyer.title

AN4Xvoir la nomenclature des valeurs

Nom du consommateur

buyer.lastName

AN40Xcf. restrictions de saisie définies ci-dessous

Prénom du consommateur

buyer.firstName

AN40Xcf. restrictions de saisie définies ci-dessous

Nom de la personne à facturer

buyer.billingAddress.lastName

AN40Xcf. restrictions de saisie définies ci-dessous

Prénom de la personne à facturer

buyer.billingAddress.firstName

AN40Xcf. restrictions de saisie définies ci-dessous

Adresse de facturation

buyer.billingAddress.street1

AN60XLe 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

AN5X

Ville de l'adresse de facturation

buyer.billingAddress.cityName

AN30XLe caractère [;] n’est pas autorisé

Pays de l'adresse de facturation

buyer.billingAddress.country

AN5X

Nom de la personne à livrer

buyer.shippingAddress.lastName

AN40Xcf. restrictions de saisie définies ci-dessous

Prénom de la personne à livrer

buyer.shippingAddress.firstName

AN40Xcf. restrictions de saisie définies ci-dessous

Adresse de livraison

buyer.shippingAddress.street1

AN60XLe 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

AN5X

Ville de l'adresse de livraison

buyer.shippingAddress.cityName

AN30X

Pays de l'adresse de livraison

buyer.shippingAddress.country

AN5X

Adresse e-mail du consommateur

buyer.email

AN150Xcf. restriction de saisie définies ci-dessous

Numéro de téléphone du consommateur

buyer.mobilePhone

AN15X
Données de scoringmiscData

Doit contenir les données spécifiées par Cetelem

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

Les données de scoring

Cetelem recommande la transmission de ces données afin d'améliorer l'acceptation de la demande de paiement.

Il s'agit de données dont le contenu et la syntaxe sont fournis par Cetelem.

Payline transmet ce champ tel que, au système d'information 'Cetelem 3xCB / 4xCB'.

Pour tout détail, contactez votre support Cetelem.


Les données de scoring sont concaténées dans une chaîne de caractères incluse dans un champ JSON référencé par la clé scoringData ce champ appartenant lui même à une structure référencée par le numéro de contrat Cetelem 3xCB / 4xCB (dans l'exemple ci-dessous, le numéro de contrat est FCB3X.

    <impl:miscData>
        {
            "FCB3X":
                "{
                    'scoringData':
                    'CNEW=1# DE=code device# MT=19864#RETURN_URL=HTTP://WWW.merchant.com/return_url#'
                }"
        }
    </impl:miscData>

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

Monext Online vous informe du résultat d’un paiement via le ShortMessage, selon le mode d'intégration proposé par le moyen de paiement. 

Les états retournés :

  • Le paiement est accepté avec l'état ACCEPTED et le code retour 00000.
  • Le paiement est refusé avec l'état REFUSED. Le code varie en fonction du motif de refus (Par exemple : 01xxx pour une raison bancaire ou 04xxx pour une suspicion de fraude).

La gestion des états et des codes retour sont listés ici.


Le résultat d'une demande de paiement

Une demande de paiement peut être acceptée, refusée ou abandonnée.

ShortMessage Payline

Détail Payline

Description

ACCEPTED

00000

Le paiement est accepté

REFUSED

02020

Le paiement est refusé par Cetelem

CANCELLED02319

Le consommateur a abandonné le paiement

REFUSED

02324

La session de paiement a expiré. Le paiement est abandonné.


Specificité

Transmettre le numéro d'agrément du marchand à Cetelem dans une donnée privée avec la clé AGR. Cetelem peut ainsi aiguiller les paiements des différents magasins d'un compte.

Référence dossier propre à Cetelem

Payline vous retourne la référence de dossier Cetelem dans le champ externalTransactionID des fonctions getWebPaymentDetails et getTransactionDetails.