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 plusieurs 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, l'intégration de Stripe à la plateforme OneEntry est abordée ici. (s'ouvre dans un nouvel onglet)

Midtrans​

La plateforme OneEntry prend en charge l'intégration avec le système de paiement indonésien Midtrans. Pour plus de détails, l'intégration de Midtrans est abordée ici. (s'ouvre dans un nouvel onglet)

Xendit​

La plateforme OneEntry prend en charge l'intégration avec le système de paiement Xendit. Pour plus de détails, l'intégration de Xendit est abordée ici. (s'ouvre dans un nouvel onglet)

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. Les comptes de types Stripe, Midtrans et Xendit ne peuvent être créés qu'un seul par projet ; il peut y avoir autant de comptes de type Personnalisé que nécessaire.
  • 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 Modifier.

En mode édition, vous pouvez modifier :

  • Nom
  • Type
  • Marqueur

Les comptes Stripe, Midtrans et Xendit en mode édition ont également des paramètres de connexion au système de paiement. Ils sont décrits sur les pages Stripe (s'ouvre dans un nouvel onglet), Midtrans (s'ouvre dans un nouvel onglet) et Xendit (s'ouvre dans un nouvel onglet).

Sur l'écran de modification, il y a également un tableau de l'historique des versions du compte (colonnes Version, Qui a effectué le changement, Date, Données sauvegardées et icône Restaurer les données dans la ligne de version ; tant qu'aucune sauvegarde n'a été effectuée, au lieu du tableau, il est affiché «Aucune donnée disponible») : vous pouvez y consulter les anciennes sauvegardes et restaurer celles dont vous avez besoin. Pour plus de détails, voir la section Historique des versions.

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), vous pouvez ajouter des paramètres personnalisés spécifiques à une API donnée dans le 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 PayPal Orders, 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, comme mode, line_items, etc.

Comment cela fonctionne​

En plus des champs de base (Nom, Type, Marqueur), pour les comptes de type Stripe, Midtrans et Xendit, vous verrez un tableau « Paramètres personnalisés pour l'API de paiement » (Custom parameters for payment API). Les comptes de type Personnalisé n'ont pas ce tableau. Le tableau affiche des ensembles d'attributs de la section Paramètres → Attributs. Le tableau 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 faut ouvrir l'édition de l'ensemble en cliquant sur le bouton Paramètres. Ensuite, sélectionnez l'attribut nécessaire dans l'ensemble prédéfini et saisissez la valeur requise, en fonction du type d'attribut.

⚠️ Important : les ensembles d'attributs et leur contenu sont configurés séparément et peuvent inclure des champs de différents types : chaîne, nombre, valeur booléenne, 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 ensemble 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 de l'ensemble « 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 aux exigences des API externes.

Exportation des données du compte de paiement​

Dans la ligne du compte, en plus de masquer, modifier et supprimer, il y a un bouton d'exportation des données (dans la version actuelle, son infobulle est "Paramètres"). Il ouvre une fenêtre d'exportation : choisissez le format de fichier — csv ou xml — et confirmez l'exportation, le fichier sera téléchargé dans le navigateur. Le bouton est accessible à l'administrateur ayant le droit d'exporter dans le module de paiements.

Masquage d'un compte de paiement​

Si vous ne souhaitez plus utiliser un compte de paiement et 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" Masquer.

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

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.