Braintree
Braintree ofrece un experiencia de pago totalmente personalizable con detección de fraude e integración PayPal. Es compatible con Apple Pay, Google Pay, ACH, Venmo y métodos de pago locales. Braintree reduce la carga de cumplimiento PCI para los comerciantes porque la transacción se realiza en el sistema Braintree. La integración de Braintree Payments es desarrollada por GENE Commerce.
Paso 1: Consiga sus credenciales de Braintree
Vaya a Braintree Payments y regístrese para obtener una cuenta.
Paso 2: completar la configuración básica
-
En la barra lateral Administración , ve 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.7.0 - Notas de la versión_, haga clic en Configure.
-
Para Title, escribe un título que identifique a Braintree como una opción de pago durante el cierre de compra.
-
Establecer Environment operativo actual para las 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 Braintree. Cuando esté listo para ir a producción con Braintree, establezca Environment en
Production
. -
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
. -
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
. -
Si desea que un cliente verifique el número CVV de su tarjeta abovedada en cada compra, establezca Enable Vault CVV Re-verification en
Yes
.
Paso 3: Completar la configuración avanzada
-
Expanda
-
For Vault Title, enter a descriptive title for your reference that identifies the vault where your customer card information is stored.
-
Enter the Merchant Account ID from your Braintree account.
If you don't specify the merchant account to be used, Braintree processes the transaction using your default merchant account.
-
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 su tienda y 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 a través de 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, introduce un número para determinar la secuencia en la que Braintree aparece cuando aparece junto 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 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 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. Mantén pulsada la tecla Ctrl (PC) o la tecla Comando (Mac) y selecciona cada país de la lista donde los clientes pueden realizar compras desde tu tienda.
-
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 de Braintree
-
Para incluir ACH como opción de pago con Braintree, establezca Enable ACH Direct Debit en
Yes
. -
Los clientes pueden almacenar su método de pago de débito directo ACH de un solo uso y tienda para su uso futuro. Una vez almacenado, los clientes pueden reutilizar el débito directo ACH sin necesidad de volver a ingresar o autenticar su información de pago si está configurado Enable Vault for ACH Direct Debit en
Yes
. -
Para Sort Order, ingrese un número para determinar la Secuencia en la que aparece la opción de pago Braintree ACH cuando aparece junto con otras opciones de pago durante el proceso de pago.
Paso 7: completar Apple Pay mediante la configuración de Braintree
-
Para incluir Apple Pay como opción de pago con 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 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 de reserva de Braintree 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)note note NOTE La extensión agrupada de Braintree 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. -
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 de Braintree
-
Para incluir Google Pay como opción de pago con 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 Venmo a través de la configuración de Braintree
-
Para incluir Venmo como opción de pago con 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. -
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 Braintree
-
Para incluir PayPal como una opción de pago con Braintree, establece Enable PayPal through Braintree en
Yes
. -
Especifica tu forma de pago con PayPal mediante 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 Braintree, establezca Enable PayPal Credit through Braintree en
Yes
.Cuando la opción Habilitar PayPal a través de Braintree está establecida en
Yes
, solo aparece este campo.note note NOTE PayPal crédito solo está disponible en los Estados Unidos y el Reino Unido. PayPal crédito se desactiva si el valor seleccionado para el Merchant Country campo no US
es oUK
. -
Para incluir PayPal PayLater como opción de pago con Braintree, establezca en Enable PayPal PayLater through Braintree
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 por PayPal de Braintree 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. -
Configúrelo Send Cart Line Items for PayPal para
Yes
enviar los elementos de línea (artículos del pedido) a PayPal junto con las tarjetas de regalo, el envoltorio para regalos para artículos, el envoltorio para regalos para pedidos, el crédito de la tienda, el envío y los impuestos como elementos de línea. -
Para Sort Order, ingrese un número para determinar la Secuencia en la que aparece la opción de pago PayPal Braintree cuando aparece junto con otras opciones de pago durante el cierre de compra.
-
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 omitir la página de revisión de pedidos de PayPal Express, establezca Skip Order Review Step en
Yes
.For customers paying with PayPal Express: If you want customers to be redirected to a review page before completing payment, set this to
No
. If you'd prefer customers to skip the review page, set it toYes
. -
To save a log file of interactions between your store and PayPal through Braintree, set Debug to
Yes
. -
To display the PayPal button on both the mini cart and shopping cart page, set Display on Shopping Cart to
Yes
. -
To send package tracking information to PayPal, set Send Package Tracking to
Yes
.Package tracking information will be sent to PayPal for PayPal transactions/orders only. Debe habilitar el campo de configuración Send Cart Line Items for PayPal para que la característica Package Tracking funcione correctamente.
-
Para notificar a un comprador o pagador por PayPal de las actualizaciones de seguimiento de paquetes, establece Use PayPal’s “Notify Payer” functionality 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
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
Cuando estas opciones están definidas, puedes ver la vista previa de los botones de PayPal. 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 aplicarlos 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: Pagar más tarde por mensajería
Product Page
-
Para mostrar mensajes de Pay Later en la tienda de la página de productos, establezca Show PayLater Messaging en
Yes
.Muestra la mensajería Pagar más tarde para las ofertas disponibles. Se aplican restricciones. Ver documentación de PayPal.
-
Para Message Layout, seleccione el diseño de mensaje Pay Later:
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
Cart
-
Para mostrar mensajes de Pay Later en la tienda en la página del minicarrito o el carrito, establezca Show PayLater Messaging en
Yes
.Muestra la mensajería Pagar más tarde para las ofertas disponibles. Se aplican restricciones. Ver documentación de PayPal.
-
Para Message Layout, seleccione el diseño de mensaje Pay Later:
Text
oFlex
-
Para Logo, seleccione el tipo de logotipo PayPal:
Inline
,Primary
,Alternative
, oNone
-
Para Logo Position, seleccione la posición del logotipo PayPal:
Left
,Right
oTop
-
Para Text Color, seleccione el color del texto del PayLater mensaje:
Black
,White
,Monochrome
, oGrayscale
Checkout
-
Para mostrar mensajes de Pay Later en la tienda al finalizar la compra, establece Show PayLater Messaging en
Yes
.Muestra la mensajería Pagar más tarde para las ofertas disponibles. Se aplican restricciones. Ver documentación de PayPal.
-
Para Text Align, seleccione la alineación de texto para el mensaje Pay Later:
Text
,Center
oRight
-
For Text Color, select the Pay Later message text color:
Black
,White
Step 14: Complete the 3D verification settings
-
If you want to add a verification step for customers using credit cards that are enrolled in a verification program (such as Verified by VISA), set 3D Secure Verification to
Yes
.During the process, the transaction amount that is submitted for verification is checked against the amount that is sent for authorization.
-
To always challenge the 3D Secure request for all transactions, set Always request 3DS to
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
- Customers from all countries specified in your store configuration can use this payment method.Specific Countries
- After choosing this option, the Verify for Specific Countries list appears. Hold down the Ctrl key (PC) or the Command key (Mac) and select each country in the list where customers can make purchases from your store.
Paso 15: Configurar los descriptores dinámicos de 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 de Braintree.
-
Enter the dynamic descriptor for the Name, Phone, and URL according to these guidelines:
-
Name - There are two parts to the name descriptor, which are separated by an asterisk (*). Por ejemplo:
company*myproduct
The first part of the descriptor identifies the company or DBA, and the second part identifies the product. The length of the
company
andproduct
parts of the descriptor can be allocated in the following ways, for a combined length of up to 22 characters.Characters in name descriptor
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 de 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 Marketplace Braintree, 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 Commerce Marketplace persisten y los pagos realizados con esas versiones anteriores se pueden capturar, anular o reembolsar como de costumbre.