Sales > Payment Methods > Braintree

IMPORTANT
Migración a Commerce 2.4:

Para las versiones de Adobe Commerce y Magento Open Source anteriores a la 2.4.0, se recomendó que los comerciantes instalaran y configuraran la extensión oficial de integración de pagos de Braintree desde el Commerce Marketplace para reemplazar la integración principal. A partir de la versión 2.4.0, la extensión de se incluye ahora en la versión principal.



Al migrar a Commerce 2.4, los comerciantes deben desinstalar la extensión distribuida en Marketplace (paypal/module-braintree o gene/module-braintree) y actualizar las personalizaciones de código para utilizar el área de nombres PayPal_Braintree en lugar de Magento_Braintree. Los ajustes de configuración de la extensión agrupada para Commerce y la extensión distribuida en el Commerce Marketplace se mantienen. Los pagos realizados con esas versiones de la extensión se capturan, anulan o devuelven con normalidad.



Si actualiza a Commerce 2.4.0 y no utiliza la extensión de Commerce Marketplace recomendada en la versión 2.3.x anterior, la función de varias direcciones no funciona con la versión 2.4.0 de Braintree. Cuando un comprador selecciona enviar a varias direcciones , el método de pago del Braintree no aparece. La extensión de Commerce Marketplace recomendada anteriormente para 2.3.x tiene este problema de varias direcciones.

Para acceder a las opciones de configuración de la tienda, elige Stores > Settings>Configuration ​en la barra lateral de_ Admin _.

Basic Braintree Settings

Configuración básica del Braintree

Campo
Ámbito
Descripción
Title
Vista de tienda
Valor predeterminado: Credit Card (Braintree)
Environment
Vista de tienda
Opciones: Sandbox / Production
Payment Action
Vista de tienda
Determina la acción realizada por el Braintree cuando se procesa un pago. Opciones:
Authorize- Los fondos de la tarjeta de crédito del cliente están autorizados, pero no se transfieren desde la cuenta. Se crea un pedido en el administrador de la tienda. Más tarde puede capturar la venta y crear una factura.
Intent Sale (anteriormente Authorize and Capture en versiones anteriores): el Braintree autoriza y captura los fondos de la tarjeta de crédito del cliente, y se crean un pedido y una factura en el administrador de la tienda.
Sandbox Merchant ID
Vista de tienda
Este es el identificador único de toda la cuenta de puerta de enlace de la zona protegida. También conocido como ID público o ID de producción, su ID de comerciante es diferente para sus puertas de enlace de producción y de zona protegida. Este campo aparece cuando el campo Environment ​está establecido en Sandbox.
Sandbox Public Key
Vista de tienda
Identificador público específico del usuario que restringe el acceso a los datos cifrados. Cada usuario asociado con la puerta de enlace del Braintree de la zona protegida tiene su propia clave pública de la zona protegida. Este campo aparece cuando el campo Environment ​está establecido en Sandbox.
Sandbox Private Key
Vista de tienda
Identificador privado específico del usuario que restringe el acceso a los datos cifrados. Cada usuario asociado con la puerta de enlace del Braintree de la zona protegida tiene su propia clave privada para la zona protegida. Este campo aparece cuando el campo Environment ​está establecido en Sandbox.
Merchant ID
Vista de tienda
Este es el identificador único de toda la cuenta de puerta de enlace, incluidas las cuentas de varios comerciantes que pueden estar en la puerta de enlace. También conocido como ID público o ID de producción, su ID de comerciante es diferente para sus puertas de enlace de producción y de zona protegida. Este campo aparece cuando el campo Environment ​está establecido en Production.
Public Key
Vista de tienda
Identificador público específico del usuario que restringe el acceso a los datos cifrados. Cada usuario asociado con la puerta de enlace de Braintree tiene su propia clave pública. Este campo aparece cuando el campo Environment ​está establecido en Production.
Private Key
Vista de tienda
Identificador privado específico del usuario que restringe el acceso a los datos cifrados. Cada usuario asociado con la puerta de enlace de Braintree tiene su propia clave privada. Este campo aparece cuando el campo Environment ​está establecido en Production.
Enable Card Payments
Sitio web
Determina si el método de pago con tarjeta de crédito del Braintree está disponible para los clientes como método de pago. Opciones: Yes / No
Enable Vault for Card Payments
Sitio web
Cuando está activada, proporciona almacenamiento seguro para la información de pago del cliente, de modo que los clientes no tienen que volver a introducir la información de su tarjeta de crédito para cada compra. Opciones: Yes / No
Enable Vault CVV Reverification
Sitio web
Cuando está activada, la validación se realiza para la configuración de reglas CVV en su Cuenta de Braintree. Opciones: Yes / No

