Sofinco 3x/4x

Introduction

Comme Sofinco 3x/4x propose différentes marques, plusieurs paymentProductId existent. Trouvez toutes les valeurs possibles dans le chapitre Intégration.

Sofinco 3x/4x est une solution de paiement échelonné proposée par Sofinco.

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 sans intérêts sur plusieurs mois. Vos clients saisissent leurs coordonnées de carte (Visa, MasterCard ou Cartes Bancaires) et leurs informations personnelles sur la page de paiement Sofinco. Sofinco prélève ensuite automatiquement vos clients pour les versements individuels.

Sofinco 3x/4x externalise le risque de défaut de paiement, car Sofinco 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.

Optimisé pour Desktop Tablet Mobile

Aperçu

Groupe de paiement :

Échéance

Identifiant du moyen de paiement:

5131

Avantages clés

Exigences PCI faibles
Intégration facile
Permet des remboursements complets
Permet des captations complètes
Paiement garanti

Activation

Pour utiliser Sofinco dans notre environnement de test/prod, suivez ces étapes :

Signez un contrat avec Sofinco 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.

Pays & devises

Pays pris en charge

France

Devises prises en charge

Euro (EUR)

Intégration

Redirigez vos clients vers la page de paiement Sofinco 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": {
      "merchantCustomerId": "mc_638115340658687368",
      "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": 5131
  }
}

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 Sofinco.
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. Trouvez cet id dans la liste ci-dessous. Il indique à notre plateforme d'envoyer directement vos clients vers la page de paiement Sofinco. 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éfinissez 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 Sofinco disponibles

Marque	paymentProductId
Sofinco 3x Pour diviser le paiement en trois versements	5131
Sofinco 4x Pour diviser le paiement en quatre versements	5132
Sofinco 3x (sans intérêts) Pour diviser le paiement en trois versements sans intérêts	5136
Sofinco 4x (sans intérêts) Pour diviser le paiement en quatre versements sans intérêts	5137

Cinématique

Vos clients finalisent une commande dans votre boutique et sélectionnent Sofinco 3x/4x.
Vous envoyez cette requête CreateHostedCheckout à notre plateforme.
Vous redirigez vos clients via le redirectUrl vers la page de paiement Sofinco. 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 GetPaymentDetails ou recevez le résultat via webhooks.
Si la transaction a été réussie, vous pouvez livrer les marchandises / services.
Sofinco 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.