DocumentationCommerceGuide Payment Services

Éléments de ligne pour Payment Services

Last update: Thu May 08 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Rubriques :

Créé pour :

  • Utilisateur ou utilisatrice

Les articles de ligne pour Payment Services sont les articles inclus dans une commande. Ces lignes fournissent des informations telles que :

  • Détails du produit
  • Quantité
  • Prix (taxes, remises et autres informations pertinentes)

Ces informations sont utiles pour le service client, la gestion des commandes et la facturation correcte.

Cette fonctionnalité est activée par défaut pour les Payment Services. Pour afficher les éléments de ligne :

  1. Accédez à votre tableau de bord de vendeur PayPal.

  2. Cliquez sur Activité > Toutes les transactions.

  3. Sélectionnez la commande souhaitée et affichez ses éléments de ligne :

    Exemple d’éléments de ligne dans la vue du tableau de bord de l’acheteur

    Vue Éléments de ligne {width="500" modal="regular"}

Attributs d’éléments de ligne

Les lignes sont générées lorsque la commande est passée via Adobe Commerce et que les informations sont envoyées à PayPal, avec les attributs suivants :

Attribut
Type de données
Description
name
Chaîne !
Nom de l’élément. Si un article comporte plusieurs lignes en raison de plusieurs quantités ou d'un problème d'arrondi de taxe, le nom de l'article reste le même pour toutes les lignes, mais le prix affiché peut varier légèrement en raison de l'arrondi.
unit_amount
Objet !
Prix ou taux de l'article par unité. Inclut les attributs suivants : currency_code et value.
tax
Objet
Taxe article pour chaque unité. Inclut les attributs suivants : currency_code et value.
quantity
Chaîne !
Quantité d'article. Sera un nombre entier.
description
String
Description détaillée de l'objet.
sku
String
Unité de gestion des stocks (ou SKU) de l’article.
url
String
URL de l'article acheté. Visible par l'acheteur et utilisée dans les expériences acheteur.
upc
Objet
Code de produit universel (ou CUP) de l’article.
category
String
Type de catégorie d'articles.

Attributs unit_amount

L’objet unit_amount contient les attributs suivants :

Attribut
Type de données
Description
currency_code
Chaîne !
Code de devise ISO-4217 à trois caractères qui identifie la devise.
value
Chaîne !
Indique la valeur de l’élément. Le currency_code détermine le nombre de décimales requis, le cas échéant.

Attributs tax

L’objet tax contient les attributs suivants :

Attribut
Type de données
Description
currency_code
Chaîne !
Code de devise ISO-4217 à trois caractères qui identifie la devise.
value
Chaîne !
Indique la valeur de l’élément. Dépend de chaque currency_code pour le nombre de décimales requis.

Attributs upc

L’objet upc contient les attributs suivants :

Attribut
Type de données
Description
type
chaîne !
Type UPC.
code
chaîne !
Code produit UPC de l'article.
Exemple d’éléments de ligne
code language-json 
{
    "name": "Crown Summit Backpack - 1",
    "unit_amount": {
        "currency_code": "USD",
        "value": "38.50"
    },
    "tax": {
        "currency_code": "USD"
        "value": "3.13"
    },
    "quantity": "1",
    "description": "The Crown Summit Backpack is equally at home in a gym locker, study cube or a pup tent, so be sure yours is packed with books,",
    "sku": "24-MB03",
    "url": "https://magento.test/crown-summit-backpack.html",
    "upc": {
        "type": "UPC-A",
        "code": "000003"
    },
    "category": "PHYSICAL_GOODS"
},
{
    "name": "Crown Summit Backpack - 2",
    "unit_amount": {
        "currency_code": "USD",
        "value": "38.50"
    },
    "tax": {
        "currency_code": "USD",
        "value": "3.14"
    },
    "quantity": "1",
    "description": "The Crown Summit Backpack is equally at home in a gym locker, study cube or a pup tent, so be sure yours is packed with books,",
    "sku": "24-MB03",
    "url": "https://magento.test/crown-summit-backpack.html",
    "upc": {
        "type": "UPC-A",
        "code": "000003"
    },
    "category": "PHYSICAL_GOODS"
}

Voir Documentation PayPal pour les développeurs sur les éléments de ligne pour plus d’informations sur ces champs et leurs limites.

Gérer les éléments de ligne

Adobe Commerce calcule la taxe en fonction du montant total de chaque ligne, ce qui peut entraîner des problèmes d'arrondi si plusieurs quantités du même article sont commandées ou si des prix incluant la taxe sont affichés dans le catalogue. Dans ce cas, la quantité totale peut être fractionnée en deux lignes, mais la quantité sera égale au total des articles commandés.

Exemple d'éléments de ligne avec des problèmes d'arrondi dans la vue du tableau de bord du commerçant

Vue Éléments de ligne {width="600" modal="regular"}

Comment Adobe Commerce calcule un problème d’arrondi dans les éléments de ligne

Les lignes de Payment Services équilibrent ce problème d'arrondi de sorte que la valeur de unit_amount ou de unit_tax corresponde au montant total de la commande. Un élément peut être divisé en deux lignes pour résoudre ce problème d'arrondi :

  • Lorsque le problème d'arrondi apparaît sur la unit_amount, le commerçant devrait voir une différence de prix sur cette ligne supplémentaire.
  • Lorsque le problème d'arrondi apparaît sur la unit_tax, aucune différence n'est visible sur les éléments de ligne individuels, car le tax n'est pas affiché dans la grille, mais uniquement sous la forme d'un total en bas.
recommendation-more-help
00b8a45a-5862-4817-8e1e-074170ebb953