Contenu
Sommaire | ||||
---|---|---|---|---|
|
Plus d'information
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.
Avertissement |
---|
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.
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 | |
Données de scoring | miscData | Doit contenir les données spécifiées par Cetelem |
Avertissement |
---|
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
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 |
CANCELLED | 02319 | Le consommateur a abandonné le paiement |
REFUSED | 02324 | La session de paiement a expiré. Le paiement est abandonné. |
Spécificité
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.
Pages associées
Contenu par étiquette | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|