DocumentaçãoCommerceGuia do Payment Services

Configuração de Payment Services

Last update: Thu Oct 16 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Intermediário
  • Administrador
  • Usuário

Você pode personalizar o Payment Services de acordo com suas necessidades com opções de configuração úteis no Administrador.

Ao configurar Payment Services para Adobe Commerce e Magento Open Source no Administrador, essas configurações se aplicam apenas ao ambiente definido no campo Method​de​General Configuration. Quaisquer alterações feitas nos campos de configuração são independentes da alternância da seleção Method. Se você alternar o método, suas seleções não serão redefinidas.

Configuração geral

Você pode habilitar Payment Services para sua loja e Merchant Location​e habilitar testes de sandbox ou pagamentos ao vivo na seção​General Configuration.

  1. Na barra lateral Admin, vá para Stores > Settings>Configuration.

  2. No painel esquerdo, expanda Sales e escolha Payment Methods.

  3. Defina o campo Merchant Country​no​Merchant Location. Se um Merchant Country​não for especificado, o​Default Country da configuração geral será usado.

  4. Expanda a seção FEATURED ADOBE PAYMENT SOLUTION​para acessar a seção​Payment Services.

  5. Na seção Payment Services, expanda a seção​General Configuration.

  6. Para Habilitar, defina-o como Yes para habilitar Payment Services para seu armazenamento.

  7. Para o Método, defina-o como Sandbox se você ainda estiver testando o Payment Services para sua loja ou Production se você estiver pronto para habilitar pagamentos ao vivo.

  8. Os valores Payment Services Sandbox ID e Payment Services Production ID são preenchidos automaticamente depois que você configura o Commerce Services Connector e visita o painel Payment Services pela primeira vez. Faça isso para concluir a integração dos ambientes de sandbox e/ou produção. Esses valores associam sua SaaS ID a Payment Services.

    note warning
    WARNING
    Se precisar alterar a ID do espaço de dados no Commerce Services Connector, redefina a ID do Payment Services. Clique em Redefinir ID de Serviços de Pagamento para redefinir sua ID de Sandbox. Se você redefinir sua ID de sandbox do Payment Services, será necessário integrar novamente.

  9. Seus valores de PayPal Merchant ID e PayPal Merchant Status são fornecidos automaticamente pelo PayPal assim que você visita o painel Payment Services pela primeira vez.

  10. Para o Descritor Flexível (valores personalizados que são exibidos em demonstrativos bancários de transações do cliente para definir entre lojas/marcas/catálogos), adicione seu texto personalizado (até 22 caracteres) ao campo de texto, substituindo Soft descriptor ou o valor existente.

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

  12. Navegue até System > Cache Management e clique em Flush Cache para atualizar todos os caches inválidos.

Exibição da Solução Adobe em Destaque {width="700" modal="regular"}

Opções de configuração

Campo
Escopo
Descrição
Enable
site
Habilite ou desabilite o Payment Services para o seu site. Opções: Yes / No
Method
exibição de loja
Defina o método ou ambiente para sua loja. Opções: Sandbox / Production
Payment Services Sandbox ID
exibição de loja
Sua ID de comerciante de sandbox, que é gerada automaticamente durante a integração da sandbox.
Payment Services Production ID
exibição de loja
Sua ID de comerciante de produção, que é gerada automaticamente durante a integração da produção (ao vivo).
PayPal Merchant ID
exibição de loja
Sua ID exclusiva de conta de comerciante do PayPal, gerada ao criar sua conta do PayPal.
PayPal Merchant Status
exibição de loja
Status da ID de Comerciante do PayPal.
Soft Descriptor
exibição de site ou loja
Adicione um descritor simples ao(s) site(s) e às visualizações da loja para adicionar informações às transações do cliente que definem marcas, lojas ou linhas de produtos.

Credit Card Fields

As opções de pagamento do Credit Card Fields oferecem check-out simples e seguro para métodos de pagamento com cartão de crédito ou débito.