Advanced Braintree Settings

Configuración avanzada del Braintree

Campo
Ámbito
Descripción
Vault Title
Sitio web
Título descriptivo de referencia que identifica el almacén donde se almacena la información de la tarjeta del cliente.
Merchant Account ID
Sitio web
El ID de la cuenta de comerciante que se asociará con las transacciones de Braintree desde este sitio web. Si se deja en blanco, se utiliza la cuenta de comerciante predeterminada de la cuenta de Braintree.
Enable Checkout Express Payments
Sitio web
Proporciona una experiencia de pago más rápida con las opciones de Pago exprés al principio del proceso de pago, que incluyen PayPal, PayAfter, Apple Pay y Google Pay. Opciones: Yes / No
Skip Fraud Checks on Admin Orders
Sitio web
Evita que la transacción se envíe para su evaluación como parte de Advanced Fraud Tools comprobaciones, en pedidos realizados a través del administrador solo cuando se establece en Yes.
Opciones: Yes / No
Bypass Fraud Protection Threshold
Sitio web
Se omiten Advanced Fraud Protection comprobaciones cuando se alcanza o supera el valor de umbral. Si deja este campo en blanco, se deshabilita esta opción.
Debug
Sitio web
Determina si las comunicaciones entre el sistema Braintree y el almacén se graban en un archivo de registro. Opciones: Yes / No
CVV Verification
Sitio web
Determina si los clientes deben proporcionar el código de seguridad de tres dígitos desde el reverso de una tarjeta de crédito. Opciones: Yes / No
Send Card Line Items
Sitio web
Envíe los elementos de línea de carro de compras para todas las formas de pago. Opciones: Yes / No
Credit Card Types
Sitio web
Especifica cada tarjeta de crédito que acepta como pago a través del Braintree. Mantenga presionado Ctrl (o Command en Mac) para seleccionar una combinación de tarjetas. Opciones: American Express / Visa / MasterCard / Discover / JCB / Diners / Maestro International
Sort Order
Sitio web
Determina el pedido en el que el Braintree aparece con otras formas de pago durante el cierre de compra.

Braintree Webhooks Settings

Configuración de Webhooks de Braintree

Campo
Ámbito
Descripción
Enable Webhook
Sitio web
Para habilitar la funcionalidad de webhook para la protección contra fraudes, pagos ACH, métodos de pago locales y disputas. Opciones: Yes / No
Fraud Protection URL
Sitio web
Agregue esta URL a su cuenta de Braintree como Webhook Destination URL. Esta dirección URL debe ser segura y de acceso público.
Fraud Protection Approve Order Status
Sitio web
Cuando el Braintree aprueba la protección contra el fraude, el estado del pedido seleccionado se asigna al pedido de Commerce. Este estado se usa para actualizar el estado del pedido donde se usa el método de pago ACH y cuando se mueve a SETTLED en Braintree.
Fraud Protection Reject Order Status
Sitio web
Cuando el Braintree rechaza la protección contra el fraude, el estado del pedido seleccionado se asigna al pedido de Commerce. Este estado se usa para actualizar el estado del pedido donde se usa el método de pago ACH y cuando SETTLEMENT es DECLINED en Braintree.

Country Specific Settings

Configuración específica de país

Campo
Ámbito
Descripción
Payment from Applicable Countries
Sitio web
Determina si acepta pagos procesados por Braintree de todos los países o sólo de países específicos. Opciones: All Allowed Countries / Specific Countries
Payment from Specific Countries
Sitio web
Si procede, indica los países específicos desde los que acepta pagos procesados por el Braintree.
Country Specific Credit Card Types
Sitio web
Identifica las tarjetas de crédito aceptadas por país para los pagos procesados por el Braintree. Se guarda un registro para cada país. Opciones:
Country- Elija el país.
Allowed Card Types - Selecciona cada tarjeta de crédito que se acepte del país como pago mediante Braintree.
Add- Agregar una línea para permitir tarjetas de crédito para un país diferente.
Action - Elimina el registro de tarjetas de crédito permitidas para el país.

ACH through Braintree

ACH mediante Braintree

