Cofidis 3x/4x

Intro

Comme Cofidis propose différentes marques, plusieurs paymentProductId existent. Trouvez toutes les valeurs possibles dans le chapitre Integration.

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.

Optimised for Desktop Tablet Mobile

Overview

Payment group:

Instalment

Payment product id:

5129

Key benefits

Exigences PCI faibles
Intégration facile
Permet les remboursements partiels/multiples/intégraux
Permet les captures partielles/multiples/intégrales
Paiement garanti

Onboarding

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.

Countries & currencies

Supported countries

France

Supported currencies

Euro (EUR)

Integration

Redirigez vos clients vers la page de paiement Cofidis via notre Hosted Checkout Page. Vous trouverez une vue d'ensemble dans le chapitre "Process flows".

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": "0111111111"
      }
    },
    "references": {
      "merchantReference": "merchantReference"
    },
    "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 currencyCode	amount : Le montant brut que vous souhaitez facturer pour cette commande. currencyCode : Le code de devise ISO 4217 pour ce montant.
customer personalInformation contactDetails	Les informations personnelles de vos clients.
customer billingAddress shippingAddress	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 items amountOfMoney invoiceData orderLineDetails	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 requiresApproval returnUrl	paymentProductId : L'identifiant numérique de la méthode de paiement sur notre plateforme. Vous trouverez 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 : Définir sur "true"/"false" selon que vous souhaitez traiter les paiements en mode autorisation/Direct Sale. 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

Marque

paymentProductId

Cofidis 3x

Pour diviser le paiement en trois versements

5129

Cofidis 4x

Pour diviser le paiement en quatre versements

5130

Process flows

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

Testing

Consultez nos Test cases 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.
Les données dans notre chapitre Test cases fonctionnent UNIQUEMENT pour les demandes de paiement dans notre environnement de test. Utiliser ces données dans notre environnement de production entraînera des résultats de test indésirables.