Consulte Opções de pagamentos para obter mais informações.

  1. Na barra lateral Admin, vá para Stores > Settings>Configuration.
  2. No painel esquerdo, expanda Sales e escolha Payment Methods.
  3. Expanda a seção FEATURED ADOBE PAYMENT SOLUTION.
  4. Na seção Payment Services, expanda a seção​Credit Card Fields.
  5. Para Title, insira texto (se necessário) para alterar o nome do método de pagamento conforme mostrado durante o check-out.
  6. Para definir a ação de pagamento, selecione Authorize ou Autorizar e Capturar.
  7. Para priorizar um método de pagamento na página de check-out, forneça um valor Numeric Only no campo Sort order.
  8. Para Show on checkout page, escolha Yes para habilitar campos de cartão de crédito na página de check-out.
  9. Para Vault Enabled, escolha Yes para habilitar a compartimentalização de cartão de crédito para check-out.
  10. Para Vault Enabled in Admin, escolha Yes para permitir que o comerciante crie pedidos para clientes usando seu cartão de crédito com cofre.
  11. Para habilitar 3D Secure authentication (Off por padrão), escolha Always ou When required.
  12. Para Debug Mode, escolha Yes para habilitar o modo de depuração ou No para desabilitá-lo.
  13. Clique em Save Config para salvar suas alterações.
  14. Navegue até System > Cache Management e clique em Flush Cache para atualizar todos os caches inválidos.

Opções de configuração

Campo
Escopo
Descrição
Title
exibição de loja
Adicione o texto a ser exibido como o título para esta opção de pagamento na exibição de Método de Pagamento durante a finalização da compra. Opções: text field
Payment Action
site
A ação de pagamento para o método de pagamento especificado. Opções: Authorize / Authorize and Capture
Sort order
exibição de loja
A ordem de classificação do método de pagamento especificado na página de check-out. Valor Numeric Only
Show on checkout page
site
Ative ou desative os campos de cartão de crédito na página de check-out. Opções: Yes / No
Vault enabled
exibição de loja
Habilite ou desabilite o cofre de cartão de crédito. Opções: Yes / No
Vault enabled in Admin
exibição de loja
Habilite ou desabilite o recurso para comerciante concluir pedidos de clientes no Administrador usando um método de pagamento com cofre. Opções: Yes / No
3D Secure authentication
site
Habilite ou desabilite a autenticação Segura do 3DS. Opções: Always / When Required / Off
Debug Mode
site
Ative ou desative o Modo de depuração. Opções: Yes / No

Fastlane

Fastlane by PayPal é uma maneira rápida e fácil de pagar online com segurança. Durante uma finalização de compra como convidado, você pode armazenar com segurança seu cartão e seus detalhes de envio para compras ainda mais rápidas no futuro.

Consulte Opções de pagamento para obter mais informações.

  1. Na barra lateral Admin, vá para Stores > Settings>Configuration.

  2. No painel esquerdo, expanda Sales e escolha Payment Methods.

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

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

  5. Para habilitá-lo, selecione Yes para Enable Fastlane (No desabilita-o).

    note note
    NOTE
    Se Fastlane estiver habilitado, a opção de pagamento Credit Card Fields será desabilitada.

  6. Para Title, insira texto (se necessário) para alterar o nome do método de pagamento conforme mostrado durante o check-out. O título padrão é Credit Card (via Fastlane)

  7. Para definir a ação de pagamento, selecione Authorize ou Autorizar e Capturar.

  8. Para habilitar 3D Secure Authentication for Fastlane (Off por padrão), escolha When required para cumprir as normas da UE ou Always para adicionar uma camada extra de proteção contra fraude.

    note note
    NOTE
    Se o emissor do cartão exigir autenticação 3D Secure, essa etapa não poderá ser ignorada, independentemente da configuração Payment Services.

  9. Para priorizar um método de pagamento na página de check-out, forneça um valor Numeric Only no campo Sort order.

  10. Especifique se a identidade visual Fastlane será habilitada durante o check-out no Adobe Commerce definindo o campo Enable messaging como Yes.

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

  12. Navegue até System > Cache Management e clique em Flush Cache para atualizar todos os caches inválidos.

