Braintree

O Braintree oferece uma experiência de finalização de compra totalmente personalizável com detecção de fraudes e integração com o PayPal. Ele oferece suporte a Apple Pay, Google Pay, ACH, Venmo e métodos de pagamento locais. O Braintree reduz a carga de conformidade PCI para os comerciantes, pois a transação ocorre no sistema Braintree. A integração do Braintree Payments é desenvolvida pela GENE Commerce.

NOTE
Se você estiver atualizando para 2.4.x de uma versão anterior do Adobe Commerce ou Magento Open Source com a extensão Braintree do Commerce Marketplace instalada, consulte as notas de atualização do 2.4 no final desta página.

Etapa 1: Obtenha suas credenciais de Braintree

Vá para Braintree Payments e inscreva-se para obter uma conta.

Etapa 2: concluir as configurações básicas

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

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

    • Se a sua instalação do Commerce tiver vários sites, lojas ou modos de exibição, no canto superior esquerdo, escolha a Store View à qual a configuração se aplica.

    • Na seção Merchant Location, verifique se Merchant Country ​está definido como o local da sua empresa.

  3. Em Recommended Solutions, na seção_Braintree Payments (por GENE Commerce v4.6.1 - Notas de Versão_, clique em Configure.

    Configurar Braintree {width="600" modal="regular"}

  4. Para Title, insira um título que identifique Braintree como uma opção de pagamento durante o check-out.

  5. Definir o Environment operacional atual para transações Braintree como Sandbox ou Production

    Ao testar a configuração em uma sandbox, use apenas números de cartão de crédito recomendados pelo Braintree. Quando estiver pronto para entrar na produção com o Braintree, defina Environment como Production.

    Configurações de Credenciais Básicas {width="600" modal="regular"}

  6. Defina Payment Action como um dos seguintes:

    • Authorize Only - Aprova a compra e suspende os fundos. O valor não é sacado da conta bancária do cliente até que a venda seja capturada pelo comerciante.|
    • Intent Sale - O valor da compra é autorizado e imediatamente retirado da conta do cliente. Observação: este valor era Autorizar e Capturar na versão 2.3.x e em versões anteriores.|
  7. Digite o Sandbox Merchant ID / Merchant ID da sua conta Braintree.

  8. Digite as seguintes credenciais da sua conta Braintree:

    • Sandbox Public Key / Public Key
    • Sandbox Private Key / Private Key
    note note
    NOTE
    Há campos separados para ambos os ambientes (Sandbox e Produção) e os outros campos são renderizados com base no ambiente selecionado.
  9. Antes de salvar a configuração, clique em Validate Credentials para validar suas credenciais.

  10. Defina Enable Card Payments como Yes.

    Configurações básicas {width="600" modal="regular"}

    Se você quiser ter a capacidade de armazenar informações do cliente com segurança, para que os clientes não precisem digitá-las novamente toda vez que fizerem uma compra, defina Enable Vault for Card Payments como Yes.

Etapa 3: concluir as configurações avançadas

  1. Expandir Seletor de expansão a seção Advanced Braintree Settings.

    Configurações avançadas {width="550" modal="regular"}

  2. Para Vault Title, insira um título descritivo para sua referência que identifique o cofre no qual as informações de seu cartão de cliente estão armazenadas.

  3. Digite o Merchant Account ID da sua conta Braintree.

    Se você não especificar a conta de comerciante a ser usada, o Braintree processará a transação usando sua conta de comerciante padrão.

  4. Para proporcionar uma experiência de finalização mais rápida com as opções de Pagamento Expresso no início do processo de finalização, incluindo PayPal, PayLater, Apple Pay e Google Pay, defina Enable Checkout Express Payments como Yes.

  5. Se você quiser impedir que a transação seja enviada para avaliação como parte das verificações das Ferramentas Avançadas de Fraude, nos pedidos feitos pelo Administrador, defina Skip Fraud Checks on Admin Orders como Yes.

  6. Defina o Bypass Fraud Protection Threshold para que as verificações de Advanced Fraud Protection sejam ignoradas quando o limite for atingido ou excedido.

    Deixar esse campo em branco desativa essa opção.

  7. Se quiser que o sistema salve um arquivo de log de interações entre o armazenamento e o Braintree, defina Debug como Yes.

  8. Para exigir que os clientes forneçam o código de segurança de três dígitos da parte de trás de um cartão de crédito, defina CVV Verification como Yes.

    Se estiver usando a verificação CVV, habilite AVS e/ou CVV na seção Configurações/Processamento da sua conta Braintree.

  9. Para enviar os itens de linha do carrinho para todos os métodos de pagamento, defina Send Card Line Items como Yes.

  10. Para Credit Card Types, selecione cada cartão de crédito aceito pela sua loja como pagamento por meio do Braintree.

    Para selecionar vários tipos de placa, mantenha pressionada a tecla Ctrl (PC) ou a tecla Command (Mac) e clique em cada opção.

  11. Para Sort Order, insira um número para determinar a sequência em que o Braintree aparece quando listado com outros métodos de pagamento durante o check-out.

Etapa 4: completar as configurações do webhook do Braintree

Configurações de Webhooks do Braintree

  1. Defina Enable Webhook como Yes para habilitar a funcionalidade de webhook para proteção contra fraude, pagamentos ACH e métodos de pagamento locais.

  2. Copie a URL no campo Fraud Protection URL e adicione-a à sua conta Braintree como Webhook Destination URL.

    note important
    IMPORTANT
    Este URL deve ser seguro e estar acessível publicamente.
  3. Defina o campo Fraud Protection Approve Order Status para determinar quando a proteção contra fraude é aprovada pelo Braintree.

    O status do pedido selecionado é atribuído ao pedido Commerce.

  4. Defina o campo Fraud Protection Reject Order Status para determinar quando a proteção contra fraude é rejeitada pelo Braintree.

    O status do pedido selecionado é atribuído ao pedido Commerce.

Etapa 5: concluir as configurações específicas do país

  1. Defina Payment from Applicable Countries como um dos seguintes:

    • All Allowed Countries - Clientes de todos os países especificados na sua configuração de loja podem usar esta forma de pagamento.
    • Specific Countries - Depois de escolher esta opção, a lista Payment from Specific Countries ​é exibida. Mantenha pressionada a tecla Ctrl (PC) ou a tecla Command (Mac) e selecione cada país na lista onde os clientes podem fazer compras na sua loja.

    Configurações específicas do país {width="600" modal="regular"}

  2. Para configurar Country Specific Credit Card Types:

    • Clique em Add.

    • Defina o Country e escolha cada Allowed Credit Card Type.

    • Repita para identificar os cartões de crédito aceitos de cada país.

Etapa 6: completar as configurações de ACH por Braintree

ACH até Braintree

  1. Para incluir ACH como uma opção de pagamento com Braintree, defina Enable ACH Direct Debit como Yes.

  2. Os clientes podem compartimentar seu método de pagamento de Débito Direto ACH de uso único e armazená-lo para uso futuro. Depois de arquivados, os clientes podem reutilizar o Débito Direto ACH sem precisar inserir novamente ou autenticar suas informações de pagamento, se definidas como Enable Vault for ACH Direct Debit a Yes.

  3. Para Sort Order, insira um número para determinar a sequência na qual a opção de pagamento Braintree ACH aparece quando listada com outras opções de pagamento durante o check-out.

Etapa 7: completar o Apple Pay através das configurações de Braintree

Configurações de ApplePay through Braintree

  1. Para incluir Apple Pay como uma opção de pagamento com Braintree, defina Enable ApplePay through Braintree como Yes.

    Certifique-se de verificar primeiro o nome de domínio em sua conta Braintree.

  2. Se você quiser ter a capacidade de armazenar informações do cliente com segurança, para que os clientes não precisem inseri-las novamente sempre que fizerem uma compra com o Apple Pay, defina Enable Vault for ApplePay como Yes.

  3. Defina Payment Action como um dos seguintes:

    • Authorize Only - Aprova a compra e suspende os fundos. O valor não é sacado da conta bancária do cliente até que a venda seja capturada pelo comerciante.
    • Intent Sale - O valor da compra é autorizado e imediatamente retirado da conta do cliente.
  4. Para Merchant Name, insira o texto que especifica o rótulo exibido para os clientes na caixa de diálogo Pagamento do Apple.

  5. Para Sort Order, insira um número para determinar a sequência em que a opção de pagamento Apple Pay aparece quando listada com outras opções de pagamento durante o check-out.

Etapa 8: concluir as configurações para métodos de pagamento locais

  1. Para incluir métodos de pagamento local como uma opção de pagamento com Braintree, defina Enable Local Payment Methods como Yes.

  2. Para Title, insira o texto a ser usado para o rótulo que aparece na seção de método de pagamento de check-out (valor padrão: Local Payments).

  3. Para Fallback Button Text, insira o texto a ser usado para o botão que aparece na página de Braintree de fallback para levar o cliente de volta ao site (por exemplo, Complete Checkout).

  4. Para Redirect on Fail, insira a URL para a qual os clientes devem ser redirecionados quando as transações do método de pagamento local forem canceladas, com falha ou encontrarem erros. Deve ser a página de pagamento do check-out (por exemplo, https://www.domain.com/checkout#payment).

  5. Para Allowed Payment Methods, selecione o método de pagamento local a ser habilitado.

    Opções: Bancontact / EPS / giropay / iDeal / Klarna Pay Now / SOFORT / MyBank / P24 / SEPA/ELV Direct Debit (ainda não suportado)

    Configurações de Métodos de Pagamento Locais {width="600" modal="regular"}

    note note
    NOTE
    A extensão de Braintree agrupada não oferece suporte a todos os métodos de pagamento locais listados na documentação do desenvolvedor de Braintree. Outros métodos de pagamento locais estão em desenvolvimento para serem compatíveis em versões futuras.
  6. Para Sort Order, insira um número para determinar a sequência em que o método de pagamento local aparece quando listado com outras opções de pagamento durante o check-out.

Etapa 9: Concluir o Google Pay pelas configurações de Braintree

Pagar através do Braintree {width="600" modal="regular"} da Google

  1. Para incluir Google Pay como uma opção de pagamento com Braintree, defina Enable GooglePay Through Braintree como Yes.

  2. Se você quiser ter a capacidade de armazenar informações do cliente com segurança, para que os clientes não precisem inseri-las novamente sempre que fizerem uma compra com o Google Pay, defina Enable Vault for GooglePay como Yes.

  3. Defina Payment Action como um dos seguintes:

    • Authorize Only - Aprova a compra e suspende os fundos. O valor não é sacado da conta bancária do cliente até que a venda seja capturada pelo comerciante.
    • Intent Sale - O valor da compra é autorizado e imediatamente retirado da conta do cliente.
  4. Defina Button Color para determinar a cor do botão Google Pay: White ou Black

  5. Para Merchant ID, insira sua MerchantID (fornecida pela Google).

  6. Para Accepted Cards, selecione o tipo de cartões que um cliente pode usar para fazer um pedido usando Google Pay.

    Opções: Visa / MasterCard / AMEX / Discover / JCB

  7. Para Sort Order, insira um número para determinar a sequência em que Google Pay aparece quando listado com outras opções de pagamento durante o check-out.

Etapa 10: completar as configurações de Venmo até Braintree

  1. Para incluir Venmo como uma opção de pagamento com Braintree, defina Enable Venmo through Braintree como Yes.

  2. Defina Enable Vault for Venmo como Yes para habilitar o uso de um cofre seguro para armazenar a conta Venmo dos clientes, de modo que os clientes não precisem fazer logon na conta Venmo novamente para transações futuras.

    Venmo até Braintree {width="600" modal="regular"}

  3. Defina Payment Action como um dos seguintes:

    • Authorize Only - Aprova a compra e suspende os fundos. O valor não é sacado da conta bancária do cliente até que a venda seja capturada pelo comerciante.
    • Intent Sale - O valor da compra é autorizado e imediatamente retirado da conta do cliente.
  4. Para Sort Order, insira um número para determinar a sequência em que Venmo aparece quando listado com outras opções de pagamento durante o check-out.

Etapa 11: Concluir o PayPal por meio das configurações de Braintree

PayPal por meio das Configurações de Braintree

  1. Para incluir o PayPal como uma opção de pagamento com Braintree, defina Enable PayPal through Braintree como Yes.

  2. Especifique seu PayPal através do método de pagamento Braintree:

    note note
    NOTE
    PayPal Credit ou PayPal PayLater pode ser habilitado. Ambos os métodos não podem ser ativados ao mesmo tempo.
    • Para incluir PayPal Credit como uma opção de pagamento com Braintree, defina Enable PayPal Credit through Braintree como Yes.

      Quando Habilitar PayPal via Braintree estiver definido como Yes, somente este campo aparecerá.

      note note
      NOTE
      O PayPal Credit só está disponível nos Estados Unidos e no Reino Unido. O Crédito do PayPal estará desabilitado se o valor selecionado para o campo Merchant Country ​não for US ou UK.
    • Para incluir PayPal PayLater como uma opção de pagamento com Braintree, defina Enable PayPal PayLater through Braintree como Yes.

      Quando Enable PayPal PayLater through Braintree estiver definido como Yes, somente este campo aparecerá.

      Você pode exibir mensagens do PayLater no seu site para ofertas, como o Pay in 3, que permite que os clientes paguem com três pagamentos mensais sem juros. A integração Braintree pode exibir mensagens no site para promover esse recurso. Não é possível promover ofertas do PayLater com qualquer outro conteúdo, marketing ou material.

  3. Para Title, insira um título que identifique a opção Braintree pagamento por PayPal durante o check-out.

  4. Defina Vault Enabled como Yes para habilitar o uso de um cofre seguro para armazenar a conta do PayPal dos clientes. A conta do PayPal com cofre pode ser usada para transações futuras, o que reduz o número de etapas para os clientes.

  5. Defina Send Cart Line Items for PayPal como Yes para enviar os itens de linha (itens de pedido) ao PayPal junto com Cartões-presente, Empacotamento de presente para itens, Empacotamento de presente para pedido, Crédito da loja, Remessa e Imposto como itens de linha.

  6. Para Sort Order, insira um número para determinar a sequência em que a opção de pagamento Braintree do PayPal aparece quando listada com outras opções de pagamento durante o check-out.

  7. Para exibir seu nome de comerciante de forma diferente do definido em sua configuração de armazenamento, digite o nome no campo Override Merchant Name da maneira que deseja que ele seja exibido.

  8. Defina Payment Action como um dos seguintes:

    • Authorize Only - Aprova a compra e suspende os fundos. O valor não é sacado da conta bancária do cliente até que a venda seja capturada pelo comerciante.
    • Authorize and Capture - O valor da compra é autorizado e imediatamente retirado da conta do cliente.
  9. Defina Payment from Applicable Countries como um dos seguintes valores para transações de Braintree processadas pelo PayPal:

    • All Allowed Countries - Clientes de todos os países especificados na sua configuração de loja podem usar esta forma de pagamento.
    • Specific Countries - Depois de escolher esta opção, a lista Payment from Specific Countries ​é exibida. Mantenha pressionada a tecla Ctrl (PC) ou a tecla Command (Mac) e selecione cada país na lista onde os clientes podem fazer compras na sua loja.
  10. Para exigir que os clientes forneçam um endereço de cobrança, defina Require Customer’s Billing Address como Yes.

    note note
    NOTE
    Este recurso deve ser habilitado para sua conta pelo Suporte Técnico do PayPal.
  11. Para salvar um arquivo de log das interações entre seu armazenamento e o PayPal por meio do Braintree, defina Debug como Yes.

  12. Para exibir o botão PayPal no carrinho e na página do carrinho de compras, defina Display on Shopping Cart como Yes.

Etapa 12: definir as configurações de estilo

  1. Para Location, escolha onde as mensagens e os botões do PayPal são renderizados: Mini-Cart and Cart Page, Checkout Page ou Product Page

    Configurações de Estilo do PayPal {width="600" modal="regular"}

Mini-Cart and Cart Page

As opções e configurações desta seção variam de acordo com a configuração no campo Location.

  1. Defina PayPal Button Type como um dos três tipos de botões: PayPal Button / PayPal Pay Later Button / PayPal Credit Button

PayPal Button

As opções e configurações desta seção variam de acordo com o tipo de botão selecionado no campo PayPal Button Type.

  1. Para mostrar o botão PayPal na vitrine do local selecionado, defina Show PayPal Button como Yes.

  2. Para Button Label, selecione o rótulo do botão PayPal: Paypal, Checkout, Buynow ou Pay

  3. Para Color, selecione a cor do botão PayPal: Blue, Black, Gold ou Silver

  4. Para Shape, selecione a forma de botão PayPal: Pill ou Rectangle

  5. Para Size (Deprecated), selecione o tamanho do botão PayPal: Medium, Large ou Responsive

NOTE
O campo de configuração Size(Deprecated) está obsoleto e não está sendo usado para estilizar os botões PayPal.

PayLater Messaging

  1. Para mostrar mensagens de PayLater na loja no local selecionado, defina Show PayLater Messaging como Yes.

    Esta mensagem inclui a exibição de PayLater mensagens para ofertas disponíveis (se aplicam restrições).

  2. Para Message Layout, selecione o layout de mensagem PayLater: Text ou Flex

  3. Para Logo, selecione o tipo de logotipo do PayPal: Inline, Primary, Alternative ou None

  4. Para Logo Position, selecione a posição do logotipo do PayPal: Left, Right ou Top

  5. Para Text Color, selecione a cor do texto da mensagem PayLater: Black, White, Monochrome ou Grayscale

Quando essas opções são definidas, você pode visualizar os botões do PayPal e as mensagens do PayLater. Há controles que você pode usar para aplicar as configurações ou redefinir os valores:

  • Para armazenar as configurações de estilo selecionadas para mensagens de botões e PayLater e aplicá-las ao local atual e ao tipo de botão atual, clique em Apply.

  • para armazenar as configurações de estilo selecionadas para botões e valores de mensagens do PayLater e aplicá-las a todos os tipos e localizações de botões, clique em Apply to All Buttons.

  • Para retornar as configurações de estilo aos valores padrão recomendados para mensagens de botões e PayLater e aplicá-las a todos os tipos e locais de botões, clique em Reset to Recommended Defaults.

Etapa 13: Concluir as configurações de verificação 3D

  1. Se você quiser adicionar uma etapa de verificação para clientes que usam cartões de crédito inscritos em um programa de verificação (como Verificado pela VISA), defina 3D Secure Verification como Yes.

    Durante o processo, o valor da transação enviado para verificação é verificado em relação ao valor enviado para autorização.

  2. Para sempre desafiar a solicitação do 3D Secure para todas as transações, defina Always request 3DS como Yes.

  3. Para Threshold Amount, insira o valor de pedido mínimo necessário para acionar a verificação 3D.

  4. Defina Verify for Applicable Countries como um dos seguintes:

    • All Allowed Countries - Clientes de todos os países especificados na sua configuração de loja podem usar esta forma de pagamento.
    • Specific Countries - Depois de escolher esta opção, a lista Verify for Specific Countries ​é exibida. Mantenha pressionada a tecla Ctrl (PC) ou a tecla Command (Mac) e selecione cada país na lista onde os clientes podem fazer compras na sua loja.

    configurações de verificação 3D {width="600" modal="regular"}

Etapa 14: configurar os descritores dinâmicos de Braintree

Os descritores a seguir são usados para identificar compras em demonstrativos de cartão de crédito do cliente. Você pode reduzir o número de cobranças retroativas identificando claramente a empresa associada a cada compra. Se os descritores dinâmicos não estiverem ativados para sua conta, entre em contato com o suporte ao Braintree.

Descritores dinâmicos

  1. Insira o descritor dinâmico para Name, Phone e URL de acordo com estas diretrizes:

    • Name - Há duas partes no descritor de nome, separadas por um asterisco (*). Por exemplo:

      company*myproduct

      A primeira parte do descritor identifica a empresa ou o DBA e a segunda identifica o produto. O comprimento das partes company e product do descritor pode ser alocado das seguintes maneiras, para um comprimento combinado de até 22 caracteres.

      Caracteres no descritor de nome

      Opção 1: Company deve ter três caracteres, Product pode ter até 18 caracteres

      Opção 2: Company deve ter sete caracteres, Product pode ter até 14 caracteres

      Opção 3: Company deve ter 12 caracteres, Product pode ter até nove caracteres

    • Phone - O descritor de telefone deve ter de 10 a 14 caracteres e pode incluir apenas números, traços, parênteses e pontos. Por exemplo:

      9999999999

      (999) 999-9999

      999.999.9999

    • URL - O descritor de URL representa seu nome de domínio e pode ter até 13 caracteres. Por exemplo:

      company.com

  2. Quando a configuração do Braintree estiver concluída, clique em Save Config.

Notas de atualização do 2.4

A partir do Adobe Commerce e Magento Open Source 2.4.0, a extensão Braintree está incluída na versão. Se você estiver migrando para o Commerce 2.4.x a partir de uma versão anterior à 2.4.0 que tenha a extensão Braintree do Marketplace instalada, desinstale essa extensão (paypal/module-braintree ou gene/module-braintree) e atualize todas as personalizações de código para usar o namespace PayPal_Braintree em vez de Magento_Braintree. As configurações da extensão principal do Commerce Braintree Payments agrupada e da extensão distribuída no Commerce Marketplace persistem e os pagamentos colocados com essas versões anteriores ainda podem ser capturados, anulados ou reembolsados normalmente.

recommendation-more-help
dacea746-44a9-4368-b3fb-3bcff64c6be1