Braintree
O Braintree oferece uma experiência de check-out 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. A Braintree reduz a carga de conformidade com o PCI para os comerciantes, pois a transação ocorre no sistema Braintree. A integração do Braintree Payments é desenvolvida pela GENE Commerce.
Etapa 1: Obtenha suas credenciais do Braintree
Vá para Braintree Payments e inscreva-se para obter uma conta.
Etapa 2: concluir as configurações básicas
-
Na barra lateral Admin, vá para Stores > Settings>Configuration.
-
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.
-
-
Em Recommended Solutions, na seção_Braintree Payments (por GENE Commerce v4.7.0 - Notas de Versão_, clique em Configure.
{width="600" modal="regular"}
-
Para Title, insira um título que identifique o Braintree como uma opção de pagamento durante o check-out.
-
Definir o Environment operacional atual para transações do Braintree como
SandboxouProductionAo testar a configuração em uma sandbox, use apenas números de cartão de crédito recomendados pela Braintree. Quando estiver pronto para entrar na produção com o Braintree, defina Environment como
Production. {width="600" modal="regular"}
-
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.|
-
Digite o Sandbox Merchant ID / Merchant ID da sua conta do Braintree.
-
Insira as seguintes credenciais da sua conta da 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. -
Antes de salvar a configuração, clique em Validate Credentials para validar suas credenciais.
-
Defina Enable Card Payments como
Yes. -
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. -
Se quiser que um cliente verifique o número CVV de seu cartão com cofre em cada compra, defina Enable Vault CVV Re-verification como
Yes.
Etapa 3: concluir as configurações avançadas
-
Expandir
a seção Advanced Braintree Settings.
{width="550" modal="regular"}
-
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.
-
Digite o Merchant Account ID da sua conta do 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.
-
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. -
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. -
Defina o Bypass Fraud Protection Threshold para que as verificações de
Advanced Fraud Protectionsejam ignoradas quando o limite for atingido ou excedido.Deixar esse campo em branco desativa essa opção.
-
Se quiser que o sistema salve um arquivo de log de interações entre o armazenamento e a Braintree, defina Debug como
Yes. -
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 do Braintree.
-
Para enviar os itens de linha do carrinho para todos os métodos de pagamento, defina Send Card Line Items como
Yes. -
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.
-
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: concluir as configurações de webhook do Braintree
-
Defina Enable Webhook como
Yespara habilitar a funcionalidade de webhook para proteção contra fraude, pagamentos ACH e métodos de pagamento locais. -
Copie a URL no campo Fraud Protection URL e adicione-a à sua conta da Braintree como Webhook Destination URL.
note important IMPORTANT Este URL deve ser seguro e estar acessível publicamente. -
Defina o campo Fraud Protection Approve Order Status para determinar quando a proteção contra fraude é aprovada pela Braintree.
O status do pedido selecionado é atribuído ao pedido Commerce.
-
Defina o campo Fraud Protection Reject Order Status para determinar quando a proteção contra fraude é rejeitada pela Braintree.
O status do pedido selecionado é atribuído ao pedido Commerce.
Etapa 5: concluir as configurações específicas do país
-
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.
{width="600" modal="regular"}
-
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: concluir o ACH pelas configurações do Braintree
-
Para incluir ACH como uma opção de pagamento com Braintree, defina Enable ACH Direct Debit como
Yes. -
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. -
Para Sort Order, insira um número para determinar a sequência na qual a opção de pagamento da ACH do Braintree aparece quando listada com outras opções de pagamento durante o check-out.
Etapa 7: concluir o Apple Pay pelas configurações do Braintree
-
Para incluir Apple Pay como uma opção de pagamento com o Braintree, defina Enable ApplePay through Braintree como
Yes.Certifique-se de verificar primeiro o nome de domínio na sua conta da Braintree.
-
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. -
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.
-
Para Merchant Name, insira o texto que especifica o rótulo exibido para os clientes na caixa de diálogo Pagamento do Apple.
-
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
-
Para incluir métodos de pagamento local como uma opção de pagamento com o Braintree, defina Enable Local Payment Methods como
Yes. -
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). -
Para Fallback Button Text, insira o texto a ser usado para o botão que aparece na página de fallback do Braintree para levar o cliente de volta ao site (por exemplo,
Complete Checkout). -
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). -
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) {width="600" modal="regular"}
note note NOTE A extensão fornecida do Braintree 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. -
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 por meio das configurações do Braintree
-
Para incluir Google Pay como uma opção de pagamento com o Braintree, defina Enable GooglePay Through Braintree como
Yes. -
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. -
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.
-
Defina Button Color para determinar a cor do botão Google Pay:
WhiteouBlack -
Para Merchant ID, insira sua MerchantID (fornecida pela Google).
-
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 -
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: Concluir o Venmo pelas configurações do Braintree
-
Para incluir Venmo como uma opção de pagamento com Braintree, defina Enable Venmo through Braintree como
Yes. -
Defina Enable Vault for Venmo como
Yespara 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. {width="600" modal="regular"}
-
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.
-
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 do Braintree
-
Para incluir o PayPal como uma opção de pagamento com Braintree, defina Enable PayPal through Braintree como
Yes. -
Especifique seu PayPal por meio 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 o Braintree, defina Enable PayPal Credit through Braintree como
Yes.Quando Habilitar PayPal por meio do Braintree estiver definido como
Yes, somente este campo será exibido.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 USouUK. -
Para incluir PayPal PayLater como uma opção de pagamento com o 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 do 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.
-
-
Para Title, insira um título que identifique a opção Pagamento Braintree por PayPal durante o check-out.
-
Defina Vault Enabled como
Yespara 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. -
Defina Send Cart Line Items for PayPal como
Yespara 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. -
Para Sort Order, insira um número para determinar a sequência em que a opção de pagamento do Braintree PayPal aparece quando listada com outras opções de pagamento durante o check-out.
-
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.
-
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.
-
Defina Payment from Applicable Countries como um dos seguintes valores para transações do 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.
{width="550" modal="regular"}
-
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. -
Para ignorar a página de revisão do pedido do PayPal Express, defina Skip Order Review Step como
Yes.Para clientes que pagam com o PayPal Express: se você quiser que os clientes sejam redirecionados para uma página de revisão antes de concluir o pagamento, defina como
No. Se preferir que os clientes pulem a página de revisão, defina-a comoYes. -
Para salvar um arquivo de log das interações entre seu armazenamento e o PayPal por meio do Braintree, defina Debug como
Yes. -
Para exibir o botão PayPal no carrinho e na página do carrinho de compras, defina Display on Shopping Cart como
Yes. -
Para enviar informações de rastreamento de pacote para o PayPal, defina Send Package Tracking como
Yes.As informações de rastreamento de pacotes serão enviadas ao PayPal somente para transações/pedidos do PayPal. Você deve habilitar o campo de configuração Send Cart Line Items for PayPal para que o recurso Package Tracking funcione corretamente.
-
Para notificar um Comprador ou Pagador pelo PayPal sobre as atualizações de rastreamento de pacotes, defina Use PayPal’s “Notify Payer” functionality como
Yes.
Etapa 12: definir as configurações de estilo
-
Para Location, escolha onde as mensagens e os botões do PayPal são renderizados:
Mini-Cart and Cart Page,Checkout PageouProduct Page {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.
- 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.
-
Para mostrar o botão PayPal na vitrine do local selecionado, defina Show PayPal Button como
Yes. -
Para Button Label, selecione o rótulo do botão PayPal:
Paypal,Checkout,BuynowouPay -
Para Color, selecione a cor do botão PayPal:
Blue,Black,GoldouSilver -
Para Shape, selecione a forma de botão PayPal:
PillouRectangle -
Para Size (Deprecated), selecione o tamanho do botão PayPal:
Medium,LargeouResponsive
Quando essas opções são definidas, você pode visualizar os botões PayPal. 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 os valores de mensagens de botões e 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: Pagar mensagens posteriores
Product Page
-
Para mostrar mensagens de Pay Later na loja na página do produto, defina Show PayLater Messaging como
Yes.Exibe mensagens de Pagamento Posterior para ofertas disponíveis. Restrições são aplicadas. Consulte a documentação do PayPal.
-
Para Message Layout, selecione o layout de mensagem Pay Later:
TextouFlex -
Para Logo, selecione o tipo de logotipo do PayPal:
Inline,Primary,AlternativeouNone -
Para Logo Position, selecione a posição do logotipo do PayPal:
Left,RightouTop -
Para Text Color, selecione a cor do texto da mensagem PayLater:
Black,White,MonochromeouGrayscale
Cart
-
Para mostrar mensagens de Pay Later na vitrine do carrinho ou da Página do carrinho, defina Show PayLater Messaging como
Yes.Exibe mensagens de Pagamento Posterior para ofertas disponíveis. Restrições são aplicadas. Consulte a documentação do PayPal.
-
Para Message Layout, selecione o layout de mensagem Pay Later:
TextouFlex -
Para Logo, selecione o tipo de logotipo do PayPal:
Inline,Primary,AlternativeouNone -
Para Logo Position, selecione a posição do logotipo do PayPal:
Left,RightouTop -
Para Text Color, selecione a cor do texto da mensagem PayLater:
Black,White,MonochromeouGrayscale
Checkout
-
Para mostrar mensagens de Pay Later na vitrine, defina Show PayLater Messaging como
Yes.Exibe mensagens de Pagamento Posterior para ofertas disponíveis. Restrições são aplicadas. Consulte a documentação do PayPal.
-
Para Text Align, selecione o alinhamento do texto para Pay Later mensagem:
TextouCenterouRight -
Para Text Color, selecione a cor do texto da mensagem Pay Later:
Black,White
Etapa 14: concluir as configurações de verificação 3D
-
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.
-
Para sempre desafiar a solicitação do 3D Secure para todas as transações, defina Always request 3DS como
Yes. -
Para Threshold Amount, insira o valor de pedido mínimo necessário para acionar a verificação 3D.
-
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.
{width="600" modal="regular"}
Etapa 15: configurar os descritores dinâmicos do 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 da Braintree.
-
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*myproductA primeira parte do descritor identifica a empresa ou o DBA e a segunda identifica o produto. O comprimento das partes
companyeproductdo descritor pode ser alocado das seguintes maneiras, para um comprimento combinado de até 22 caracteres.Caracteres no descritor de nome
Opção 1:
Companydeve ter três caracteres,Productpode ter até 18 caracteresOpção 2:
Companydeve ter sete caracteres,Productpode ter até 14 caracteresOpção 3:
Companydeve ter 12 caracteres,Productpode 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-9999999.999.9999 -
URL - O descritor de URL representa seu nome de domínio e pode ter até 13 caracteres. Por exemplo:
company.com
-
-
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 do Magento Open Source 2.4.0, a extensão do Braintree estará 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 do Marketplace Braintree 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 agrupada do Commerce Braintree Payments 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.