Campo
Escopo
Descrição
Enable Fastlane
exibição de loja
Habilite ou desabilite Fastlane na página de check-out. Opções: Yes / No
Title
exibição de loja
Adicione o texto a ser exibido como o título para esta opção de pagamento na exibição de Método de Pagamento durante a finalização da compra. O valor padrão é Credit Card (via Fastlane). Opções: text field
Payment Action
site
A ação de pagamento para o método de pagamento especificado. Opções: Authorize / Authorize and Capture
3D Secure authentication
exibição de loja
Habilite ou desabilite a Autenticação Segura 3D para o Fastlane. Opções: Always / When Required / Off
Sort order
exibição de loja
A ordem de classificação do método de pagamento especificado na página de finalização da compra. Valor Numeric Only
Enable messaging
exibição de loja
Especifique se a identidade visual do Fastlane será habilitada durante o check-out no Adobe Commerce. Opções: Yes / No

Opcional. Configurações avançadas de estilo

Essas configurações opcionais podem personalizar como o Fastlane é exibido no seu site.

TIP
Os estilos que não atendem às diretrizes de acessibilidade revertem para as configurações padrão.
  1. Na seção Payment Services, navegue até a seção​Fastlane.
  2. Expanda a seção Advanced Style Settings (optional).
  3. Modifique as configurações conforme necessário.
  4. Clique em Save Config para salvar suas alterações.

Consulte os Documentos do desenvolvedor do PayPal para obter mais informações sobre personalização.

Configurações de raiz

Essas configurações opcionais modificam o componente geral de check-out Fastlane.

Campo
Escopo
Descrição
Background Color
exibição de loja
Define a cor de fundo do componente. Somente RGB valores
Border Color
exibição de loja
Define a cor da borda do componente. Somente RGB valores
Font Family
exibição de loja
Define a fonte do componente. Somente as fontes disponíveis no seu tema são exibidas
Font Size Base
exibição de loja
Define o tamanho da fonte. Somente px valores (pixel)
Padding
exibição de loja
Define o preenchimento no componente. Somente px valores (pixel)
Primary Color
exibição de loja
Define a cor principal do componente. Somente RGB valores
Text Color
exibição de loja
Define a cor principal do texto no componente. Somente RGB valores

Configurações de entrada

Essas configurações opcionais se aplicam aos campos de entrada do cliente do componente Fastlane.

Campo
Escopo
Descrição
Background Color
exibição de loja
Define a cor de fundo do componente. Somente RGB valores
Border Color
exibição de loja
Define a cor da borda do componente. Somente RGB valores
Border Radius
exibição de loja
Define o raio da borda. Somente px valores (pixel)
Border Width
exibição de loja
Define a largura da borda. Somente px valores (pixel)
Focus Border Color
exibição de loja
Define a cor da borda de foco do componente. Somente RGB valores
Text Color Base
exibição de loja
Define a cor principal do texto no componente. Somente RGB valores

Apple Pay

Com o Apple Pay, os comerciantes podem oferecer uma experiência de check-out segura, rápida e contínua no Safari, com suporte para até 99 domínios por conta de comerciante. O botão Apple Pay preenche automaticamente as informações de pagamento, contato e remessa do dispositivo iOS ou macOS do cliente, permitindo compras rápidas, com um toque, que podem ajudar a aumentar as taxas de conversão.

Consulte Opções de pagamentos para obter mais informações.

  1. Na barra lateral Admin, vá para Stores > Settings>Configuration.

  2. No painel esquerdo, expanda Sales e escolha Payment Methods.

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

  4. Na seção Payment Services, expanda a seção​Apple Pay.

  5. Para Title, insira texto (se necessário) para alterar o nome do método de pagamento conforme mostrado durante o check-out.

  6. Para definir a ação de pagamento, selecione Authorize ou Authorize and Capture.

  7. Especifique onde a opção Apple Pay está habilitada no Adobe Commerce selecionando Yes nas seguintes opções, conforme necessário:

    • Show Apple Pay on checkout page
    • Show Apple Pay on product detail page
    • Show Apple Pay in mini cart preview
    • Show Apple Pay on cart page

  8. Para habilitar o modo de depuração, selecione Yes para Debug Mode (No o desabilita).

  9. Para salvar as alterações, clique em Save Config.

  10. Navegue até System > Cache Management e clique em Flush Cache para atualizar todos os caches inválidos.

Opções de configuração

