Cetelem 3x/4x

Introduction
Comme Cetelem propose différentes marques, plusieurs paymentProductId existent. Trouvez toutes les valeurs possibles dans le chapitre Intégration.
Cetelem 3x/4x est une solution de paiement en plusieurs fois proposée par Cetelem.
En offrant des plans de paiement flexible, vous rendez les achats de vos clients abordables, ce qui améliore votre taux de conversion et vos revenus. Vos clients peuvent choisir de répartir leur paiement en trois ou quatre versements égaux sur plusieurs mois. Vos clients saisissent leur carte (Visa, MasterCard ou Cartes Bancaires) et leurs informations personnelles sur le portail Cetelem. Cetelem facture ensuite automatiquement vos clients pour les versements individuels.
Cetelem 3x/4x externalise le risque de défaut de paiement, car Cetelem vous paie à l'avance et collecte les fonds auprès de vos clients.
L'intégration est très facile, car vous n'avez besoin d'envoyer que quelques paramètres supplémentaires avec votre requête.
Avantages clés
- Exigences PCI faibles
- Intégration facile
- Permet des remboursements partiels/multiples/complets
- Paiement garanti
Activation
Pour utiliser Cetelem dans notre environnement de test ou en production, suivez ces étapes :
- Signez un contrat avec Cetelem et recevez des identifiants d'activation en retour.
- Envoyez nous les identifiants d'activation (MID/mot de passe et éventuellement d'autres identifiants).
- Nous effectuons la vérification nécessaire à l'intégration et au provisionnement.
- Nous activons le moyen de paiement sur votre compte.
Intégration
Redirigez vos clients vers le portail Cetelem via notre page Hosted Checkout Page. Vous trouverez un aperçu générale dans le chapitre "Cinématique".
Ajoutez les propriétés suivantes à une requête standard CreateHostedCheckout :
{
"order": {
"amountOfMoney": {
"currencyCode": "EUR",
"amount": 103000
},
"customer": {
"personalInformation": {
"name": {
"title": "M",
"firstName": "SURICATE",
"surname": "MISTER"
},
"gender": "male",
"dateOfBirth": "19490917"
},
"companyInformation": {
"name": ""
},
"languageCode": "en",
"billingAddress": {
"street": "Desertroad",
"houseNumber": "13",
"additionalInfo": "b",
"zip": "84536",
"city": "Monument Valley",
"state": "Utah",
"countryCode": "US"
},
"shippingAddress": {
"name": {
"title": "M",
"firstName": "SURICATE",
"surname": "MISTER"
},
"street": "Desertroad",
"houseNumber": "1",
"additionalInfo": "Suite II",
"zip": "75001",
"city": "PARIS",
"state": "Utah",
"countryCode": "FR"
},
"contactDetails": {
"emailAddress": "wile.e.coyote@acmelabs.com",
"phoneNumber": "33607080910",
"faxNumber": "+33607080910",
"emailMessageType": "html"
},
"vatNumber": "1234AB5678CD"
},
"references": {
"merchantOrderId": "638116164638194750",
"merchantReference": "MH381603",
"invoiceData": {
"invoiceNumber": "0005400123",
"invoiceDate": "20140306191500"
},
"descriptor": "Fast and Furry-ous"
},
"typeInformation": {
"purchaseType": "physical"
},
"shoppingCart": {
"items": [
{
"amountOfMoney": {
"currencyCode": "EUR",
"amount": 103000
},
"invoiceData": {
"description": "ACME Super Outfit"
},
"orderLineDetails": {
"productName": "ACME12",
"discountAmount": 0,
"lineAmountTotal": 103000,
"productCode": "ASO45",
"productPrice": 103000,
"productType": "Fashion",
"quantity": 1,
"taxAmount": 0,
"unit": "piece"
}
}
]
}
},
"hostedCheckoutSpecificInput": {
"locale": "fr-FR"
},
"redirectPaymentMethodSpecificInput": {
"requiresApproval": true,
"paymentProductId": 5133,
"redirectionData.returnUrl":"https://yourReturnUrl.com"
}
}
Propriété | Remarques |
---|---|
order.amountOfMoney |
amount : Le montant total que vous souhaitez facturer pour cette commande. currencyCode : Le code de devise ISO 4217 pour ce montant. |
customer |
Les informations personnelles de vos clients. |
customer |
L'adresse de facturation/de livraison de vos clients. Si vous n'envoyez pas billingAddress, vos clients devront fournir ces données sur la page de paiement Cetelem. |
shoppingCart |
Le contenu du panier d'achat sous forme de tableau d'objets items. amountOfMoney.amount : Le montant total des items, calculé comme orderLineDetails.productPrice X orderLineDetails.quantity Assurez-vous de calculer la valeur de order.amountOfMoney.amount en additionnant toutes les instances de shoppingCart.items.amountOfMoney.amount |
hostedCheckoutSpecificInput.locale |
La langue de notre page Hosted Checkout Page. |
redirectPaymentMethodSpecificInput |
paymentProductId : L'identifiant numérique du moyen de paiement sur notre plateforme. Trouvez cet id dans la liste ci-dessous. Il indique à notre plateforme d'envoyer directement vos clients vers la page de paiement Cetelem. S'il est omis, notre plateforme envoie vos clients vers la page Hosted Checkout Page à la place, leur permettant de choisir ce moyen de paiement ou tout autre moyen de paiement activé dans votre compte. requiresApproval : Définissez sur "true"/"false" selon que vous souhaitez traiter les paiements en mode autorisation ("true")/vente directe ("false").
Assurez-vous de capturer la transaction autorisée ultérieurement. Ce n'est qu'alors que la transaction aura le status="CAPTURED" / statusOutput.statusCategory="COMPLETED" / statusOutput.statusCode=9, pour lequel vous recevez le paiement réel de la transaction.
|
Retrouvez des informations détaillées sur cet objet et ses propriétés dans notre documentation CreateHostedCheckoutAPI.
Liste des marques Cetelem disponibles
Marque | paymentProductId |
---|---|
Cetelem 3x Pour diviser le paiement en trois versements |
5133 |
Cetelem 4x Pour diviser le paiement en quatre versements |
5134 |
Cinématique
- Vos clients finalisent une commande dans votre boutique et sélectionnent Cetelem 3x/4x.
- Vous envoyez cette requête CreateHostedCheckout à notre plateforme.
- Vous redirigez vos clients via le redirectUrl vers le portail Cetelem. Ils confirment la commande avec leurs informations de carte et leurs informations personnelles.
- Nous recevons le résultat de la transaction.
- Nous redirigeons votre client vers votre returnUrl
- Vous demandez le résultat de la transaction à notre plateforme via GetHostedCheckout ou recevez le résultat via les webhooks.
- Si la transaction a réussi, vous pouvez livrer les marchandises / services.
- Cetelem facture automatiquement vos clients pour les versements restants dans les intervalles convenus.
Test
Consultez nos Cas de test pour des données de test et des instructions détaillées.
Assurez-vous d'utiliser le bon endpoint et de renseigner l'URL de production dès que vous avez terminé vos tests.