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.
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
-
No Admin barra lateral, 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 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.
-
-
Em Recommended Solutions, no_Braintree Payments (por GENE Commerce v4.6.1 - Notas de versão_clique em Configure.
-
Para Title, insira um título que identifique o Braintree como uma opção de pagamento durante o check-out.
-
Definir o sistema operacional atual Environment para transações Braintree a
Sandbox
ouProduction
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
. -
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.|
-
Insira o Sandbox Merchant ID / Merchant ID da sua conta Braintree.
-
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. -
Antes de salvar a configuração, clique em Validate Credentials para validar suas credenciais.
-
Definir Enable Card Payments para
Yes
.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
-
Expandir
-
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.
-
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.
-
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
. -
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
. -
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.
-
Se quiser que o sistema salve um arquivo de log de interações entre a loja e o Braintree, defina Debug para
Yes
. -
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.
-
Para enviar os itens de linha do carrinho para todos os métodos de pagamento, defina Send Card Line Items para
Yes
. -
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.
-
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
-
Definir Enable Webhook para
Yes
para ativar a funcionalidade webhook para proteção contra fraude, pagamentos ACH e métodos de pagamento locais. -
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. -
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.
-
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
-
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.
-
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
-
Para incluir ACH como uma opção de pagamento com Braintree, defina Enable ACH Direct Debit para
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 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
. -
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
-
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.
-
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
. -
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.
-
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 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
-
Para incluir métodos de pagamento local como uma opção de pagamento com Braintree, defina Enable Local Payment Methods para
Yes
. -
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
). -
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
). -
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
). -
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)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. -
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
-
Para incluir Google Pay como uma opção de pagamento com Braintree, defina Enable GooglePay Through Braintree para
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 para
Yes
. -
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.
-
Definir Button Color para determinar a cor do Google Pay botão:
White
ouBlack
-
Para Merchant ID, digite sua ID do comerciante (fornecida pela Google).
-
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
-
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
-
Para incluir Venmo como uma opção de pagamento com Braintree, defina Enable Venmo through Braintree para
Yes
. -
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. -
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.
-
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
-
Para incluir o PayPal como uma opção de pagamento com Braintree, defina Enable PayPal through Braintree para
Yes
. -
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
ouUK
. -
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.
-
-
Para Title, insira um título que identifique a opção Braintree payment by PayPal durante o check-out.
-
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. -
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. -
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.
-
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.
-
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.
-
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.
-
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. -
Para salvar um arquivo de log das interações entre sua loja e o PayPal por meio do Braintree, defina Debug para
Yes
. -
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
-
Para Location, escolha onde as mensagens e os botões do PayPal são renderizados:
Mini-Cart and Cart Page
,Checkout Page
ouProduct Page
Mini-Cart and Cart Page
As opções e configurações desta seção variam de acordo com a configuração no Location campo.
- 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.
-
Para mostrar o botão PayPal na vitrine do local selecionado, defina Show PayPal Button para
Yes
. -
Para Button Label, selecione o rótulo do botão PayPal:
Paypal
,Checkout
,Buynow
ouPay
-
Para Color, selecione a cor do botão PayPal:
Blue
,Black
,Gold
ouSilver
-
Para Shape, selecione a forma do botão PayPal:
Pill
ouRectangle
-
Para Size (Deprecated), selecione o tamanho do botão PayPal:
Medium
,Large
ouResponsive
PayLater Messaging
-
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).
-
Para Message Layout, selecione o PayLater layout de mensagem:
Text
ouFlex
-
Para Logo, selecione o tipo de logotipo PayPal:
Inline
,Primary
,Alternative
ouNone
-
Para Logo Position, selecione a posição do logotipo do PayPal:
Left
,Right
ouTop
-
Para Text Color, selecione o PayLater cor do texto da mensagem:
Black
,White
,Monochrome
ouGrayscale
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
-
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.
-
Para sempre desafiar a solicitação do 3D Secure para todas as transações, defina Always request 3DS para
Yes
. -
Para Threshold Amount, insira o valor mínimo do pedido necessário para acionar a verificação 3D.
-
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.
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.
-
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
eproduct
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 caracteresOpção 2:
Company
deve ter sete caracteres,Product
pode ter até 14 caracteresOpçã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
-
-
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.