Campo
Escopo
Descrição
Title
exibição de loja
Adicione o texto a ser exibido como o título para esta opção de pagamento na exibição de Método de Pagamento durante a finalização da compra. Opções: text field
Payment Action
site
A ação de pagamento para o método de pagamento especificado. Opções: Authorize / Authorize and Capture
Show on checkout page
site
Habilite ou desabilite Apple Pay na página de check-out. Opções: Yes / No
Sort order
exibição de loja
A ordem de classificação do método de pagamento especificado na página de finalização da compra. Valor Numeric Only
Show buttons on product detail page
exibição de loja
Habilite ou desabilite Apple Pay na página de detalhes do produto. Opções: Yes / No
Show buttons in mini-cart preview
exibição de loja
Habilite ou desabilite Apple Pay na visualização do minicarrinho. Opções: Yes / No
Show buttons on cart page
exibição de loja
Habilite ou desabilite o Apple Pay na página do carrinho. Opções: Yes / No
Debug Mode
site
Ative ou desative o Modo de depuração. Opções: Yes / No

Google Pay

A opção de pagamento Google Pay permite que o comerciante ofereça o Google Pay aos seus compradores, que podem usar a Carteira do Google em seus dispositivos para fazer compras.

Consulte Opções de pagamentos para obter mais informações.

  1. Na barra lateral Admin, vá para Stores > Settings>Configuration.

  2. No painel esquerdo, expanda Sales e escolha Payment Methods.

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

  4. Na seção Payment Services, expanda a seção​Google Pay.

  5. (Opcional) Altere o nome do método de pagamento mostrado durante o check-out inserindo o novo nome no campo Title.

  6. Defina a ação de pagamento selecionando Authorize ou Authorize and Capture.

  7. Especifique onde a opção Google Pay está habilitada no Adobe Commerce selecionando Yes nas seguintes opções, conforme necessário:

    • Show Google Pay on checkout page
    • Show Google Pay on product detail page
    • Show Google Pay in mini cart preview
    • Show Google Pay on cart page

  8. Para habilitar 3D Secure authentication (Off por padrão), escolha Always ou When required.

  9. Para habilitar o modo de depuração, selecione Yes para Debug Mode (No o desabilita).

  10. Configure a aparência do botão Google Pay​selecionando Button Color,Button Type​e Button Style​conforme necessário.

  11. Para definir a altura, usa o valor padrão para a altura definida em Button Style.

  12. Para salvar as alterações, clique em Save Config.

  13. Navegue até System > Cache Management e clique em Flush Cache para atualizar todos os caches inválidos.

Opções de configuração

Campo
Escopo
Descrição
Title
exibição de loja
Especifica o rótulo de texto que é exibido para esta opção de pagamento na exibição de Método de Pagamento durante o check-out. Opções: text field
Payment Action
site
A ação de pagamento para o método de pagamento especificado. Opções: Authorize / Authorize and Capture
Show on checkout page
site
Habilite ou desabilite Google Pay na página de check-out. Opções: Yes / No
Sort order
exibição de loja
A ordem de classificação do método de pagamento especificado na página de finalização da compra. Valor Numeric Only
Show buttons on product detail page
exibição de loja
Habilite ou desabilite Google Pay na página de detalhes do produto. Opções: Yes / No
Show buttons in mini-cart preview
exibição de loja
Habilite ou desabilite Google Pay na visualização do minicarrinho. Opções: Yes / No
Show buttons on cart page
exibição de loja
Habilite ou desabilite Google Pay na página do carrinho. Opções: Yes / No
3D Secure authentication
exibição de loja
Habilite ou desabilite a autenticação Segura 3D. Opções: Always / When Required / Off
Debug Mode
site
Ative ou desative o Modo de depuração. Opções: Yes / No
Button Color
Exibição da loja
Defina a cor do botão Google Pay. Opções: Default / Black / White
Button Type
Exibição da loja
Defina o tipo do botão Google Pay. Opções: buy / checkout / order / pay / plain

Consulte a documentação das opções de objeto da solicitação de API de Pagamento do Google para obter mais informações.

PayPal Payment Buttons

As opções de pagamento do PayPal payment buttons oferecem ao seu cliente um processo de finalização simples, rápido e seguro.

