DocumentaçãoCommerceGuia do Payment Services

Itens de linha para Payment Services

Last update: Thu Feb 26 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Usuário

Os itens de linha para Payment Services são os itens incluídos em um pedido. Esses itens de linha fornecem informações como:

  • Detalhes do produto
  • Quantidade
  • Preço (incluindo impostos, descontos e outras informações relevantes)

Essas informações são úteis para o atendimento ao cliente, gerenciamento de pedidos e faturamento adequado.

Configurar itens de linha

Os itens de linha são habilitados por padrão para Payment Services. Para configurar:

  1. Na barra lateral Admin, navegue até Stores > Settings>Configuration.

  2. Vá para Sales e selecione Payment Methods.

  3. Expanda a seção FEATURED ADOBE PAYMENT SOLUTION.

  4. Na seção Payment Services, expanda a seção​Line Items.

  5. Para Line Items Enabled, selecione Yes para habilitar (padrão) ou No para desabilitar itens de linha.

  6. Clique em Save Config para salvar suas alterações.

IMPORTANT
Se você tiver extensões de terceiros que adicionam taxas personalizadas (como taxas de manuseio) a seus pedidos, talvez seja necessário desativar os itens de linha. Payment Services calcula os itens de linha com base nos componentes de ordem padrão da Commerce (itens, impostos, remessa e descontos). As taxas de terceiros que não são reconhecidas por Payment Services podem causar uma incompatibilidade entre o total do item de linha e o total do pedido, o que pode impedir a conclusão do check-out.

Exibir itens de linha

Para exibir itens de linha:

  1. Navegue até seu painel de comerciantes do PayPal.

  2. Clique em Atividade > Todas as transações.

  3. Selecione a ordem desejada e exiba seus itens de linha:

    Exemplo de itens de linha na visualização de painel do comprador

    Exibição de itens de linha {width="500" modal="regular"}

Atributos de itens de linha

Os itens de linha são gerados quando o pedido é feito por meio do Adobe Commerce e as informações são enviadas ao PayPal, com os seguintes atributos:

Atributo
Tipo de dados
Descrição
name
String!
O nome do item. Se um item tiver mais de uma linha devido a várias quantidades ou a uma emissão de arredondamento de imposto, o nome do item permanecerá o mesmo para todas as linhas, mas o preço exibido poderá variar um pouco devido ao arredondamento.
unit_amount
Objeto!
O preço ou a taxa do item por unidade. Inclui os seguintes atributos: currency_code e value.
tax
Objeto
O imposto do item para cada unidade. Inclui os seguintes atributos: currency_code e value.
quantity
String!
A quantidade do item. Será um número inteiro.
description
String
A descrição detalhada do item.
sku
String
A unidade de manutenção de estoque (ou SKU) do item.
url
String
O URL para o item que está sendo comprado. Visível para o comprador e usado nas experiências do comprador.
upc
Objeto
O Código Universal de Produto (ou UPC) do item.
category
String
O tipo de categoria do item.

unit_amount atributos

O objeto unit_amount contém os seguintes atributos:

Atributo
Tipo de dados
Descrição
currency_code
String!
O código de moeda ISO-4217 de três caracteres que identifica a moeda.
value
String!
Indica o valor do item. O currency_code determina o número necessário de casas decimais, se houver.

tax atributos

O objeto tax contém os seguintes atributos:

Atributo
Tipo de dados
Descrição
currency_code
String!
O código de moeda ISO-4217 de três caracteres que identifica a moeda.
value
String!
Indica o valor do item. Depende de cada currency_code para o número necessário de casas decimais.

upc atributos

O objeto upc contém os seguintes atributos:

Atributo
Tipo de dados
Descrição
type
sequência de caracteres!
O tipo de UPC.
code
sequência de caracteres!
O código de produto UPC do item.
Exemplo de itens de linha
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"
}

Consulte a documentação do desenvolvedor do PayPal sobre os itens de linha para obter mais informações sobre esses campos e suas limitações.

Gerenciar itens de linha

O Adobe Commerce calcula o imposto com base no valor total de cada linha, o que pode causar problemas de arredondamento se várias quantidades do mesmo item forem solicitadas ou se preços com imposto incluído forem exibidos no catálogo. Nesses casos, a quantidade total pode ser dividida em duas linhas, mas a quantidade será igual ao total de itens solicitados.

Exemplo de itens de linha com problemas de arredondamento na exibição do painel do comerciante

Exibição de itens de linha {width="600" modal="regular"}

Como o Adobe Commerce calcula um problema de arredondamento em itens de linha

Os itens de linha para Payment Services equilibram esse problema de arredondamento de forma que o valor unit_amount ou unit_tax corresponda ao valor total do pedido. Um item pode ser dividido em duas linhas para resolver este problema de arredondamento:

  • Quando o problema de arredondamento aparecer no unit_amount, o comerciante deverá ver uma diferença no preço dessa linha adicional.
  • Quando o problema de arredondamento aparecer na unit_tax, nenhuma diferença será vista nos itens de linha individuais porque a tax não é exibida na grade, mas somente como um total na parte inferior.
recommendation-more-help
00b8a45a-5862-4817-8e1e-074170ebb953