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 suporta 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 estiver atualizando para 2.4.x a partir de uma versão anterior do Adobe Commerce ou Magento Open Source com a extensão Braintree da Commerce Marketplace instalada, consulte a Notas de atualização do 2.4 no final desta página.

Etapa 1: Obtenha suas credenciais de Braintree

Ir para Pagamentos Braintree e cadastre-se em uma conta.

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

  1. No Admin barra lateral, 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 visualizações, no canto superior esquerdo, escolha a Store View onde a configuração se aplica.

    • No Merchant Location, verifique se Merchant Country ​O está definido como o local da sua empresa.

  3. Em Recommended Solutions, no_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 o Braintree como uma opção de pagamento durante o check-out.

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

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

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

  6. Definir Payment Action a 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 capturado pelo comerciante.|
    • Intent Sale - O valor da compra é autorizado e imediatamente retirado da conta do cliente. Nota: Esse valor foi Autorizar e capturar nas versões 2.3.x e anteriores.|
  7. Insira 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 (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. Definir Enable Card Payments para Yes.

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

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

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

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

    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 cartão do cliente estão armazenadas.

  3. Insira 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 para 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, em pedidos feitos por meio do Administrador, defina Skip Fraud Checks on Admin Orders para Yes.

  6. Defina o Bypass Fraud Protection Threshold para que o Advanced Fraud Protection as verificações são ignoradas quando o limite é 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 a loja e o Braintree, defina Debug para Yes.

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

    Se estiver usando a verificação CVV, habilite o AVS e/ou CVV no Configurações/Processamento seção 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 para Yes.

  10. Para Credit Card Types, selecione cada cartão de crédito aceito pela 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, informe um número para determinar a sequência em que o Braintree aparece quando listado com outros métodos de pagamento durante a finalização da compra.

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

Configurações de webhooks do Braintree

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

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

    note important
    IMPORTANT
    Este URL deve ser seguro e estar acessível publicamente.
  3. Defina o 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 de Comércio.

  4. Defina o 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 de Comércio.

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

  1. Definir Payment from Applicable Countries a um dos seguintes:

    • All Allowed Countries - Clientes de todos os países especificado na configuração da loja pode usar esse método de pagamento.
    • Specific Countries - Após escolher esta opção, o 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 por Braintree

  1. Para incluir ACH como uma opção de pagamento com Braintree, defina Enable ACH Direct Debit para 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 salvos, os clientes podem reutilizar o Débito Direto ACH sem precisar inserir novamente ou autenticar suas informações de pagamento, se definidas Enable Vault for ACH Direct Debit para Yes.

  3. Para Sort Order, informe um número para determinar a sequência na qual a opção de pagamento Braintree ACH aparecerá quando listada com outras opções de pagamento durante o checkout.

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

ApplePay por meio das configurações de Braintree

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

    Verifique se verifique o nome do domínio em sua conta Braintree primeiro.

  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 para Yes.

  3. Definir Payment Action a 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 capturado 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 na qual Apple Pay opção de pagamento aparece quando listada com outras opções de pagamento durante a finalização da compra.

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 para Yes.

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

  3. Para Fallback Button Text, digite 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 o URL para o qual os clientes devem ser redirecionados quando as transações do método de pagamento local forem canceladas, reprovadas ou encontrarem erros. Deve ser a página de pagamento do checkout (por exemplo, https://www.domain.com/checkout#payment).

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

    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 do Braintree. Outros métodos de pagamento locais estão em desenvolvimento para serem compatíveis em versões futuras.
  6. Para Sort Order, informe um número para determinar a sequência em que o método de pagamento local será exibido quando listado com outras opções de pagamento durante a finalização da compra.

Etapa 9: conclua o Google Pay através das configurações de Braintree

Google Pay through Braintree

  1. Para incluir Google Pay como uma opção de pagamento com Braintree, defina Enable GooglePay Through Braintree para 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 para Yes.

  3. Definir Payment Action a 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 capturado pelo comerciante.
    • Intent Sale - O valor da compra é autorizado e imediatamente retirado da conta do cliente.
  4. Definir Button Color para determinar a cor do Google Pay botão: White ou Black

  5. Para Merchant ID, digite sua ID do comerciante (fornecida pela Google).

  6. Para Accepted Cards, selecione os tipos 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 na qual Google Pay é exibido quando listado com outras opções de pagamento durante a finalização da compra.

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 para Yes.

  2. Definir Enable Vault for Venmo para Yes ativar o uso de um cofre seguro para armazenar a conta Venmo dos clientes para que eles não precisem fazer logon na conta Venmo novamente para transações futuras.

    Venmo por Braintree {width="600" modal="regular"}

  3. Definir Payment Action a 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 capturado 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 de Configurações de Braintree

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

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

    note note
    NOTE
    Ou PayPal Credit ou PayPal PayLater pode ser ativado. 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 para Yes.

      Quando Habilitar PayPal por meio do Braintree está definida como Yes, somente esse 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á desativado se o valor selecionado para o Merchant Country ​o campo não está US ou UK.
    • Para incluir PayPal PayLater como uma opção de pagamento com Braintree, defina Enable PayPal PayLater through Braintree para Yes.

      Quando Enable PayPal PayLater through Braintree está definida como Yes, somente esse campo aparecerá.

      Você pode exibir mensagens do PayLater no seu site para ofertas, como Pagamento em 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 payment by PayPal durante o check-out.

  4. Definir Vault Enabled para Yes para permitir 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. Definir Send Cart Line Items for PayPal para Yes enviar os itens de linha (itens de pedido) para PayPal juntamente com Cartões-presente, Empacotamento de presente para itens, Empacotamento de presente para pedido, Crédito da loja, Envio e Imposto como itens de linha.

  6. Para Sort Order, digite um número para determinar a sequência na qual 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 que está definido em seu configuração da loja, digite o nome no campo Override Merchant Name como você deseja que ele apareça.

  8. Definir Payment Action a 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 capturado pelo comerciante.
    • Authorize and Capture - O valor da compra é autorizado e imediatamente retirado da conta do cliente.
  9. Definir Payment from Applicable Countries a um dos seguintes para transações Braintree processadas pelo PayPal:

    • All Allowed Countries - Clientes de todos os países especificado na configuração da loja pode usar esse método de pagamento.
    • Specific Countries - Após escolher esta opção, o 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 faturamento, defina Require Customer’s Billing Address para 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 sua loja e o PayPal por meio do Braintree, defina Debug para Yes.

  12. Para exibir o botão PayPal no carrinho e na página do carrinho de compras, defina Display on Shopping Cart para 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 Pageou 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 Location ​campo.

  1. Definir PayPal Button Type para 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 PayPal Button Type ​campo.

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

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

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

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

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

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

PayLater Messaging

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

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

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

  3. Para Logo, selecione o tipo de logotipo PayPal: Inline, Primary, Alternativeou None

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

  5. Para Text Color, selecione o PayLater cor do texto da mensagem: Black, White, Monochromeou 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 locais 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), definir 3D Secure Verification para 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 para Yes.

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

  4. Definir Verify for Applicable Countries a um dos seguintes:

    • All Allowed Countries - Clientes de todos os países especificado na configuração da loja pode usar esse método de pagamento.
    • Specific Countries - Após escolher esta opção, o 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 o Name, Phone, e URL de acordo com essas 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 do company e product partes do descritor podem ser alocadas 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 conter 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 conter até nove caracteres

    • Phone - O descritor de telefone deve ter entre 10 e 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 de uma versão anterior à 2.4.0 que tenha a extensão Braintree do Marketplace instalada, será necessário desinstalar essa extensão (paypal/module-braintree ou gene/module-braintree) e atualizar qualquer personalização de código para usar o PayPal_Braintree namespace 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 feitos com essas versões anteriores ainda podem ser capturados, anulados ou reembolsados normalmente.

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