Campo
Ámbito
Descripción
Enabled ACH Direct Debit
Sitio web
Determina si ACH Direct Debit se incluye como método de pago mediante Braintree. Opciones: Yes / No
Enable Vault for ACH Direct Debit
Sitio web
Los clientes pueden almacenar o depositar su método de pago mediante domiciliación bancaria ACH de un solo uso para uso futuro. Una vez que los datos de pago se han guardado, el cliente puede utilizar el método de pago de domiciliación bancaria ACH sin volver a introducir datos ni volver a autenticar su información de pago. Opciones: Yes / No
Sort Order
Sitio web
Determina el pedido que ACH Direct Debit se enumera con otras formas de pago durante el cierre de compra.

Apple Pay through Braintree

Apple Pay mediante Braintree

Campo
Ámbito
Descripción
Enable ApplePay through Braintree
Sitio web
Determina si Apple Pay se incluye como forma de pago a través del Braintree. Opciones: Yes / No

El dominio debe estar comprobado primero en la cuenta de Braintree.
Enable Vault for ApplePay
Sitio web
Los clientes pueden depositar o almacenar su método de pago de Apple Pay para uso futuro. Una vez que los datos de pago se han guardado, el cliente puede utilizar Apple Pay sin tener que volver a introducir los datos ni volver a autenticar su información de pago. Opciones: Yes / No
Payment Action
Sitio web
Determina la acción realizada por el Braintree cuando se procesa un pago. Opciones:
Authorize- Los fondos de la tarjeta del cliente están autorizados, pero no se transfieren desde la cuenta del cliente. Se crea un pedido en el administrador de la tienda. Más tarde puede capturar la venta y crear una factura.
Intent Sale: el Braintree autoriza y captura los fondos de la tarjeta del cliente, y se crean un pedido y una factura en el administrador de la tienda. Nota: Esto era Authorize and Capture en 2.3.x y versiones anteriores.
Merchant Name
Vista de tienda
Etiqueta que se muestra a los clientes en la ventana emergente ApplePay.
Sort Order
Sitio web
Determina el pedido en el que Apple Pay aparece junto con otras formas de pago durante el proceso de pago.

Local Payment Methods

Métodos de pago locales