Consulte Opções de pagamentos para obter mais informações.

Configurar PayPal payment buttons

Você pode ativar e configurar as opções de pagamento dos botões de pagamento do PayPal em Admin:

  1. Na barra lateral Admin, vá para Stores > Settings>Configuration.

  2. No painel esquerdo, expanda Sales e escolha Payment Methods.

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

  4. Na seção Payment Services, expanda a seção​PayPal payment buttons.

  5. Para alterar o nome do método de pagamento conforme mostrado durante o check-out, edite o campo Title.

  6. Para definir a ação de pagamento, selecione Authorize ou Authorize and Capture.

  7. Para priorizar um método de pagamento na página de check-out, forneça um valor Numeric Only no campo Sort order.

  8. Para habilitar/desabilitar as mensagens de Pagamento Posterior, selecione Yes/No para Display Pay Later Message.

    • Se você habilitar as mensagens de Pagamento Posterior, um botão modal Configure Messaging será exibido para que você possa definir os estilos de PayPal Pay Later messaging.

  9. Especifique onde os botões de pagamento do PayPal são habilitados no Adobe Commerce selecionando Yes nas seguintes opções, conforme necessário:

    • Show buttons on checkout page
    • Show buttons on product detail page
    • Show buttons in mini cart preview
    • Show buttons on cart page

  10. Para habilitar Venmo como uma opção de pagamento, selecione Yes para Venmo Enabled.

  11. Para habilitar cartões de crédito e débito como opção de pagamento (botão Inteligente do PayPal), selecione Yes para Credit and Debit Card Enabled.

  12. Para habilitar/desabilitar a opção de pagamento Pagar Mais Tarde do PayPal, selecione Yes/No para PayPal Pay Later Enabled.

  13. Para habilitar o modo de depuração, selecione Yes para Debug Mode (No o desabilita).

  14. Para salvar as alterações, clique em Save Config.

  15. Navegue até System > Cache Management e clique em Flush Cache para atualizar todos os caches inválidos.

Opções de configuração

Campo
Escopo
Descrição
Title
exibição de loja
Adicione o texto a ser exibido como o título para esta opção de pagamento na exibição de Método de Pagamento durante a finalização da compra. Opções: campo de texto
Payment Action
site
A ação de pagamento para o método de pagamento especificado. Opções: Authorize / Authorize and Capture
Display Pay Later Message
site
Ative ou desative as mensagens do PayPal Pay Later no carrinho de compras, página do produto, minicarrinho e durante o fluxo de finalização. Opções: Yes / No
Configure Messaging
exibição de loja
Modificar os estilos de Mensagens Posteriores do PayPal. Opções: Product page / Cart
Show buttons on checkout page
exibição de loja
Habilite ou desabilite PayPal payment buttons na página de check-out. Opções: Yes / No
Show buttons on product detail page
exibição de loja
Habilite ou desabilite PayPal payment buttons na página de detalhes do produto. Opções: Yes / No
Show buttons in mini-cart preview
exibição de loja
Habilite ou desabilite PayPal payment buttons na visualização do minicarrinho. Opções: Yes / No
Show buttons on cart page
exibição de loja
Habilite ou desabilite o PayPal payment buttons na página do carrinho. Opções: Yes / No
Venmo Enabled
exibição de loja
Habilite ou desabilite a opção de pagamento Venmo onde os botões de pagamento são exibidos. Opções: Yes / No
Credit and Debit Card Enabled
exibição de loja
Ative ou desative as opções de cartão de Crédito e Débito onde os botões de pagamento são exibidos. Opções: Yes / No
PayPal Pay Later Enabled
exibição de loja
Ativar ou desativar a aparência da opção de pagamento PayPal Pay Posteriormente, onde os botões de pagamento são exibidos. Opções: Yes / No
Debug Mode
site
Ative ou desative o Modo de depuração. Opções: Yes / No

Estilo do botão

