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.

NOTE
Si está actualizando a la versión 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 las notas de actualización de la versión 2.4 al final de esta página.

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

  1. En la barra lateral Admin, 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, 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.

  3. En Recommended Solutions, en la sección_Braintree Payments (por GENE Commerce v4.6.1 - Notas de la versión_, haga clic en Configure.

    Configurar Braintree {width="600" modal="regular"}

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

  5. Establecer Environment operativo actual para transacciones de Braintree en Sandbox o Production

    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.

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

  6. 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.|
  7. Escriba 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 los entornos (espacio aislado 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. Establezca Enable Card Payments en 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, establezca Enable Vault for Card Payments en Yes.

Paso 3: Completar la configuración avanzada

  1. Expanda Selector de expansión en la sección Advanced Braintree Settings.

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

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

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

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

  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 en Yes.

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

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

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

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

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

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

Configuración de Webhooks de Braintree

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

  2. 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.
  3. 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.

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

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

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

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

ACH mediante Braintree

  1. Para incluir ACH como opción de pago con el Braintree, establezca Enable ACH Direct Debit en 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 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.

  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 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 en Yes.

    Asegúrate de comprobar primero tu nombre de dominio en tu cuenta de Braintree.

  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 en Yes.

  3. 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.
  4. Para Merchant Name, escriba un texto que especifique la etiqueta que se mostrará a los clientes en el cuadro de diálogo Apple Pay.

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

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

  2. 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).

  3. 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).

  4. 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).

  5. 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)

    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 de desarrollador de Braintree. Se están desarrollando otros métodos de pago locales que se admitirán en futuras versiones.
  6. 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

Google Pay mediante Braintree

  1. Para incluir Google Pay como opción de pago con el Braintree, establezca Enable GooglePay Through Braintree en 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 en Yes.

  3. 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.
  4. Establezca Button Color para determinar el color del botón Google Pay: White o Black

  5. Para Merchant ID, ingrese su MerchantID (proporcionado por Google).

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

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

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

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

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

  3. 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.
  4. 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

PayPal mediante la configuración del Braintree

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

  2. 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 ni UK.
    • 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.

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

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

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

  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 distinta a la definida en la configuración de tienda, escriba el nombre en el campo Override Merchant Name tal como desea que aparezca.

  8. 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.
  9. 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.
  10. 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.
  11. Para guardar un archivo de registro de las interacciones entre su tienda y PayPal a través de Braintree, establezca Debug en Yes.

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

  1. Para Location, elija dónde se representan 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 del campo Location.

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

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

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

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

  4. Para Shape, seleccione la forma de botón PayPal: Pill o Rectangle

  5. Para Size (Deprecated), selecciona el tamaño del botón PayPal: Medium, Large o 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

  1. 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).

  2. Para Message Layout, seleccione el diseño de mensaje PayLater: Text o Flex

  3. Para Logo, seleccione 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 el color de texto del mensaje PayLater: 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 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

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

  2. Para impugnar siempre la solicitud 3D Secure para todas las transacciones, establezca Always request 3DS en Yes.

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

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

    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. 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 y product 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 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 contener 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 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.

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