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 Braintree Payments está desarrollada por GENE Commerce.

NOTE
Si actualiza a 2.4.x desde una versión anterior de Adobe Commerce o Magento Open Source con la extensión de Braintree de Commerce Marketplace instalada, consulte la Notas de la actualización de 2.4 al final de esta página.

Paso 1: Conseguir las credenciales de Braintree

Ir a Pagos de Braintree y regístrese para obtener una cuenta.

Paso 2: completar la configuración básica

  1. En el Administrador barra lateral, vaya a Stores > Settings>Configuration.

  2. En el panel izquierdo, expanda Sales y elija Payment Methods.

    • Si la instalación de Commerce tiene varios sitios web, tiendas o vistas, en la esquina superior izquierda, elija el Store View donde se aplica la configuración.

    • En el Merchant Location, compruebe que Merchant Country ​se establece en la ubicación de su empresa.

  3. En Recommended Solutions, en el_Braintree Payments (por GENE Commerce Versión 4.6.1: Notas de versión_, haga clic en Configure.

    Configuración del Braintree {width="600" modal="regular"}

  4. Para Title, introduzca un título que identifique al Braintree como una opción de pago durante el cierre de compra.

  5. Establecer el funcionamiento actual Environment para transacciones de Braintree a Sandbox o Production

    Al probar la configuración en una zona protegida, utilice solo números de tarjeta de crédito que son recomendados por el Braintree. Cuando esté listo para ir a producción con Braintree, establezca Environment hasta Production.

    Configuración de credenciales básicas {width="600" modal="regular"}

  6. Establecer Payment Action a uno de los siguientes:

    • Authorize Only - Aprueba la compra y suspende los fondos. El importe no se retira de la cuenta bancaria del cliente hasta que se realiza la venta capturado por el comerciante.|
    • 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.|
  7. Introduzca el Sandbox Merchant ID / Merchant ID desde su cuenta de Braintree.

  8. 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 ambos (Zona protegida y producción) y los demás campos se representan en función del entorno seleccionado.
  9. Antes de guardar la configuración, haga clic en Validate Credentials para validar las credenciales.

  10. Establecer Enable Card Payments hasta Yes.

    Configuración básica {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, configure Enable Vault for Card Payments hasta Yes.

Paso 3: Completar la configuración avanzada

  1. Expandir Selector de expansión el Advanced Braintree Settings sección.

    Configuración avanzada {width="550" modal="regular"}

  2. Para Vault Title, introduzca un título descriptivo para la referencia que identifique el almacén donde se almacena la información de la tarjeta del cliente.

  3. Introduzca el 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.

  4. Para ofrecer una experiencia de pago y envío más rápida con las opciones de Pago exprés al principio del proceso de pago, incluidas PayPal, PayAfter, Apple Pay y Google Pay, establezca Enable Checkout Express Payments hasta Yes.

  5. 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 hasta Yes.

  6. Configure las variables Bypass Fraud Protection Threshold para que el Advanced Fraud Protection las comprobaciones se omiten cuando se alcanza o supera el umbral.

    Si deja este campo en blanco, se deshabilita esta opción.

  7. Si desea que el sistema guarde un archivo de registro de interacciones entre el almacén y el Braintree, establezca Debug hasta Yes.

  8. Para exigir a los clientes que proporcionen el código de seguridad de tres dígitos desde el reverso de una tarjeta de crédito, establezca CVV Verification hasta Yes.

    Si utiliza la verificación CVV, asegúrese de habilitar AVS y/o CVV en el Configuración/Procesamiento de su cuenta de Braintree.

  9. Para enviar los artículos de línea de carro de compras para todas las formas de pago, establezca Send Card Line Items hasta Yes.

  10. Para Credit Card Types, selecciona cada tarjeta de crédito que sea aceptada por tu tienda como pago a través del 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.

  11. Para Sort Order, introduzca 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

Configuración de Webhooks de Braintree

  1. Establecer Enable Webhook hasta Yes para habilitar la funcionalidad de webhook para la protección contra fraudes, pagos ACH y métodos de pago locales.

  2. Copie la dirección URL en la Fraud Protection URL y agréguelo a su cuenta de Braintree como Webhook Destination URL.

    note important
    IMPORTANT
    Esta URL debe ser segura y accesible públicamente.
  3. Configure las variables 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 comercial.

  4. Configure las variables 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 comercial.

Paso 5: Completar la configuración específica de un país

  1. Establecer Payment from Applicable Countries a uno de los siguientes:

    • All Allowed Countries - Clientes de todos países especificado en la configuración de tu tienda puede utilizar este método de pago.
    • Specific Countries : Después de elegir esta opción, el Payment from Specific Countries ​aparece una lista. 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.

    Configuración específica del país {width="600" modal="regular"}

  2. Para configurar Country Specific Credit Card Types:

    • Clic Add.

    • Configure las variables 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

BRAINTREE pasante de ACH

  1. Para incluir ACH como opción de pago con el Braintree, establezca Enable ACH Direct Debit hasta Yes.

  2. 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 volver a utilizar la domiciliación bancaria de ACH sin necesidad de volver a introducir o autenticar su información de pago si está establecida Enable Vault for ACH Direct Debit hasta Yes.

  3. 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 el Apple Pay mediante la configuración del Braintree

ApplePay mediante la configuración del Braintree

  1. Para incluir Apple Pay como opción de pago con el Braintree, establezca Enable ApplePay through Braintree hasta Yes.

    Asegúrese de lo siguiente compruebe su nombre de dominio en su cuenta de Braintree primero.

  2. 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 hasta Yes.

  3. Establecer Payment Action a uno de los siguientes:

    • Authorize Only - Aprueba la compra y suspende los fondos. El importe no se retira de la cuenta bancaria del cliente hasta que se realiza la venta capturado por el comerciante.
    • Intent Sale - El importe de la compra se autoriza y se retira inmediatamente de la cuenta del cliente.
  4. Para Merchant Name, introduzca un texto que especifique la etiqueta que se mostrará a los clientes en el cuadro de diálogo Apple Pay.

  5. Para Sort Order, introduzca un número para determinar la secuencia en la que Apple Pay la opción de pago aparece 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

  1. Para incluir métodos de pago locales como opción de pago con el Braintree, establezca Enable Local Payment Methods hasta Yes.

  2. Para Title, introduzca el texto que desea utilizar para la etiqueta que aparece en la sección método de pago mediante pago y envío (valor predeterminado: Local Payments).

  3. Para Fallback Button Text, introduzca el texto que desea utilizar 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).

  4. Para Redirect on Fail, introduzca la dirección URL a la que se debe redirigir a los clientes cuando se cancelen las transacciones de métodos de pago locales, se produzcan errores o se produzcan errores. Debe ser la página de pago y envío (por ejemplo, https://www.domain.com/checkout#payment).

  5. Para Allowed Payment Methods, 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 compatible)

    Configuración de métodos de pago locales {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 para desarrolladores de Braintree. Se están desarrollando otros métodos de pago locales que se admitirán en futuras versiones.
  6. Para Sort Order, introduzca 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 la Google Pay mediante la configuración del Braintree

Braintree de Google Pay through

  1. Para incluir Google Pay como opción de pago con el Braintree, establezca Enable GooglePay Through Braintree hasta Yes.

  2. 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 hasta Yes.

  3. Establecer Payment Action a uno de los siguientes:

    • Authorize Only - Aprueba la compra y suspende los fondos. El importe no se retira de la cuenta bancaria del cliente hasta que se realiza la venta capturado por el comerciante.
    • Intent Sale - El importe de la compra se autoriza y se retira inmediatamente de la cuenta del cliente.
  4. Establecer Button Color para determinar el color de la Google Pay botón: White o Black

  5. Para Merchant ID, introduzca su ID de comerciante (proporcionado por Google).

  6. Para Accepted Cards, seleccione el tipo de tarjetas que un cliente puede utilizar para realizar un pedido Google Pay.

    Opciones: Visa / MasterCard / AMEX / Discover / JCB

  7. Para Sort Order, introduzca un número para determinar la secuencia en la que Google Pay aparece cuando aparece junto con otras opciones de pago durante el cierre de compra.

Paso 10: Completar el Venmo mediante la configuración del Braintree

  1. Para incluir Venmo como opción de pago con Braintree, establezca Enable Venmo through Braintree hasta Yes.

  2. Establecer Enable Vault for Venmo hasta 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.

    Venmo a través del Braintree {width="600" modal="regular"}

  3. Establecer Payment Action a uno de los siguientes:

    • Authorize Only - Aprueba la compra y suspende los fondos. El importe no se retira de la cuenta bancaria del cliente hasta que se realiza la venta capturado por el comerciante.
    • Intent Sale - El importe de la compra se autoriza y se retira inmediatamente de la cuenta del cliente.
  4. Para Sort Order, introduzca un número para determinar la secuencia en la que aparece Venmo cuando se enumera con otras opciones de pago durante el cierre de compra.

Paso 11: Completa la configuración de PayPal mediante el Braintree

PayPal a través de Configuración de Braintree

  1. Para incluir PayPal como opción de pago con el Braintree, establece Enable PayPal through Braintree hasta Yes.

  2. Especifica tu forma de pago mediante PayPal para el Braintree:

    note note
    NOTE
    Cualquiera PayPal Credit o PayPal PayLater se puede activar. 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 hasta Yes.

      Cuándo Activar PayPal mediante 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á desactivado si el valor seleccionado para Merchant Country ​el campo no es US o UK.
    • Para incluir PayPal PayLater como opción de pago con el Braintree, establezca Enable PayPal PayLater through Braintree hasta Yes.

      Cuándo 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 las siguientes 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.

  3. Para Title, introduce un título que identifique la opción Pago por PayPal del Braintree durante el proceso de pago.

  4. Establecer Vault Enabled hasta Yes para habilitar el uso de una caja fuerte segura 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.

  5. Establecer Send Cart Line Items for PayPal hasta Yes para enviar los artículos de línea (artículos de pedido) a PayPal junto con tarjetas de regalo, envoltorio para artículos, envoltorio para pedidos, crédito de tienda, envío e impuestos como artículos de línea.

  6. 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.

  7. Para mostrar el nombre del comerciante de forma diferente a como se define en su configuración de tienda, introduzca el nombre en la Override Merchant Name como desea que aparezca.

  8. Establecer Payment Action a uno de los siguientes:

    • Authorize Only - Aprueba la compra y suspende los fondos. El importe no se retira de la cuenta bancaria del cliente hasta que se realiza la venta capturado por el comerciante.
    • Authorize and Capture - El importe de la compra se autoriza y se retira inmediatamente de la cuenta del cliente.
  9. Establecer Payment from Applicable Countries a una de las siguientes transacciones de Braintree procesadas por PayPal:

    • All Allowed Countries - Clientes de todos países especificado en la configuración de tu tienda puede utilizar este método de pago.
    • Specific Countries : Después de elegir esta opción, el Payment from Specific Countries ​aparece una lista. 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.
  10. Para exigir a los clientes que proporcionen una dirección de facturación, establezca Require Customer’s Billing Address hasta Yes.

    note note
    NOTE
    Asistencia técnica de PayPal debe activar esta función en tu cuenta.
  11. Para guardar un archivo de registro de las interacciones entre tu tienda y PayPal a través de Braintree, establece Debug hasta Yes.

  12. Para mostrar el botón PayPal en la página del minicarrito y del carro de compras, configure Display on Shopping Cart hasta Yes.

Paso 12: Establecer la configuración de estilo

  1. Para Location, elige dónde se muestran los botones y los mensajes de PayPal: Mini-Cart and Cart Page, Checkout Page, o Product Page

    Configuración de estilo de PayPal {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 de la Location ​field.

  1. Establecer PayPal Button Type a 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 la PayPal Button Type ​field.

  1. Para mostrar el botón PayPal en la tienda de la ubicación seleccionada, selecciona Show PayPal Button hasta Yes.

  2. Para Button Label, selecciona la etiqueta del botón PayPal: Paypal, Checkout, Buynow, o Pay

  3. Para Color, selecciona el color del botón PayPal: Blue, Black, Gold, o Silver

  4. Para Shape, selecciona la forma del botón PayPal: Pill o Rectangle

  5. Para Size (Deprecated), selecciona el tamaño del botón PayPal: Medium, Large, o Responsive

NOTE
El Size(Deprecated) El campo de configuración está obsoleto y no se utiliza para aplicar estilo a los botones de PayPal.

PayLater Messaging

  1. Para mostrar PayLater mensajes en la tienda en la ubicación seleccionada, establecer Show PayLater Messaging hasta Yes.

    Este mensaje incluye la visualización de PayLater mensajería para ofertas disponibles (se aplican restricciones).

  2. Para Message Layout, seleccione la PayLater diseño del mensaje: Text o Flex

  3. Para Logo, selecciona el tipo de logotipo de PayPal: Inline, Primary, Alternative, o None

  4. Para Logo Position, selecciona la posición del logotipo de PayPal: Left, Right, o Top

  5. Para Text Color, seleccione la PayLater color del texto del mensaje: Black, White, Monochrome, o 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:

  • Para almacenar la configuración de estilo seleccionada para los botones y la mensajería PayAfter y aplicarla a la ubicación y el tipo de botón actuales, 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

  1. Si desea agregar un paso de verificación para los clientes que utilizan tarjetas de crédito inscritas en un programa de verificación (como Verificado por VISA), establecido 3D Secure Verification hasta 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.

  2. Para desafiar siempre la petición 3D Secure para todas las transacciones, establezca Always request 3DS hasta Yes.

  3. Para Threshold Amount, introduzca la cantidad mínima de pedido necesaria para almacenar en déclencheur la verificación 3D.

  4. Establecer Verify for Applicable Countries a uno de los siguientes:

    • All Allowed Countries - Clientes de todos países especificado en la configuración de tu tienda puede utilizar este método de pago.
    • Specific Countries : Después de elegir esta opción, el Verify for Specific Countries ​aparece una lista. 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.

    Configuración de verificación 3D {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.

Descriptores dinámicos

  1. Introduzca el descriptor dinámico para la variable 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 duración de la company y product las partes del descriptor se pueden 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 caracteres

      Opción 2: Company debe tener siete caracteres, Product puede tener hasta 14 caracteres

      Opció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 tener hasta 13 caracteres. Por ejemplo:

      company.com

  2. 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 migra 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 actualice cualquier personalización de código para utilizar el PayPal_Braintree namespace 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.

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