Commerce PayPal
Proporciona integración de pasarela de pago PayPal para Drupal Commerce, compatible con múltiples servicios de PayPal incluyendo Checkout API, Fastlane, Express Checkout y Payflow.
commerce_paypal
Install
composer require 'drupal/commerce_paypal:^2.0'
Overview
Commerce PayPal es un módulo integral de integración de pagos para Drupal Commerce que permite a los comerciantes aceptar pagos de PayPal en diversas formas. El módulo es compatible con la última API de PayPal Checkout con Smart Payment Buttons, el nuevo Fastlane by PayPal para experiencias de pago optimizadas, y opciones heredadas como Express Checkout, Payflow Pro y Payflow Link.
El módulo proporciona cinco pasarelas de pago distintas para adaptarse a diferentes necesidades comerciales: PayPal Checkout (recomendado) ofrece Smart Payment Buttons o Custom Card Fields; Fastlane by PayPal permite un pago rápido para clientes recurrentes; Express Checkout proporciona integración clásica de PayPal; Payflow Pro admite procesamiento directo de tarjetas de crédito; y Payflow Link ofrece páginas de pago alojadas.
Las características incluyen soporte de webhook para sincronización del estado de pagos, integración de mensajes de PayPal Credit, estilos de botones personalizables, recopilación de direcciones de envío desde PayPal y soporte para flujos de trabajo de pago tanto de autorización como de captura.
Features
- API de PayPal Checkout con Smart Payment Buttons para una selección de pago fluida que incluye PayPal, Pagar Después, Venmo y métodos de pago alternativos
- Integración de Custom Card Fields para aceptar pagos con tarjeta de crédito directamente en tu sitio a través de PayPal
- Fastlane by PayPal para una experiencia de pago acelerada con métodos de pago guardados y reconocimiento de direcciones
- Express Checkout (Heredado) para el flujo de pago clásico de PayPal con API NVP
- Integración de Payflow Pro para procesamiento directo de tarjetas de crédito con cuentas de comerciante
- Payflow Link para páginas de pago alojadas con modos de pago en iframe o redirección
- Mensajes de PayPal Credit en páginas de productos y carrito para promover opciones de financiamiento
- Integración de webhook para sincronización automática del estado de pagos (capturas, reembolsos, anulaciones)
- Flujos de trabajo de autorización y captura de pagos con opciones de captura manual o automática
- Actualizaciones de perfiles de facturación y envío desde datos de clientes de PayPal
- Estilos personalizables de Smart Payment Buttons (diseño, color, forma, etiqueta)
- Soporte para múltiples fuentes de financiamiento (PayPal, tarjetas de crédito, Pagar Después, Venmo, Bancontact, iDEAL, etc.)
- Soporte de transacciones de referencia para Payflow Link
- Manejo de IPN (Notificación Instantánea de Pago) para Express Checkout
- Integración con Views mediante manejador de área de mensajes de crédito para visualizaciones del carrito
- Flujos de pago personalizados optimizados para los métodos de pago PayPal Checkout y Fastlane
Use Cases
Integración simple de PayPal Checkout
Para tiendas que quieren ofrecer PayPal como opción de pago con una configuración mínima, configura la pasarela PayPal Checkout con Smart Payment Buttons. Los clientes pueden pagar con su cuenta de PayPal, tarjetas de crédito/débito, Pagar Después, Venmo u otros métodos de pago regionales directamente en la página de pago.
Aceptar tarjetas de crédito vía PayPal
Usar PayPal Checkout con Custom Card Fields permite a los comerciantes aceptar pagos con tarjeta de crédito directamente en su sitio sin la complejidad del cumplimiento PCI. Los datos de la tarjeta son tokenizados por el SDK de PayPal mientras el formulario de pago parece nativo de tu sitio.
Flujo de acceso directo desde la página del carrito
Habilita Smart Payment Buttons en la página del carrito para permitir que los clientes inicien el proceso de pago de PayPal directamente desde el carrito. Después de la aprobación, los clientes regresan a un paso de revisión simplificado antes de completar la compra.
Pago acelerado con Fastlane
Usa Fastlane by PayPal para clientes recurrentes que han optado por Fastlane. El sistema reconoce a los clientes por correo electrónico y autocompleta su información de pago y envío guardada, reduciendo drásticamente el tiempo de pago.
Procesamiento directo de tarjetas de crédito con Payflow Pro
Los comerciantes con cuentas existentes de Payflow Pro pueden aceptar tarjetas de crédito directamente usando formularios de entrada de tarjeta en el sitio. Adecuado para escenarios B2B o de suscripción que requieren métodos de pago almacenados.
Página de pago alojada con Payflow Link
Usa Payflow Link para una solución de pago alojada donde los clientes completan el pago en la página segura alojada de PayPal. Disponible como incrustación en iframe o redirección completa para comerciantes que buscan un alcance PCI mínimo.
Financiamiento promocional con mensajes de crédito
Habilita los mensajes de PayPal Credit en las páginas de productos y carrito para promover opciones de 'Pagar Después'. Muestra mensajes promocionales como 'Paga en 4' para aumentar las tasas de conversión en compras de mayor valor.
Autorización y captura posterior
Configura las pasarelas de pago para autorizar pagos en el proceso de pago y capturar después cuando se envían los pedidos. Útil para pre-pedidos, artículos con pedido pendiente o comerciantes que verifican el inventario antes de cobrar.
Tips
- Usa PayPal Checkout (paypal_checkout) o Fastlane (paypal_fastlane) para nuevas integraciones ya que Express Checkout y Payflow son opciones heredadas.
- Configura los webhooks para asegurar que los estados de pago se mantengan sincronizados entre PayPal y tu tienda, especialmente para autorizaciones, reembolsos y disputas.
- Habilita la opción 'Mostrar Smart Payment Buttons en la página del carrito' para permitir que los clientes inicien el proceso de pago directamente desde el carrito para una experiencia más fluida.
- Usa el modo Sandbox con cuentas de prueba de PayPal Developer para probar exhaustivamente los flujos de pago antes de pasar a producción.
- La función de mensajes de PayPal Credit puede aumentar las tasas de conversión promoviendo opciones de financiamiento - configúrala en el formulario de administración dedicado.
- Al usar Custom Card Fields, la recopilación de información de facturación es requerida; PayPal maneja los datos de la tarjeta de forma segura.
- Para Fastlane, asegúrate de que la configuración del flujo de pago tenga los paneles en el orden correcto: información de contacto, luego envío (si aplica), luego información de pago.
- Suscríbete a los eventos de PayPal mediante suscriptores de eventos para personalizar los datos del pedido enviados a PayPal, como añadir metadatos personalizados o modificar opciones de envío.
Technical Details
Admin Pages 1
/admin/commerce/config/payment/paypal-credit
Configura los mensajes de PayPal Credit para mostrar mensajes promocionales de financiamiento en las páginas de productos y carrito, animando a los clientes a usar PayPal Credit para sus compras.
Hooks 2
hook_commerce_paypal_express_checkout_request_alter
Permite a los módulos alterar los datos de solicitud NVP de Express Checkout mediante un suscriptor de eventos.
hook_commerce_paypal_checkout_order_request_alter
Permite a los módulos alterar los datos de solicitud de pedido de PayPal Checkout mediante un suscriptor de eventos.
Troubleshooting 6
Verifica que el Client ID sea correcto, que la pasarela de pago esté habilitada y disponible para la tienda del pedido, y que el total del pedido sea positivo. Revisa la consola del navegador en busca de errores de JavaScript y asegúrate de que ningún bloqueador de anuncios esté interfiriendo con los scripts de PayPal.
Asegúrate de que el ID del Webhook en la configuración de la pasarela coincida con el ID del webhook mostrado en tu Panel de PayPal Developer. La URL del Webhook debe ser accesible públicamente y usar HTTPS.
Verifica que estés usando las credenciales correctas para el modo seleccionado (Sandbox vs Producción). Para Checkout/Fastlane, usa Client ID y Secret de la API REST. Para Express Checkout, usa Nombre de usuario de API NVP, Contraseña y Firma.
Revisa la configuración del webhook y asegúrate de que los eventos de webhook requeridos estén suscritos (Captura de pago completada, Captura de pago denegada, etc.). Habilita el registro de solicitudes de webhook para depurar las notificaciones entrantes.
El módulo elimina automáticamente las opciones duplicadas de Smart Payment Buttons de PayPal Checkout. Si aparecen duplicados, asegúrate de que solo haya una pasarela de PayPal Checkout configurada para la tienda.
Asegúrate de que las páginas alojadas de Payflow Link estén correctamente configuradas en tu cuenta de PayPal Manager. El módulo incluye manejo de errores de iframe que mostrará mensajes y recargará la página cuando ocurran errores.
Security Notes 6
- Todas las pasarelas de pago de PayPal utilizan comunicación API segura sobre HTTPS. Las credenciales sensibles (secrets de API, contraseñas) nunca deben exponerse en logs o código del lado del cliente.
- Custom Card Fields tokeniza los datos de la tarjeta del lado del cliente a través del SDK de PayPal, manteniendo tu sitio fuera del alcance PCI para la transmisión de datos de tarjetas.
- Las firmas de webhook se verifican usando la API de verificación de PayPal para asegurar que las notificaciones sean auténticas antes de procesarlas.
- El módulo usa autenticación OAuth 2.0 para las APIs de Checkout y Fastlane, con tokens de acceso almacenados de forma segura en el sistema de estado de Drupal.
- Habilita el registro de solicitudes de webhook solo para propósitos de depuración; deshabilítalo en producción para evitar registrar datos sensibles de pago.
- Las credenciales de Payflow (contraseña) se almacenan encriptadas en el sistema de configuración de Drupal, pero aún deben protegerse a nivel del servidor.