Table des matières
Cetelem FullCB
Informations générales sur Cetelem FullCB
Cetelem FullCB ou Cetelem 3xCB/4xCB est également connu sous le nom de BNPP PF FullCB (BNP Paribas Personal Finance FullCB). Le mode de paiement Cetelem 3x/4x 3x/4x FullCB permet aux consommateurs de payer en 3 ou 4 mensualités les achats en ligne d'une valeur comprise entre 90 € et 3 000 € avec des cartes de débit CB, Visa ou Mastercard. Le commerçant est assuré de recevoir le montant total de la transaction une fois que la demande de crédit est approuvée/validée par Cetelem. Les cartes de crédit acceptées sont les suivantes : Cartes Bancaires (CB), VISA France et MasterCard France. Les autres marques de cartes comme Electron, Maestro, les cartes prépayées et les cartes virtuelles ne sont pas acceptées. Une fois le paiement approuvé, le titulaire de la carte est débité de 1/3 ou 1/4 du prix d'achat, puis sa carte de paiement est débitée sur une base mensuelle pour les échéances restantes. Le commerçant est payé le montant total de la commande dans les 48 heures suivant la demande de recouvrement. Les paiements sont garantis. |
Schéma de déroulement du processus
Interface plateforme de paiement
Formats des données : a alphabétique as alphabétique avec caractères spéciaux n numérique an alphanumérique ans alphanumérique avec caractères spéciaux ns numérique avec caractères spéciaux bool expression booléenne (true ou false) 3 longueur fixe avec 3 chiffres/caractères ..3 longueur variable avec maximum 3 chiffres/caractères enum énumération de valeurs admissibles dttm Date et heure ISO (AAAA-MM-JJThh:mm:ss) Abréviations : CND condition M obligatoire (mandatory en anglais) O optionnel C conditionnel Remarque : Veuillez noter que les noms des paramètres peuvent être en majuscules ou en minuscules.
Paiement avec Cetelem FullCB via l'interface de formulaire plateforme de paiement
Pour effectuer un paiement avec Cetelem FullCB, appelez l'adresse URL ci-dessous :
Remarque : Pour des raisons de sécurité, plateforme de paiement rejette toutes les demandes de paiement contenant des erreurs de formatage. Veuillez par conséquent utiliser le type de données correct pour chaque paramètre.
Le tableau ci-dessous décrit les paramètres de demande de paiement chiffrés :
Paramètre | Format | CND | Description |
---|---|---|---|
MerchantID | ans..30 | M | ID du commerçant. Ce paramètre doit également être transféré non chiffré. |
TransID | ans..64 | M | Numéro de transaction du commerçant, ce numéro doit être univoque |
RefNr | an12 | M | Numéro de commande , ce numéro doit être univoque. Seuls les caractères suivants sont autorisés :
Remarque : en l’absence de RefNr, TransID sera utilisé à la place. Dans ce cas, TransID doit donc respecter le format et la longueur de RefNr. Remarque : Si le dossier est déjà accepté (=Paiement OK avec valeur déjà utilisée), la transaction suivante est alors rejetée. |
Amount | n..10 | M | Montant indiqué dans la plus petite unité de la devise (par ex. les centimes pour l'euro) Veuillez contacter notre service d'assistance si vous souhaitez capturer des montants < 100 (plus petite unité de la devise). |
Currency | a3 | M | Devise, trois caractères DIN / ISO 4217. Seul EUR est autorisé. |
MAC | an64 | M | Code d'authentification de message haché (HMAC) avec algorithme SHA-256 |
URLSuccess | ans..256 | M | Adresse URL complète qui appelle plateforme de paiement en cas de réussite du paiement. L'URL ne peut être appelée que par le port 443. Cette URL ne peut contenir aucun paramètre : pour échanger des valeurs de paramètre entre plateforme de paiement et la boutique, veuillez utiliser le paramètre UserData. |
URLFailure | ans..256 | M | Adresse URL complète qui appelle plateforme de paiement en cas d'échec du paiement. L'URL ne peut être appelée que par le port 443. Cette URL ne peut contenir aucun paramètre : pour échanger des valeurs de paramètre entre plateforme de paiement et la boutique, veuillez utiliser le paramètre UserData. |
Response | a7 | O | État de la réponse envoyée par plateforme de paiement à URLSuccess et URLFailure, doit être chiffré. À cette fin, transmettez le paramètre Response=encrypt. |
URLNotify | ans..256 | M | Adresse URL complète appelée par plateforme de paiement pour notifier le résultat de paiement à la boutique. L'URL ne peut être appelée que par le port 443. Elle ne peut contenir aucun paramètre : utilisez le paramètre UserData pour ce faire. |
UserData | ans..1024 | O | Si indiqué sur la demande, plateforme de paiement transmet le paramètre à la boutique avec le résultat du paiement |
ReqID | ans..32 | O | Pour éviter les paiements en double, saisissez une valeur alphanumérique qui identifie votre transaction et ne peut être attribuée qu’une seule fois. Si la transaction est à nouveau soumise avec le paramètre ReqID identique, la plateforme de paiement n’exécute pas le paiement et se contente de retourner le statut de la transaction d’origine. Attention : Plateforme de paiement doit afficher un statut de transaction finalisée pour la première action initiale. Les introductions avec un ReqID identique pour un statut ouvert sont traitées à intervalles réguliers. |
OrderDesc | ans..768 | M | Description des marchandises et des prix. Destination prévue sur le relevé de compte. |
SellingPoint | ans..50 | O | Point de vente |
Service | ans..50 | O | Produits ou services vendus |
Channel | ans..64 | O | Canal de configuration du contrat PPRO (Account et ContractID sont enregistrés au sein du système). Si ce paramètre est disponible, il remplace le cas échéant les canaux enregistrés au sein du système. |
Plain | ans..50 | O | Valeur à définir par le commerçant pour retourner des informations non chiffrées, par ex. la MID |
Custom | ans..1024 | O | Le commerçant peut introduire plusieurs valeurs séparées par un | qui sont ensuite retournées non chiffrées et séparées par un &. Custom=session=123|id=456 devient dans la réponse Session=123&id=456 |
PayType | n1 | M | Le mode de paiement Cetelem qui sera utilisé. 1 → Cetelem3xCB, 2 → Cetelem4xCB |
EnhancedData | ans..400 | O | Données spécifiques du commerçant, basées sur l'accord entre le BNPP PF FullCB et le commerçant. Le format ci-dessous est utilisé : VARIABLE_NAME1=VALUE| VARIABLE_NAME2=VALUE|… |
Informations sur le client | |||
Salutation | a..4 | M | Valeurs acceptées : M, Mme, Mlle et avec un mappage du titre anglais vers français (Mr, Mrs, Miss) |
FirstName | ans..40 | M | Prénom de l'acheteur |
LastName | ans..40 | M | Nom de l'acheteur |
ans..100 | M | Adresse e-mail de l'acheteur | |
Phone | ans..30 | M | Numéro de téléphone de l'acheteur Les formats autorisés sont :
Seuls les indicatifs régionaux suivants sont acceptés : 33 |
CustomerInformation | ans..400 | O | Données spécifiques susceptibles d'être fournies pour des actions spécifiques, sur la base de l'accord entre le BNPP PF FullCB et le commerçant. Format ci-dessous : VARIABLE_NAME1=VALUE| VARIABLE_NAME2=VALUE|… La plate-forme de paiement transmet simplement ces informations sans aucune validation. |
Adresse de facturation | |||
bdFirstName | ans..40 | M | Prénom au sein de l'adresse de facturation |
bdLastName | ans..40 | M | Nom au sein de l'adresse de facturation |
bdStreet | ans..60 | M | Nom de rue et numéro au sein de l'adresse de facturation |
bdAddressAddition | ans..60 | O | Ligne d'adresse supplémentaire/complémentaire |
bdZip | n..5 | M | Code postal au sein de l'adresse de facturation. |
bdCity | ans..40 | M | Localité au sein de l'adresse de facturation |
bdCountryCode | a2 | M | Code de pays au sein de l'adresse de facturation alphanumérique à 2 caractères, conformément à ISO-3166-1 |
Shipping address | |||
UseBillingData | a..3 | M | Utilisation des données de facturation comme données d'expédition (oui/non) – si oui, tous les paramètres d'adresse d'expédition sont obligatoires sauf « sdAddressAddition » |
sdFirstName | ans..40 | O | Prénom au sein de l'adresse de livraison |
sdLastName | ans..40 | O | Nom au sein de l'adresse de livraison |
sdStreet | ans..60 | O | Nom de rue et numéro au sein de l'adresse de livraison |
sdAddressAddition | ans..60 | O | Ajout de l'adresse dans l'adresse de livraison – également facultatif si « UseBillingData » est vrai / oui |
sdZip | n..5 | O | Code postal au sein de l'adresse de livraison |
sdCity | ans..40 | O | Localité au sein de l'adresse de livraison |
sdCountryCode | a2 | O | Code de pays au sein de l'adresse de livraison alphanumérique à 2 caractères, conformément à ISO-3166-1 |
Le tableau suivant décrit les paramètres de réponse que plateforme de paiement transmet à URLSuccess ou URLFailure et URLNotify. Si vous avez spécifié le paramètre Response=encrypt, les paramètres suivants sont transmis à votre système avec chiffrement Blowfish :
Paramètre | Format | CND | Description |
---|---|---|---|
MID | ans..30 | M | ID du commerçant |
PayID | an32 | M | ID attribuée au paiement par plateforme de paiement, par ex. pour le référencement au sein des fichiers batch |
XID | an32 | M | ID attribuée par plateforme de paiement pour toutes les différentes transactions pour un paiement |
TransID | ans..64 | M | Numéro de transaction du commerçant, ce numéro doit être univoque |
RefNr | an12 | M | Numéro de commande , ce numéro doit être univoque. Seuls les caractères suivants sont autorisés :
Remarque : en l’absence de RefNr, TransID sera utilisé à la place. Dans ce cas, TransID doit donc respecter le format et la longueur de RefNr. Remarque : Si le dossier est déjà accepté (=Paiement OK avec valeur déjà utilisée), la transaction suivante est alors rejetée. |
Status | a..30 | M | OK si URLSuccess et AUTHORIZE_REQUEST, ou FAILED si URLFailure |
Description | ans..1024 | M | Détails supplémentaires en cas d'échec du paiement. Veuillez ne pas utiliser le paramètre Description mais bien le paramètre Code pour une analyse de l'état de la transaction ! |
Code | n8 | M | Code d'erreur conformément au fichier Excel des codes de réponse plateforme de paiement |
MAC | an64 | M | Code d'authentification de message haché (HMAC) avec algorithme SHA-256 |
UserData | ans..1024 | O | Si indiqué sur la demande, plateforme de paiement transmet le paramètre à la boutique avec le résultat du paiement |
PaymentPurpose | ans..26 | M | Motif du paiement |
PaymentGuarantee | a..12 | C | NONE = pas de garantie de paiement, VALIDATED = compte client valide mais pas de garantie de paiement, FULL = garantie de paiement Remarque : ce paramètre n'est retourné que si l'état est = OK. |
ErrorText | ans..256 | C | Message d'erreur PPRO détaillé. Remarque : n'est retourné que si l'état = FAILED. Utilisation possible uniquement après concertation avec le Support. |
TransactionID | an..14 | M | Identifiant externe de la demande de paiement |
CodeExt | n2 | M | Code de retour de la demande de crédit |
PID | an..25 | M | Identifiant externe de la demande de transaction |
Plain | ans..50 | O | Valeur à définir par le commerçant pour retourner des informations non chiffrées, par ex. la MID |
Custom | ans..1024 | O | Le commerçant peut introduire plusieurs valeurs séparées par un | qui sont ensuite retournées non chiffrées et séparées par un &. Custom=session=123|id=456 devient dans la réponse Session=123&id=456 |
Note de crédit avec référence
Les notes de crédit (remboursements) sont possibles via une connexion de serveur à serveur. Pour une note de crédit avec référence à une capture, le montant de ladite note de crédit est limité au montant de la capture précédente.
Pour exécuter une note de crédit avec une transaction de référence, veuillez utiliser l'adresse URL suivante :
Remarque : Pour des raisons de sécurité, plateforme de paiement rejette toutes les demandes de paiement contenant des erreurs de formatage. Veuillez par conséquent utiliser le type de données correct pour chaque paramètre.
Le tableau ci-dessous décrit les paramètres de demande de paiement chiffrés :
Paramètre | Format | CND | Description |
---|---|---|---|
MerchantID | ans..30 | M | ID du commerçant. Ce paramètre doit également être transféré non chiffré. |
PayID | an32 | M | ID attribuée par plateforme de paiement pour le paiement à créditer |
TransID | ans..64 | M | Numéro de transaction du commerçant, ce numéro doit être univoque |
Amount | n..10 | M | Montant indiqué dans la plus petite unité de la devise (par ex. les centimes pour l'euro) Veuillez contacter notre service d'assistance si vous souhaitez capturer des montants < 100 (plus petite unité de la devise). |
Currency | a..3 | M | Code pour la devise, trois caractères DIN / ISO 4217 |
MAC | an64 | M | Code d'authentification de message haché (HMAC) avec algorithme SHA-256 |
ReqID | ans..32 | O | Pour éviter les paiements en double, saisissez une valeur alphanumérique qui identifie votre transaction et ne peut être attribuée qu’une seule fois. Si la transaction est à nouveau soumise avec le paramètre ReqID identique, la plateforme de paiement n’exécute pas le paiement et se contente de retourner le statut de la transaction d’origine. Attention : Plateforme de paiement doit afficher un statut de transaction finalisée pour la première action initiale. Les introductions avec un ReqID identique pour un statut ouvert sont traitées à intervalles réguliers. |
Le tableau ci-dessous décrit les paramètres de réponse de plateforme de paiement :
Paramètre | Format | CND | Description |
---|---|---|---|
MID | ans..30 | M | ID du commerçant, attribué par BNP Paribas |
PayID | an32 | M | ID attribuée au paiement par plateforme de paiement, par ex. pour le référencement au sein des fichiers batch |
XID | an32 | M | ID attribuée par plateforme de paiement pour toutes les différentes transactions (autorisation, capture, note de crédit) pour un paiement |
TransID | ans..64 | M | Numéro de transaction du commerçant, ce numéro doit être univoque |
Status | a..30 | M | OK ou FAILED |
Description | ans..1024 | M | Détails supplémentaires en cas d'échec du paiement. Veuillez ne pas utiliser le paramètre Description mais bien le paramètre Code pour une analyse de l'état de la transaction ! |
Code | n8 | M | Code d'erreur conformément au fichier Excel des codes de réponse plateforme de paiement |
TransactionID | an..14 | M | Identifiant externe de la demande de paiement |
CodeExt | n2 | M | Code de retour de la demande de crédit |
PID | an..25 | M | Identifiant externe de la demande de transaction |