Braintree
Braintree ofrece una experiencia de pago totalmente personalizable con detección de fraude e integración con PayPal. Admite Apple Pay, Google Pay, ACH, Venmo y métodos de pago locales. Braintree reduce la carga de conformidad con PCI para los comerciantes porque la transacción se realiza en el sistema Braintree. La integración de pagos de Braintree es desarrollada por GENE Commerce.
Paso 1: Conseguir las credenciales de Braintree
Vaya a Pagos de Braintree y regístrese para obtener una cuenta.
Paso 2: completar la configuración básica
-
En la barra lateral Admin, vaya a Stores > Settings>Configuration.
-
En el panel izquierdo, expanda Sales y elija Payment Methods.
-
Si la instalación de Commerce tiene varios sitios web, tiendas o vistas, elija Store View en la esquina superior izquierda donde se aplica la configuración.
-
En la sección Merchant Location, compruebe que Merchant Country está establecido en la ubicación de su empresa.
-
-
En Recommended Solutions, en la sección_Braintree Payments (por GENE Commerce v4.6.1 - Notas de la versión_, haga clic en Configure.
{width="600" modal="regular"}
-
Para Title, escribe un título que identifique al Braintree como una opción de pago durante el cierre de compra.
-
Establecer Environment operativo actual para transacciones de Braintree en
Sandbox
oProduction
Al probar la configuración en una zona protegida, use solamente números de tarjeta de crédito recomendados por el Braintree. Cuando esté listo para ir a producción con Braintree, establezca Environment en
Production
.{width="600" modal="regular"}
-
Establezca Payment Action en una de las siguientes opciones:
Authorize Only
- Aprueba la compra y suspende los fondos. El importe no se retira de la cuenta bancaria del cliente hasta que el comerciante capture la venta.|Intent Sale
: el importe de la compra se autoriza y se retira inmediatamente de la cuenta del cliente. Nota: Este valor era Autorizar y capturar en 2.3.x y versiones anteriores.|
-
Escriba Sandbox Merchant ID / Merchant ID desde su cuenta de Braintree.
-
Introduzca las siguientes credenciales de su cuenta de Braintree:
- Sandbox Public Key / Public Key
- Sandbox Private Key / Private Key
note note NOTE Hay campos independientes para los entornos (espacio aislado y producción), y los demás campos se representan en función del entorno seleccionado. -
Antes de guardar la configuración, haga clic en Validate Credentials para validar las credenciales.
-
Establezca Enable Card Payments en
Yes
.{width="600" modal="regular"}
Si desea poder almacenar la información de los clientes de forma segura, de modo que los clientes no tengan que volver a introducirla cada vez que realicen una compra, establezca Enable Vault for Card Payments en
Yes
.
Paso 3: Completar la configuración avanzada
-
Expanda en la sección Advanced Braintree Settings.
{width="550" modal="regular"}
-
Para Vault Title, escriba un título descriptivo para la referencia que identifique el almacén donde se almacena la información de la tarjeta de cliente.
-
Escriba Merchant Account ID desde su cuenta de Braintree.
Si no especifica la cuenta de comerciante que se va a utilizar, Braintree procesa la transacción con la cuenta de comerciante predeterminada.
-
Para ofrecer una experiencia de pago y envío más rápida con las opciones de Pago exprés al comienzo del proceso de pago, incluidas PayPal, PayAfter, Apple Pay y Google Pay, establezca Enable Checkout Express Payments en
Yes
. -
Si desea evitar que la transacción se envíe para su evaluación como parte de las comprobaciones de las herramientas de fraude avanzado, en los pedidos realizados a través del administrador, establezca Skip Fraud Checks on Admin Orders en
Yes
. -
Establezca Bypass Fraud Protection Threshold de modo que se omitan las comprobaciones
Advanced Fraud Protection
cuando se alcance o supere el umbral.Si deja este campo en blanco, se deshabilita esta opción.
-
Si desea que el sistema guarde un archivo de registro de interacciones entre el almacén y el Braintree, establezca Debug en
Yes
. -
Para exigir a los clientes que proporcionen el código de seguridad de tres dígitos del reverso de una tarjeta de crédito, establezca CVV Verification en
Yes
.Si usas la verificación CVV, asegúrate de habilitar AVS y/o CVV en la sección Configuración/Procesamiento de tu cuenta de Braintree.
-
Para enviar los elementos de línea de carro de compras para todos los métodos de pago, establezca Send Card Line Items en
Yes
. -
Para Credit Card Types, selecciona cada tarjeta de crédito que tu tienda acepte como pago mediante Braintree.
Para seleccionar varios tipos de tarjetas, mantenga presionada la tecla Ctrl (PC) o la tecla Comando (Mac) y haga clic en cada opción.
-
Para Sort Order, escribe un número para determinar la secuencia en la que aparece el Braintree cuando aparece con otros métodos de pago durante el cierre de compra.
Paso 4: Completar la configuración del webhook de Braintree
-
Establezca Enable Webhook en
Yes
para habilitar la funcionalidad de webhook para la protección contra fraudes, pagos ACH y métodos de pago locales. -
Copie la dirección URL en el campo Fraud Protection URL y agréguela a su cuenta de Braintree como Webhook Destination URL.
note important IMPORTANT Esta URL debe ser segura y accesible públicamente. -
Establezca el campo Fraud Protection Approve Order Status para determinar cuándo el Braintree aprueba la protección contra el fraude.
El estado del pedido seleccionado se asigna al pedido de Commerce.
-
Establezca el campo Fraud Protection Reject Order Status para determinar cuándo el Braintree rechaza la protección contra el fraude.
El estado del pedido seleccionado se asigna al pedido de Commerce.
Paso 5: Completar la configuración específica de un país
-
Establezca Payment from Applicable Countries en una de las siguientes opciones:
All Allowed Countries
: los clientes de todos los países especificados en la configuración de su tienda pueden usar este método de pago.Specific Countries
- Después de elegir esta opción, aparece la lista Payment from Specific Countries. Mantenga pulsada la tecla Ctrl (PC) o la tecla Comando (Mac) y seleccione cada país de la lista donde los clientes pueden realizar compras en su tienda.
{width="600" modal="regular"}
-
Para configurar Country Specific Credit Card Types:
-
Haga clic en Add.
-
Establezca Country y elija cada Allowed Credit Card Type.
-
Repita el proceso para identificar las tarjetas de crédito que se aceptan en cada país.
-
Paso 6: Completar la ACH mediante la configuración del Braintree
-
Para incluir ACH como opción de pago con el Braintree, establezca Enable ACH Direct Debit en
Yes
. -
Los clientes pueden depositar su método de pago mediante domiciliación bancaria ACH de un solo uso y almacenarlo para uso futuro. Una vez realizada la operación, los clientes pueden reutilizar la domiciliación bancaria de ACH sin necesidad de volver a introducir o autenticar su información de pago si se establece Enable Vault for ACH Direct Debit en
Yes
. -
Para Sort Order, introduzca un número para determinar la secuencia en la que aparece la opción de pago ACH de Braintree cuando se enumera con otras opciones de pago durante el cierre de compra.
Paso 7: Completar Apple Pay mediante la configuración del Braintree
-
Para incluir Apple Pay como opción de pago con el Braintree, establezca Enable ApplePay through Braintree en
Yes
.Asegúrate de comprobar primero tu nombre de dominio en tu cuenta de Braintree.
-
Si desea poder almacenar la información de los clientes de forma segura, de modo que los clientes no tengan que volver a introducirla cada vez que realicen una compra con Apple Pay, establezca Enable Vault for ApplePay en
Yes
. -
Establezca Payment Action en una de las siguientes opciones:
Authorize Only
- Aprueba la compra y suspende los fondos. La cantidad no se retira de la cuenta bancaria del cliente hasta que el comerciante capture la venta.Intent Sale
: el importe de la compra se autoriza y se retira inmediatamente de la cuenta del cliente.
-
Para Merchant Name, escriba un texto que especifique la etiqueta que se mostrará a los clientes en el cuadro de diálogo Apple Pay.
-
Para Sort Order, escriba un número para determinar la secuencia en la que aparece la opción de pago Apple Pay cuando se enumera con otras opciones de pago durante el cierre de compra.
Paso 8: Completa la configuración de los métodos de pago locales
-
Para incluir métodos de pago locales como opción de pago con el Braintree, establezca Enable Local Payment Methods en
Yes
. -
Para Title, escriba el texto que se usará para la etiqueta que aparece en la sección de método de pago de pago (valor predeterminado:
Local Payments
). -
Para Fallback Button Text, escriba el texto que se usará para el botón que aparece en la página del Braintree de reserva para devolver al cliente al sitio web (por ejemplo,
Complete Checkout
). -
Para Redirect on Fail, escriba la dirección URL a la que se debe redirigir a los clientes cuando se cancelen, fallen o encuentren errores en las transacciones de métodos de pago locales. Debe ser la página de pago y envío (por ejemplo,
https://www.domain.com/checkout#payment
). -
Para Allowed Payment Methods, selecciona el método de pago local que se habilitará.
Opciones:
Bancontact
/EPS
/giropay
/iDeal
/Klarna Pay Now
/SOFORT
/MyBank
/P24
/SEPA/ELV Direct Debit
(aún no es compatible){width="600" modal="regular"}
note note NOTE La extensión de Braintree empaquetada no admite todos los métodos de pago locales enumerados en la documentación de desarrollador de Braintree. Se están desarrollando otros métodos de pago locales que se admitirán en futuras versiones. -
Para Sort Order, escribe un número para determinar la secuencia en la que aparece el método de pago local cuando se enumera con otras opciones de pago durante el cierre de compra.
Paso 9: Completar Google Pay mediante la configuración del Braintree
-
Para incluir Google Pay como opción de pago con el Braintree, establezca Enable GooglePay Through Braintree en
Yes
. -
Si desea poder almacenar la información de los clientes de forma segura, de modo que los clientes no tengan que volver a introducirla cada vez que realicen una compra con Google Pay, establezca Enable Vault for GooglePay en
Yes
. -
Establezca Payment Action en una de las siguientes opciones:
Authorize Only
- Aprueba la compra y suspende los fondos. La cantidad no se retira de la cuenta bancaria del cliente hasta que el comerciante capture la venta.Intent Sale
: el importe de la compra se autoriza y se retira inmediatamente de la cuenta del cliente.
-
Establezca Button Color para determinar el color del botón Google Pay:
White
oBlack
-
Para Merchant ID, ingrese su MerchantID (proporcionado por Google).
-
Para Accepted Cards, seleccione el tipo de tarjetas que un cliente puede usar para realizar un pedido con Google Pay.
Opciones:
Visa
/MasterCard
/AMEX
/Discover
/JCB
-
Para Sort Order, escriba un número para determinar la secuencia en la que Google Pay aparece cuando se enumera con otras opciones de pago durante el cierre de compra.
Paso 10: Completar el Venmo mediante la configuración del Braintree
-
Para incluir Venmo como opción de pago con el Braintree, establezca Enable Venmo through Braintree en
Yes
. -
Establezca Enable Vault for Venmo en
Yes
para habilitar el uso de un almacén seguro para almacenar la cuenta de Venmo de los clientes, de modo que los clientes no tengan que volver a iniciar sesión en su cuenta de Venmo para futuras transacciones.{width="600" modal="regular"}
-
Establezca Payment Action en una de las siguientes opciones:
Authorize Only
- Aprueba la compra y suspende los fondos. La cantidad no se retira de la cuenta bancaria del cliente hasta que el comerciante capture la venta.Intent Sale
: el importe de la compra se autoriza y se retira inmediatamente de la cuenta del cliente.
-
Para Sort Order, ingrese un número para determinar la secuencia en la que Venmo aparece cuando se enumera con otras opciones de pago durante el cierre de compra.
Paso 11: Completa la configuración de PayPal mediante el Braintree
-
Para incluir PayPal como opción de pago con el Braintree, establece Enable PayPal through Braintree en
Yes
. -
Especifica tu forma de pago mediante PayPal para el Braintree:
note note NOTE Se puede habilitar PayPal Credit o PayPal PayLater. Ambos métodos no se pueden habilitar al mismo tiempo. -
Para incluir PayPal Credit como opción de pago con el Braintree, establezca Enable PayPal Credit through Braintree en
Yes
.Cuando Habilitar PayPal mediante el Braintree se establece en
Yes
, solo aparece este campo.note note NOTE El crédito de PayPal solo está disponible en los Estados Unidos y el Reino Unido. El crédito de PayPal está deshabilitado si el valor seleccionado para el campo Merchant Country no es US
niUK
. -
Para incluir PayPal PayLater como opción de pago con el Braintree, establezca Enable PayPal PayLater through Braintree en
Yes
.Cuando Enable PayPal PayLater through Braintree se establece en
Yes
, solo aparece este campo.Puede mostrar la mensajería PayAfter en su sitio para ofertas como Pagar en 3, que permite a los clientes pagar con tres pagos mensuales sin intereses. La integración de Braintree puede mostrar mensajes en el sitio para promocionar esta función. No puede promocionar ofertas de PayAfter con ningún otro contenido, marketing o materiales.
-
-
Para Title, escribe un título que identifique la opción de pago de Braintree por PayPal durante el proceso de pago y envío.
-
Establece Vault Enabled en
Yes
para habilitar el uso de un almacén seguro para almacenar la cuenta PayPal de los clientes. La cuenta PayPal abovedada se puede utilizar para transacciones futuras, lo que reduce el número de pasos para los clientes. -
Establezca Send Cart Line Items for PayPal en
Yes
para enviar los artículos de línea (artículos de pedido) a PayPal junto con las tarjetas de regalo, el envoltorio para artículos, el envoltorio para artículos, el crédito de tienda, el envío y los impuestos como artículos de línea. -
Para Sort Order, introduce un número para determinar la secuencia en la que aparece la opción de pago de Braintree PayPal cuando aparece junto con otras opciones de pago durante el proceso de pago.
-
Para mostrar el nombre del comerciante de forma distinta a la definida en la configuración de tienda, escriba el nombre en el campo Override Merchant Name tal como desea que aparezca.
-
Establezca Payment Action en una de las siguientes opciones:
Authorize Only
- Aprueba la compra y suspende los fondos. La cantidad no se retira de la cuenta bancaria del cliente hasta que el comerciante capture la venta.Authorize and Capture
: el importe de la compra se autoriza y se retira inmediatamente de la cuenta del cliente.
-
Establezca Payment from Applicable Countries en una de las siguientes opciones para las transacciones de Braintree procesadas por PayPal:
All Allowed Countries
: los clientes de todos los países especificados en la configuración de su tienda pueden usar este método de pago.Specific Countries
- Después de elegir esta opción, aparece la lista Payment from Specific Countries. Mantenga pulsada la tecla Ctrl (PC) o la tecla Comando (Mac) y seleccione cada país de la lista donde los clientes pueden realizar compras en su tienda.
-
Para requerir que los clientes proporcionen una dirección de facturación, establezca Require Customer’s Billing Address en
Yes
.note note NOTE Asistencia técnica de PayPal debe activar esta función en tu cuenta. -
Para guardar un archivo de registro de las interacciones entre su tienda y PayPal a través de Braintree, establezca Debug en
Yes
. -
Para mostrar el botón PayPal en la página del minicarrito y del carro de compras, establezca Display on Shopping Cart en
Yes
.
Paso 12: Establecer la configuración de estilo
-
Para Location, elija dónde se representan los botones y los mensajes de PayPal:
Mini-Cart and Cart Page
,Checkout Page
oProduct Page
{width="600" modal="regular"}
Mini-Cart and Cart Page
Las opciones y la configuración de esta sección varían según la configuración del campo Location.
- Establezca PayPal Button Type en uno de los tres tipos de botones:
PayPal Button
/PayPal Pay Later Button
/PayPal Credit Button
PayPal Button
Las opciones y la configuración de esta sección varían según el tipo de botón seleccionado en el campo PayPal Button Type.
-
Para mostrar el botón PayPal en la tienda de la ubicación seleccionada, establece Show PayPal Button en
Yes
. -
Para Button Label, selecciona la etiqueta de botón PayPal:
Paypal
,Checkout
,Buynow
oPay
-
Para Color, selecciona el color del botón de PayPal:
Blue
,Black
,Gold
oSilver
-
Para Shape, seleccione la forma de botón PayPal:
Pill
oRectangle
-
Para Size (Deprecated), selecciona el tamaño del botón PayPal:
Medium
,Large
oResponsive
PayLater Messaging
-
Para mostrar mensajes de PayLater en la tienda en la ubicación seleccionada, establezca Show PayLater Messaging en
Yes
.Este mensaje incluye la visualización de mensajes de PayLater para ofertas disponibles (se aplican restricciones).
-
Para Message Layout, seleccione el diseño de mensaje PayLater:
Text
oFlex
-
Para Logo, seleccione el tipo de logotipo de PayPal:
Inline
,Primary
,Alternative
oNone
-
Para Logo Position, selecciona la posición del logotipo de PayPal:
Left
,Right
oTop
-
Para Text Color, seleccione el color de texto del mensaje PayLater:
Black
,White
,Monochrome
oGrayscale
Cuando estas opciones están definidas, puedes ver la vista previa de los botones de PayPal y los mensajes de PayAfter. Hay controles que puede utilizar para aplicar la configuración o restablecer los valores:
-
Para almacenar la configuración de estilo seleccionada para los botones y la mensajería PayAfter y aplicarla a la ubicación actual y al tipo de botón actual, haga clic en Apply.
-
para almacenar la configuración de estilo seleccionada para los valores de botones y mensajes de PayAfter y aplicarla a todos los tipos y ubicaciones de botones, haga clic en Apply to All Buttons.
-
Para devolver la configuración de estilo a los valores predeterminados recomendados para los botones y la mensajería PayAfter y aplicarlos a todos los tipos y ubicaciones de botones, haga clic en Reset to Recommended Defaults.
Paso 13: Completar los ajustes de verificación 3D
-
Si desea agregar un paso de verificación para los clientes que usan tarjetas de crédito inscritos en un programa de verificación (como Verificado por VISA), establezca 3D Secure Verification en
Yes
.Durante el proceso, el importe de la transacción que se envía para su verificación se comprueba con el importe que se envía para su autorización.
-
Para impugnar siempre la solicitud 3D Secure para todas las transacciones, establezca Always request 3DS en
Yes
. -
Para Threshold Amount, introduzca la cantidad mínima de pedido necesaria para almacenar en déclencheur la verificación 3D.
-
Establezca Verify for Applicable Countries en una de las siguientes opciones:
All Allowed Countries
: los clientes de todos los países especificados en la configuración de su tienda pueden usar este método de pago.Specific Countries
- Después de elegir esta opción, aparece la lista Verify for Specific Countries. Mantenga pulsada la tecla Ctrl (PC) o la tecla Comando (Mac) y seleccione cada país de la lista donde los clientes pueden realizar compras en su tienda.
{width="600" modal="regular"}
Paso 14: Configurar los descriptores dinámicos del Braintree
Los siguientes descriptores se utilizan para identificar compras en extractos de tarjetas de crédito de clientes. Puede reducir el número de recargos identificando claramente la empresa asociada con cada compra. Si los descriptores dinámicos no están habilitados para su cuenta, póngase en contacto con el soporte técnico del Braintree.
-
Escriba el descriptor dinámico para Name, Phone y URL según estas directrices:
-
Name: el descriptor de nombre consta de dos partes, separadas por un asterisco (*). Por ejemplo:
company*myproduct
La primera parte del descriptor identifica la compañía o DBA y la segunda parte identifica el producto. La longitud de las partes
company
yproduct
del descriptor se puede asignar de las siguientes maneras, para una longitud combinada de hasta 22 caracteres.Caracteres en el descriptor de nombre
Opción 1:
Company
debe tener tres caracteres,Product
puede tener hasta 18 caracteresOpción 2:
Company
debe tener siete caracteres,Product
puede tener hasta 14 caracteresOpción 3:
Company
debe tener 12 caracteres,Product
puede tener hasta nueve caracteres -
Phone: el descriptor de teléfono debe tener entre 10 y 14 caracteres de longitud y solo puede incluir números, guiones, paréntesis y puntos. Por ejemplo:
9999999999
(999) 999-9999
999.999.9999
-
URL: el descriptor de URL representa su nombre de dominio y puede contener hasta 13 caracteres. Por ejemplo:
company.com
-
-
Una vez completada la configuración del Braintree, haga clic en Save Config.
Notas de la actualización de 2.4
A partir de Adobe Commerce y Magento Open Source 2.4.0, la extensión de Braintree se incluye en la versión. Si está migrando a Commerce 2.4.x desde una versión anterior a la 2.4.0 que tenga instalada la extensión de Braintree de Marketplace, debe desinstalar esa extensión (paypal/module-braintree
o gene/module-braintree
) y actualizar las personalizaciones de código para utilizar el espacio de nombres PayPal_Braintree
en lugar de Magento_Braintree
. Los ajustes de configuración de la extensión principal del paquete Commerce Braintree Payments y la extensión distribuida en el Commerce Marketplace persisten y los pagos realizados con esas versiones anteriores se pueden capturar, anular o reembolsar como de costumbre.