Você também pode configurar as opções Button style​dos botões de pagamento:

  1. Na barra lateral Admin, vá para Stores > Settings>Configuration.
  2. No painel esquerdo, expanda Sales e escolha Payment Methods.
  3. Expanda a seção FEATURED ADOBE PAYMENT SOLUTION.
  4. Na seção Payment Services, expanda a seção​PayPal Smart Button Styling.
  5. Para definir o layout, selecione Vertical ou Horizontal para Layout
  6. Para definir a cor, selecione uma das cores disponíveis em Color.
  7. Para definir a forma, selecione Rectangular ou Pill para Shape.
  8. Para usar a altura padrão, selecione Yes ou No para Use Default Height.
  9. Para definir a altura personalizada, adicione a altura de pixel desejada para Height.
  10. Para definir o slogan, selecione Yes ou No para Tagline.
  11. Para salvar as alterações, clique em Save Config.
  12. Navegue até System > Cache Management e clique em Flush Cache para atualizar todos os caches inválidos.

Opções de configuração

Campo
Escopo
Descrição
Layout
Exibição da loja
Definir estilo de layout para botões de pagamento Paypal. Opções: Vertical / Horizontal
Color
Exibição da loja
Defina a cor dos botões de pagamento do Paypal. Opções: Blue / Gold / Silver / White / Black
Shape
Exibição da loja
Defina a forma dos botões de pagamento Paypal. Opções: Rectangular / Pill
Use Default Height
Exibição da loja
Define se os botões de pagamento do PayPal usam uma altura padrão. Opções: Yes / No
Height
Exibição da loja
Defina a altura dos botões de pagamento do PayPal. Valor padrão: nenhum
Label
Exibição da loja
Defina o rótulo que aparece nos botões de pagamento do PayPal. Opções: PayPal / Checkout / Buynow / Pay / Installment
Tagline
Exibição da loja
Ativa o slogan. Opções: Yes / No

Liberar o cache

Se você alterar a configuração em Configurações, por exemplo, alternando os botões Apple Pay, Venmo ou PayPal PayLater, limpe manualmente o cache para que sua loja mostre as configurações mais recentes.

  1. Na barra lateral Admin, vá para System > Cache Management.
  2. Clique em Flush Cache para atualizar todos os caches inválidos.

Se qualquer Tipo de Cache na tabela Gerenciamento de Cache tiver um status INVALIDATED, seu repositório talvez não mostre a configuração mais recente para esse item. Limpe o cache para atualizar seu armazenamento para mostrar a configuração mais recente.

Para garantir que seu armazenamento mostre a configuração correta, limpe o cache periodicamente.

Compartimentalização da placa

Você pode ativar a funcionalidade que permite aos clientes arquivar — ou "salvar" — as informações de cartão de crédito em sua conta para uso em compras futuras.

Você também pode usar a compartimentalização de cartão no Administrador para concluir pedidos subsequentes de clientes existentes.

Habilite ou desabilite a compartimentalização de cartão nas configurações de campo de cartão de crédito.

Consulte Compartimentalização de cartão de crédito para obter mais informações.

3DS

O 3DS protege clientes e comerciantes de atividades fraudulentas em suas lojas e permite a conformidade com os padrões da União Europeia (UE).

Habilite ou desabilite o 3DS nas Configurações do campo de cartão de crédito.

Consulte 3DS em Segurança para obter mais informações.

Usar várias contas do PayPal

No Payment Services, você pode usar várias contas do PayPal em uma conta de comerciante no nível do site. Por exemplo, se você estiver operando sua(s) loja(s) em vários países (que usam moedas diferentes) ou se quiser usar o Adobe Commerce para algumas partes de sua empresa, mas não todas, é possível configurar sua conta de comerciante para usar várias contas do PayPal.

Consulte Escopo de Site, Armazenamento e Exibição para obter mais informações sobre a hierarquia de sites, lojas e exibições de loja.

Consulte Configuração de linha de comando para obter mais informações sobre a configuração de escopos para várias contas do PayPal via CLI.

Seu representante de vendas pode criar um novo escopo para sua conta de comerciante e integrar o site adicional com o PayPal para que qualquer um dos botões do PayPal que você configura para aparecer apareça em seu site. Entre em contato com seu setor de Vendas
representante para obter assistência com o uso de várias contas do PayPal para seus sites.

recommendation-more-help
00b8a45a-5862-4817-8e1e-074170ebb953