Cofidis 3x/4x
Introduction
Comme Cofidis propose différentes marques, plusieurs paymentProductId existent. Trouvez toutes les valeurs possibles dans le chapitre Intégration.
Cofidis 3x/4x est une solution de paiement échelonné proposée par Cofidis.
En proposant des plans de paiement échelonnés flexibles, vous rendez les achats de vos clients abordables, ce qui améliore votre taux de conversion et votre chiffre d'affaires. Vos clients peuvent choisir de diviser leur paiement en trois ou quatre versements égaux sur plusieurs mois. Vos clients saisissent leurs coordonnées de carte (Visa, MasterCard ou Cartes Bancaires) et leurs détails personnels sur la page de paiement Cofidis. Cofidis prélève ensuite automatiquement vos clients pour les versements individuels.
Cofidis 3x/4x externalise le risque de défaut de paiement, car Cofidis vous paie à l'avance et collecte les fonds 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.
Activation
Pour utiliser Cofidis dans notre environnement de test/prod, suivez ces étapes :
- Signez un contrat avec Cofidis et recevez vos identifiants d'activation en retour.
- Envoyez les identifiants d'activation (MID/mot de passe et éventuellement d'autres identifiants) à nous.
- Nous effectuons les vérifications nécessaires de l'intégration et de l'approvisionnement.
- Nous activons la méthode de paiement dans votre compte.
France
Intégration
Redirigez vos clients vers la page de paiement Cofidis via notre Hosted Checkout Page. Vous trouverez une vue d'ensemble dans le chapitre "Cinématique".
Ajoutez les propriétés suivantes à une requête standard CreateHostedCheckout :
{
"order": {
"amountOfMoney": {
"currencyCode": "EUR",
"amount": 100000
},
"customer": {
"personalInformation": {
"name": {
"title": "Mr.",
"firstName": "Wile",
"surname": "Coyote"
},
"gender": "male",
"dateOfBirth": "19490917"
},
"billingAddress": {
"street": "Desertroad",
"houseNumber": "13",
"zip": "84536",
"city": "Monument Valley",
"state": "Utah",
"countryCode": "US"
},
"shippingAddress": {
"street": "Desertroad",
"houseNumber": "1",
"zip": "84536",
"city": "Monument Valley",
"state": "Utah",
"countryCode": "US"
},
"contactDetails": {
"emailAddress": "wile.e.coyote@acmelabs.com",
"phoneNumber": "0611111111"
}
},
"references": {
"merchantReference": "ORDERIDxx"
},
"shoppingCart": {
"items": [
{
"amountOfMoney": {
"currencyCode": "EUR",
"amount": 100000
},
"orderLineDetails": {
"productName": "ACME12",
"discountAmount": 0,
"lineAmountTotal": 100000,
"productCode": "ASO45",
"productPrice": 100000,
"productType": "Fashion",
"quantity": 1,
"taxAmount": 0,
"unit": "piece"
}
}
]
}
},
"hostedCheckoutSpecificInput": {
"locale": "fr_FR"
},
"redirectPaymentMethodSpecificInput": {
"requiresApproval": true,
"paymentProductId": 5129
}
}| Propriété | Remarques |
|---|---|
|
order.amountOfMoney |
amount : Le montant brut 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 |
Adresse de facturation/livraison de vos clients. Si vous n'envoyez pas billingAddress, vos clients devront fournir ces données sur la page de paiement Cofidis. |
|
shoppingCart |
Le contenu du panier d'achat sous forme de tableau d'objets items. amountOfMoney.amount : Le montant total des articles, calculé comme orderLineDetails.productPrice X orderLineDetails.quantity Assurez-vous de calculer la valeur pour order.amountOfMoney.amount en additionnant toutes les instances de shoppingCart.items.amountOfMoney.amount |
|
hostedCheckoutSpecificInput.locale |
La version linguistique de notre Hosted Checkout Page. |
|
redirectPaymentMethodSpecificInput |
paymentProductId : L'identifiant numérique de la méthode 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 Cofidis. Si omis, notre plateforme envoie vos clients vers le Hosted Checkout Page à la place, leur permettant de choisir cette méthode de paiement ou toute autre méthode qui est active sur votre compte. requiresApproval : Réglez sur "true"/"false" selon que vous souhaitez traiter les paiements en mode autorisation("true")/mode vente directe ("false").
Assurez-vous de capturer la transaction autorisée ultérieurement. Ce n'est qu'alors que la transaction aura status="CAPTURED" / statusOutput.statusCategory="COMPLETED" / statusOutput.statusCode=9, pour lequel vous recevez le paiement réel pour la transaction.
returnUrl : L'URL vers laquelle nous redirigeons vos clients après que le paiement a été finalisé.
|
Retrouvez des informations détaillées sur cet objet et ses propriétés dans notre documentation CreateHostedCheckoutAPI.
Liste des marques Cofidis disponibles
| Marque | paymentProductId |
|---|---|
|
Cofidis 3x Pour diviser le paiement en trois versements |
5129 |
|
Cofidis 4x Pour diviser le paiement en quatre versements |
5130 |
Cinématique
- Vos clients finalisent une commande dans votre boutique et sélectionnent Cofidis 3x/4x.
- Vous envoyez cette requête CreateHostedCheckout à notre plateforme.
- Vous redirigez vos clients via le redirectUrl vers la page de paiement Cofidis. Ils confirment la commande avec leurs coordonnées de carte et leurs données personnelles.
- Nous recevons le résultat de la transaction.
- Nous redirigeons votre client vers votre returnUrl
- Vous récuperez le résultat de la transaction à notre plateforme via une requête GetHostedCheckout ou recevez le résultat via webhooks.
- Si la transaction a été réussie, vous pouvez livrer les marchandises / services.
- Cofidis prélève 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.