Campo
Ámbito
Descripción
Enabled Local Payment Methods
Sitio web
Determina si el método de pago local se incluye como método de pago mediante Braintree. Opciones: Yes / No
Title
Sitio web
Etiqueta que aparece en la sección de método de pago de cierre de compra. Valor predeterminado: Local Payments
Fallback Button Text
Sitio web
Introduzca el texto que se utilizará para el botón que aparece en la página del Braintree de reserva que lleva a los clientes de vuelta al sitio web. Valor predeterminado: Complete Checkout
Redirect on Fail
Sitio web
Especifica la dirección URL a la que se debe redirigir a los clientes cuando se cancelan las transacciones de métodos de pago locales, se producen errores o se producen errores. Debe ser la página de pago y envío (por ejemplo, https://www.domain.com/checkout#payment).
Allowed Payment Method
Sitio web
Seleccione el método de pago local que desea activar. Opciones: Bancontact / EPS / giropay / iDeal / Klarna Pay Now / SOFORT / MyBank / P24 / SEPA/ELV Direct Debit (aún no es compatible)
Sort Order
Sitio web
Determina el pedido en el que se muestra el Método de pago local con otros métodos de pago durante el cierre de compra.
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.

GooglePay through Braintree

GooglePay mediante Braintree

Campo
Ámbito
Descripción
Enabled GooglePay through Braintree
Sitio web
Determina si el pago de Google Pay se incluye como una forma de pago a través del Braintree. Opciones: Yes / No
Enable Vault for GooglePay
Sitio web
Los clientes pueden depositar o almacenar su método de pago de Google Pay para uso futuro. Una vez que los datos de pago se han guardado, el cliente puede utilizar Google Pay sin tener que volver a introducir los datos ni volver a autenticar su información de pago. Opciones: Yes / No
Payment Action
Sitio web
Determina la acción realizada por el Braintree cuando se procesa un pago. Opciones:
Authorize- Los fondos de la tarjeta del cliente están autorizados, pero no se transfieren desde la cuenta del cliente. Se crea un pedido en el administrador de la tienda. Más tarde puede capturar la venta y crear una factura.
Intent Sale: el Braintree autoriza y captura los fondos de la tarjeta del cliente, y se crean un pedido y una factura en el administrador de la tienda. Nota: Esto era Authorize and Capture en 2.3.x y versiones anteriores.
Button Color
Sitio web
Determina el color del botón Google Pay. Opciones: White / Black
Merchant ID
Vista de tienda
El ID proporcionado por Google debe introducirse aquí.
Accepted Cards
Sitio web
Seleccione el tipo de tarjetas que puede usar un cliente para realizar un pedido con Google Pay.
Sort Order
Sitio web
Determina el pedido en el que Google Pay aparece junto con otras formas de pago durante el proceso de pago.

Venmo through Braintree

Venmo a través del Braintree

Campo
Ámbito
Descripción
Enable Venmo through Braintree
Sitio web
Determina si Venmo se incluye como método de pago mediante Braintree. Opciones: Yes / No
Enable Vault for Venmo
Sitio web
Los clientes pueden depositar su método de pago Venmo para uso futuro. Una vez que los detalles de pago se hayan guardado, el cliente podrá usar el método de pago Venmo sin tener que volver a introducir los datos o volver a autenticar su información de pago. Opciones: Yes / No
Payment Action
Sitio web
Determina la acción realizada por el Braintree cuando se procesa un pago. Opciones:
Authorize- Los fondos de la tarjeta del cliente están autorizados, pero no se transfieren desde la cuenta del cliente. Se crea un pedido en el administrador de la tienda. Más tarde puede capturar la venta y crear una factura.
Intent Sale: el Braintree autoriza y captura los fondos de la tarjeta del cliente, y se crean un pedido y una factura en el administrador de la tienda. Nota: Esto fue Autorizar y capturar en 2.3.x y versiones anteriores.
Sort Order
Sitio web
Determina el pedido en el que Venmo aparece junto con otras formas de pago durante el cierre de compra.

PayPal through Braintree

PayPal a través del Braintree

Campo
Ámbito
Descripción
Enable PayPal through Braintree
Sitio web
Determina si PayPal se incluye como forma de pago a través del Braintree. Opciones: Yes / No
Enable PayPal Credit through Braintree
Sitio web
Determina si el crédito de PayPal se incluye como forma de pago a través del Braintree. Opciones: Yes / No. Este campo se hace visible cuando Enable PayPal through Braintree se establece en Yes
Enable PayPal PayLater through Braintree
Sitio web
Determina si PayPal PayAfter se incluye como forma de pago a través del Braintree. Opciones: Yes / No. Este campo se hace visible cuando Enable PayPal through Braintree se establece en Yes
Title
Vista de tienda
La etiqueta que identifica a PayPal a través del Braintree a los clientes durante el cierre de compra. Valor predeterminado: PayPal
Vault Enabled
Sitio web
Cuando está activada, proporciona almacenamiento seguro para la información de pago del cliente, de modo que los clientes no tienen que volver a introducir su información de PayPal para cada compra. Opciones: Yes / No
Send Cart Line Items for PayPal
Sitio web
Envíe 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 regalos para pedidos, el crédito de tienda, el envío y los impuestos como artículos de línea. Opciones: Yes / No
Sort Order
Sitio web
Un número que determina el orden en el que PayPal a través del Braintree aparece junto con otros métodos de pago durante el proceso de pago.
Override Merchant Name
Vista de tienda
Un nombre alternativo que se puede usar para identificar al comerciante en cada vista de tienda.
Payment Action
Sitio web
Determina la acción realizada por PayPal a través del Braintree cuando se procesa un pago. Opciones:
Authorize- Los fondos de la tarjeta del cliente están autorizados, pero no se transfieren desde la cuenta del cliente. Se crea un pedido en el administrador de la tienda. Más tarde puede capturar la venta y crear una factura.
Authorize and Capture: PayPal autoriza y captura los fondos de la tarjeta del cliente a través de Braintree, y se crea un pedido y una factura en el administrador de la tienda.
Payment from Applicable Countries
Sitio web
Determina si acepta pagos procesados por PayPal a través de un Braintree de todos los países o solo de países específicos. Opciones: All Allowed Countries / Specific Countries
Payment from Specific Countries
Sitio web
Si procede, indica los países específicos desde los que acepta pagos procesados por el Braintree.
Require Customer’s Billing Address
Sitio web
Determina si la dirección de facturación del cliente es necesaria para enviar un pedido. Opciones: Yes / No
Debug
Sitio web
Determina si las comunicaciones entre PayPal a través del sistema de Braintree y su tienda están registradas en un archivo de registro. Opciones: Yes / No
Display on Shopping Cart
Sitio web
Determina si el botón PayPal aparece en el minicarrito y en la página del carro de compras. Opciones: Yes / No
NOTE
Se puede habilitar PayPal Credit o PayPal PayLater. Ambos métodos no se pueden habilitar al mismo tiempo.

Styling

Estilo PayPal

Campo
Ámbito
Descripción
Location
Sitio web
Determina dónde se muestran los botones y mensajes de PayPal en la tienda. Opciones: Mini-Cart and Cart Page / Checkout Page / Product Page

Mini-Cart and Cart Page

La opción y la configuración de esta sección varían según la configuración del campo Location.

Campo
Ámbito
Descripción
PayPal Button Type
Sitio web
Establece el botón en uno de los tres tipos: 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.

Campo
Ámbito
Descripción
Show PayPal Button
Sitio web
Determina la ubicación del botón PayPal en la ubicación seleccionada. Opciones: Yes / No
Button Label
Sitio web
Determina la etiqueta del botón PayPal. Opciones: Paypal / Checkout / Buy Now / Pay
Color
Sitio web
Determina el color del botón PayPal. Opciones: Blue / Black / Gold / Silver
Shape
Sitio web
Determina la forma del botón PayPal. Opciones: Pill / Rectangle
Size(Deprecated)
Sitio web
Determina el tamaño del botón PayPal. Opciones: Medium / Large / Responsive
NOTE
El campo de configuración Size(Deprecated) está obsoleto y no se usa para aplicar estilo a los botones de PayPal.

PayLater Messaging

Campo
Ámbito
Descripción
Show PayLater Messaging
Sitio web
Activa la mensajería PayAfter en la ubicación seleccionada. Opciones: Yes / No. Cuando está habilitado, muestra mensajes de PayAfter para las ofertas disponibles (se aplican restricciones).
Message Layout
Sitio web
Determina el diseño del mensaje Paylater. Opciones: Text / Flex
Logo
Sitio web
Determina el tipo de logotipo utilizado para el botón PayPal. Opciones: Inline / Primary / Alternative / None
Logo Position
Sitio web
Determina la posición del logotipo del botón PayPal. Opciones: Left / Right / Top
Text Color
Sitio web
Determina el color de texto del botón PayPal. Opciones: Black / White / Monochrome / Grayscale

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:

Campo
Ámbito
Descripción
Apply
Sitio web
Almacena la configuración de estilo seleccionada para los botones y la mensajería PayAfter y los aplica a la ubicación y el tipo de botón actuales.
Apply to All Buttons
Sitio web
Almacena la configuración de estilo seleccionada para los valores de botones y mensajes de PayAfter y los aplica a todos los tipos y ubicaciones de botones.
Reset to Recommended Defaults
Sitio web
Devuelve la configuración de estilo a los valores predeterminados recomendados para los botones y la mensajería PayAfter y los aplica a todos los tipos y ubicaciones de botones.

Configuración de verificación de seguridad 3d

Configuración de verificación segura en 3D

Campo
Ámbito
Descripción
3D Secure Verification
Sitio web
Determina si una transacción debe pasar un proceso de verificación adicional cuando el cliente está inscrito en un programa como Verificado por VISA. Opciones: Yes / No
Always request 3DS
Sitio web
Desafíe la petición 3D Secure siempre para todas las transacciones. Opciones: Yes / No
Threshold Amount
Sitio web
Determina la cantidad de pedido máxima autorizada para procesar en un único pedido. El Braintree rechaza la autorización si el importe del pedido supera este umbral.
Verify for Applicable Countries
Sitio web
Determina los países en los que se debe comprobar el pago. Opciones: All Allowed Countries / Specific Countries
Verify for Specific Countries
Sitio web
Si procede, indica los países específicos desde los que debe verificarse el pago por parte del Braintree.

Dynamic Descriptors

Descriptores dinámicos

Campo
Ámbito
Descripción
Name
Vista de tienda
El descriptor Nombre consta de dos partes, separadas por un asterisco (*). La primera parte del descriptor identifica la compañía o DBA y la segunda parte identifica el producto. Por ejemplo: company*myproduct

La longitud de las partes Empresa y Producto del descriptor se puede asignar de las siguientes maneras, para una longitud combinada de hasta 22 caracteres:
Option 1- La compañía debe tener tres caracteres / El producto puede tener hasta 18 caracteres
Option 2 - La compañía debe tener siete caracteres / El producto puede tener hasta 14 caracteres
Option 3- La compañía debe tener 12 caracteres / El producto puede tener hasta nueve caracteres
Phone
Vista de tienda
El descriptor de teléfono debe tener entre diez 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
Vista de tienda
El descriptor de URL representa su nombre de dominio y puede contener hasta 13 caracteres. Por ejemplo: company.com
recommendation-more-help
d39aca6f-58a0-41c6-83eb-39fd0ef30672