Aller au contenu principal

Comptes

Un compte de paiement est un moyen de recevoir des paiements lors d'une commande. Vous pouvez créer plusieurs comptes pour différents types de paiements, par exemple, connecter un système de paiement ou ajouter un paiement en espèces.

Les outils pour travailler avec les comptes se trouvent dans la sous-section "Comptes" de la section "Paiements". Les comptes de paiement déjà créés se trouvent dans la liste générale. Ci-dessous se trouve un formulaire pour créer de nouveaux comptes de paiement.

Types de comptes de paiement.​

Actuellement, le système propose deux types de comptes de paiement au choix.

Stripe​

La plateforme OneEntry prend en charge l'intégration avec le système de paiement Stripe. Choisissez ce type si vous souhaitez connecter le système de paiement Stripe à votre projet. Pour plus de détails sur la connexion de Stripe à la plateforme OneEntry, consultez ici.

Personnalisé​

Si vous souhaitez utiliser un autre système de paiement ou accepter des paiements en espèces, utilisez ce type de comptes de paiement.

Création d'un compte de paiement​

Dans le formulaire de création d'un compte de paiement, indiquez :

  • Nom - Chaîne non unique
  • Type - Valeur du menu déroulant.
  • Marqueur - Chaîne unique.

Après avoir rempli le formulaire, cliquez sur le bouton "Ajouter". Si tous les champs sont correctement remplis, le compte de paiement sera créé et ajouté à la liste générale.

Modification d'un compte de paiement​

Sélectionnez dans la liste le compte de paiement que vous souhaitez modifier et cliquez sur l'icône de modification Edit.

En mode édition, vous pouvez modifier :

  • Nom
  • Type
  • Marqueur

Les modifications seront enregistrées automatiquement.

Paramètres personnalisés pour l'API de paiement​

Pour une intégration flexible avec divers systèmes de paiement (par exemple, PayPal, Stripe et d'autres), il est possible d'ajouter des paramètres personnalisés, spécifiques à une API donnée, au compte de paiement.

Ces paramètres sont transmis sous forme de paires « clé-valeur » lors de l'initialisation de la session de paiement. Par exemple, dans l'API des commandes PayPal, des champs tels que purchase_units, intent, application_context.return_url ou payer.email_address sont souvent requis, tandis que Stripe utilise d'autres paramètres, tels que mode, line_items, etc.

Comment cela fonctionne​

En plus des champs de base (Nom, Type, Marqueur), vous verrez un tableau « Paramètres personnalisés pour l'API de paiement ». Le tableau est une agrégation de jeux d'attributs du module Paramètres, et permet de définir une correspondance entre :

  • Marqueur (Nom du paramètre dans l'API) (par exemple, purchase_units pour PayPal ou line_items pour Stripe)
  • Valeur, qui sera insérée lors de la création du paiement

Pour définir une valeur, il est nécessaire d'ouvrir l'édition du jeu, en cliquant sur le bouton Edit. Ensuite, sélectionnez l'attribut nécessaire dans le jeu préconfiguré, et entrez la valeur requise, conformément au type d'attribut.

⚠️ Important : les jeux d'attributs et leur contenu sont configurés séparément et peuvent inclure des champs de différents types : chaîne, nombre, booléen, JSON, etc.

Exemple d'utilisation avec PayPal Supposons que vous souhaitiez transmettre les détails de la commande à PayPal via le champ purchase_units. Vous créez un jeu d'attributs nommé « Unité d'achat PayPal », y ajoutez un attribut items de type JSON, contenant une structure de type :

    {
      "invoice_id": "90210",
      "amount": {
        "currency_code": "USD",
        "value": "230.00",
        "breakdown": {
          "item_total": {
            "currency_code": "USD",
            "value": "220.00"
          },
          "shipping": {
            "currency_code": "USD",
            "value": "10.00"
          }
        }
      },
      "items": [
        {
          "name": "T-Shirt",
          "description": "T-shirt super frais",
          "unit_amount": {
            "currency_code": "USD",
            "value": "20.00"
          },
          "quantity": "1",
          "category": "BIENS_PHYSIQUES",
          "sku": "sku01",
          "image_url": "https://example.com/static/images/items/1/tshirt_green.jpg",
          "url": "https://example.com/url-to-the-item-being-purchased-1",
          "upc": {
            "type": "UPC-A",
            "code": "123456789012"
          }
        },
        {
          "name": "Chaussures",
          "description": "Course, Taille 10.5",
          "sku": "sku02",
          "unit_amount": {
            "currency_code": "USD",
            "value": "100.00"
          },
          "quantity": "2",
          "category": "BIENS_PHYSIQUES",
          "image_url": "https://example.com/static/images/items/1/shoes_running.jpg",
          "url": "https://example.com/url-to-the-item-being-purchased-2",
          "upc": {
            "type": "UPC-A",
            "code": "987654321012"
          }
        }
      ]
}

Ensuite, dans les paramètres du compte de paiement, vous associez :

Clé : purchase_units Valeur : attribut items du jeu « Unité d'achat PayPal » Lors de la création de la commande, le système insérera automatiquement la valeur actuelle de cet attribut dans le corps de la requête à l'API PayPal.

D'autres paramètres couramment utilisés par PayPal :

intent — par exemple, "CAPTURE" ou "AUTHORIZE" application_context.return_url — URL de retour après un paiement réussi application_context.cancel_url — URL d'annulation du paiement

Ce mécanisme permet d'adapter les intégrations de paiement à toutes les exigences spécifiques des API externes sans modifier le code de la plateforme.

Masquer un compte de paiement​

Si vous ne souhaitez plus utiliser un compte de paiement et que vous ne pouvez pas le supprimer car il est déjà utilisé dans le projet, vous pouvez le masquer.

Pour cela, sur le compte sélectionné, cliquez sur l'icône "œil" Edit.

Les comptes de paiement masqués ne seront pas proposés par le système lors de la configuration du stockage des commandes.

Suppression d'un compte de paiement​

Sélectionnez dans la liste le compte de paiement que vous souhaitez supprimer et cliquez sur l'icône de suppression Edit.

Confirmez l'action dans la boîte de dialogue. Ensuite, le compte de paiement sera supprimé et disparaîtra de la liste générale.