Easy Digital Downloads viene con una integración de PayPal incorporada. Esta pasarela utiliza la última experiencia de pago de PayPal, utilizando botones inteligentes y una ventana modal de “Pagar con PayPal” que mantiene a los usuarios en tu sitio durante todo el proceso de pago. Esta documentación cubre todo lo que necesitas saber sobre la gestión de tu configuración de PayPal.
¿Estás actualizando desde una pasarela de PayPal diferente? Consulta nuestras notas de actualización.
NOTA: Esta integración de PayPal requiere un certificado SSL. Si aún no tienes uno, consulta nuestro artículo sobre cómo configurar SSL.
Configurar PayPal
1. Conecta con tu cuenta de PayPal
Necesitarás una cuenta de PayPal para poder aceptar pagos utilizando esta pasarela. Si aún no tienes una cuenta, se te dará la opción de crear una durante el proceso de incorporación.
Inicia sesión en tu administrador de WordPress y ve a Descargas » Ajustes » Pagos » PayPal. Verás un botón para conectar con PayPal en el modo actual de tu tienda (ya sea sandbox o en vivo).
Haz clic en el botón para abrir una ventana modal de PayPal. Esto te pedirá que introduzcas tu dirección de correo electrónico y país. Continúa con los pasos para iniciar sesión en tu cuenta existente o crear una nueva.
Importante: Necesitas tener las ventanas emergentes del navegador habilitadas para que la página de PayPal se abra en una ventana modal. Si no ves una ventana modal, por favor, comprueba la configuración de ventanas emergentes de tu navegador, cierra el navegador e inténtalo de nuevo. Si la ventana emergente todavía no aparece, podrías intentar con el navegador Chrome.
Si encuentras un error al conectar con PayPal y el problema persiste, esto puede ser causado por reglas del servidor que impiden que aparezca la ventana modal de conexión. Esto puede presentarse como un error relacionado con la función `hash_equals`. Para resolverlo, tú o tu proveedor de alojamiento pueden necesitar ajustar la `Cross-Origin-Opener-Policy`. Si el valor es “same-origin”, puede causar este problema.
Si te estás conectando en modo de prueba, necesitarás iniciar sesión con las credenciales de tu cuenta sandbox. Si aún no tienes una cuenta sandbox de PayPal, consulta nuestro artículo sobre cómo crear una.
Después de completar todos los pasos, deberías ver este mensaje de éxito:
Asegúrate de hacer clic en el botón para volver a tu tienda. Si no haces clic en este botón, no podremos completar el proceso de incorporación y tendrás que empezar de nuevo.
2. Comprueba el estado de tu cuenta
De vuelta en los ajustes de administrador de EDD, el área de “Estado de la conexión” comprobará tu conexión con PayPal. Hay tres posibilidades:
Éxito
Tu cuenta se conectó correctamente, estás listo para aceptar pagos y EDD creó una webhook en tu nombre. Puedes leer más sobre la webhook en la sección de webhooks.
Éxito, con advertencia de webhook
Esto significa que tu cuenta de PayPal se ha conectado correctamente y puedes empezar a recibir pagos. Sin embargo, EDD no pudo crear una webhook en tu nombre. Esto no es algo de lo que debas preocuparte en un entorno local, pero si ocurre en tu sitio web en producción, ponte en contacto con el soporte de EDD para obtener ayuda. Puedes leer más sobre la utilidad de la webhook en la sección de webhooks.
Error
También puedes recibir un mensaje de error como este. La mayoría de los errores en "Estado del pago" significan que algo en tu cuenta de PayPal no está listo para recibir pagos. Esto significa que debes ponerte en contacto con el soporte al cliente de PayPal o hacer algo dentro de tu cuenta de PayPal, como confirmar tu dirección de correo electrónico.
Una vez que hayas corregido cualquier error, haz clic en "Volver a comprobar el estado del pago" para verificar tu cuenta con PayPal de nuevo. Todos los errores deben resolverse antes de que puedas empezar a aceptar pagos.
3. Habilitar la pasarela de PayPal
Una vez conectado, asegúrate de habilitar la pasarela en la configuración general de pasarelas:
Repetir en modo "live"
Si te conectas inicialmente en modo de prueba, deberás repetir este proceso de conexión una vez que cambies tu tienda al modo "live".
Webhook
Easy Digital Downloads intentará automáticamente crear una webhook en tu nombre. La webhook se utiliza principalmente para transmitir acciones que ocurren dentro del panel de control de PayPal de vuelta a EDD. Por ejemplo: si reembolsas un pago dentro de PayPal, EDD lo detectará y actualizará automáticamente el estado del pago en EDD por ti.
Las webhooks no son necesarias para procesar pagos, pero se recomiendan para una integración más completa.
Comprobando el estado de la webhook
Puedes comprobar el estado de tu webhook en cualquier momento yendo a Descargas » Ajustes » Pagos » PayPal. Se mostrará el estado de la webhook, junto con los eventos registrados.
El botón "Sincronizar Webhook" simplemente comprobará de nuevo el estado de la webhook y registrará cualquier evento que falte. Normalmente no deberías necesitar hacer clic en él a menos que:
- Hayas cambiado la URL de tu sitio; o
- Vea un mensaje de advertencia sobre que la webhook no está completamente configurada o una advertencia sobre eventos faltantes.
IPN de reserva
Easy Digital Downloads te permitirá ahora utilizar un servicio de IPN de reserva que maneja cualquier escenario en el que un evento de Webhook no se entregue a tu sitio web.
Para configurar la IPN, necesitas iniciar sesión en tu cuenta de PayPal y pasar el ratón por encima del engranaje en la esquina superior derecha de la pantalla, luego selecciona Ajustes de la cuenta
Haz clic en Notificaciones en el lado izquierdo de la pantalla, luego haz clic en Actualizar junto a Notificaciones de pago instantáneo.
Si no tenías la IPN habilitada antes, verás un botón Elegir ajustes de IPN. En la página de ajustes de IPN, añade la URL de tu sitio web en el formato: https://tudominio.com/?edd-listener=eppe
Reemplaza tudominio.com en el enlace con la URL real de tu sitio web.
Marca la casilla Recibir mensajes IPN (Habilitado) y luego haz clic en Guardar.
¡Eso es todo! Esto actuará ahora como una copia de seguridad del Webhook principal que la configuración de PayPal utiliza al conectar su cuenta.
PayPal Commerce Pro
PayPal Commerce Pro es una extensión de pago que permite a los clientes pagar con tarjeta de crédito o débito y métodos de pago alternativos (según su país), como Venmo, Apple Pay y Google Pay, directamente en su sitio en lugar de que los clientes sean dirigidos al sitio de PayPal.
Una vez instalada y activada, aparecerá una nueva opción, "Habilitar pagos avanzados con tarjeta de crédito y débito", en la configuración de PayPal ubicada en Descargas » Ajustes » Pagos » PayPal.
Una vez habilitados, los botones "Tarjeta de débito o crédito" y "Paga más tarde" (si tu cuenta de PayPal lo admite) aparecerán en tu página de pago, junto con el botón de PayPal.
Experiencia de pago
Esta pasarela de pago utiliza los botones de pago modernos de PayPal. En lugar de un botón "Comprar" normal, tus clientes verán esto al final del formulario de pago:
Tras hacer clic en el botón, se abre una ventana modal en PayPal.com, que solicita al usuario que inicie sesión en su cuenta de PayPal. El cliente puede completar todo el proceso de pago sin salir de tu sitio.
Integración de pagos recurrentes
Esta pasarela de PayPal tiene soporte completo para la extensión de Pagos Recurrentes. Consulta la documentación de configuración de Pagos Recurrentes de PayPal para obtener instrucciones de configuración.
Soporte del navegador
Se garantiza el soporte para los siguientes navegadores de escritorio. Para cualquier navegador que no esté en esta lista, los botones podrían seguir funcionando, pero no se garantiza la compatibilidad.
- Chrome versión 41 y posteriores
- Firefox versión 43 y posteriores
- Safari versión 8 y posteriores
- Opera versión 12 y posteriores
- Edge versión 14 y posteriores
- * Internet Explorer versión 11 y posteriores
* Nota: Aunque los botones deberían funcionar en IE11, tenemos que cargar varios polyfills para hacerlo compatible. Para una mejor experiencia de pago, recomendamos usar un navegador más moderno. Si prefieres no cargar los polyfills de IE11, puedes deshabilitarlos añadiendo este código personalizado a tu sitio:
add_filter( 'edd_load_ie11_polyfills', '__return_false' );
Si añades este fragmento de código, la pasarela de PayPal no funcionará en IE11.
Para más información sobre los requisitos de navegador de PayPal Checkout, consulta la página de Soporte de Navegadores de PayPal.
Creación de una cuenta de PayPal Sandbox
PayPal Sandbox te permite configurar cuentas de prueba que se pueden usar para probar el proceso de compra completo en Easy Digital Downloads con la pasarela de PayPal. No se realizan cargos reales y puedes usarla durante el tiempo que desees, ya que son cuentas de prueba que imitan el flujo real de PayPal.
Para crear una cuenta sandbox, visita https://developer.paypal.com y haz clic en Iniciar sesión o Registrarse si aún no tienes una cuenta de PayPal configurada. Puedes iniciar sesión con tu cuenta de PayPal existente si la tienes.
Una vez iniciada la sesión, sigue los pasos a continuación para crear una cuenta Sandbox
- Ve a Herramientas de prueba ygt; Cuentas Sandbox.
- Haz clic en "Crear cuenta".
- Selecciona “Empresa”, elige el país de la cuenta y haz clic en “Crear cuenta”.
- Vuelve a hacer clic en “Crear cuenta” y esta vez selecciona “Personal” como tipo de cuenta.
Los pasos anteriores crearán una cuenta de comerciante que utilizarás para conectarte dentro de EDD y una personal que utilizarás durante el flujo de pago para simular un pago.
En la página de Cuentas de prueba, puedes hacer clic en la cuenta que deseas ver/editar y podrás ver la contraseña predeterminada que se estableció durante la creación o establecer tu contraseña personalizada.
¿Cómo puedo estar seguro de que estoy en modo de prueba?
Para asegurarte de que tu sitio está funcionando en modo de prueba, ve a Descargas » Ajustes » Pagos, y marca la casilla Modo de prueba en la parte superior de la página.
Recuerda
Antes de lanzar tu sitio, sácalo del modo de prueba o ninguna de tus ventas será válida. Es posible que debas conectarte con tu cuenta de PayPal en vivo una vez que desactives el modo de prueba.
Actualización desde otras pasarelas de PayPal
Actualizar a la nueva pasarela de PayPal es simplemente conectarse, seguir los pasos de configuración anteriores y luego deshabilitar la(s) pasarela(s) antigua(s).
Si anteriormente utilizaste una de nuestras integraciones antiguas de PayPal, como PayPal Standard, PayPal Express, PayPal Pro o PayPal Payments Advanced, se te pedirá que cambies a esta nueva pasarela después de actualizar a Easy Digital Downloads versión 2.11.
¿Cómo funciona la actualización?
Hasta que te conectes a la nueva pasarela, los pagos seguirán procesándose a través de tu sitio utilizando la pasarela existente que hayas seleccionado. Cuando te conectes a la nueva integración de PayPal, deberías conectarte utilizando la misma cuenta de PayPal que usaste antes. Una vez que el proceso de conexión se complete y hayas habilitado la nueva pasarela, los pagos comenzarán a procesarse a través de la nueva integración de PayPal. Asegúrate de deshabilitar la pasarela antigua para que solo la nueva esté activa.
Dentro de PayPal mismo, no notarás ninguna diferencia. Los pagos seguirán llegando de la misma manera que antes. Solo la experiencia de pago en tu sitio se ha actualizado.
¿Qué pasa con los pagos recurrentes?
Si utilizas nuestra extensión de Pagos recurrentes, puedes cambiar de forma segura a la nueva pasarela de PayPal sin afectar las suscripciones existentes. Las suscripciones antiguas continuarán procesándose y renovándose de forma normal. Sin embargo:
- Una vez configurada la nueva pasarela, puedes desmarcar la pasarela antigua de la lista de pasarelas de pago habilitadas.
- Para PayPal Express y Pro, necesitas mantener configurado tu antiguo IPN de PayPal (Documentación IPN de Express / Pro), ya que las suscripciones creadas con la pasarela antigua seguirán utilizando IPN para informar a EDD sobre los pagos de renovación. PayPal Standard no depende de IPN, ya que la URL se establece de forma fija en el IPN. Si no utilizas tu cuenta de PayPal con varias tiendas, te recomendamos configurarlo en caso de que PayPal cambie la funcionalidad en el futuro (Documentación IPN de Standard), pero no es obligatorio.
- Si estás usando PayPal Express o PayPal Pro, necesitas mantener ese plugin activado. La pasarela en sí no debe estar habilitada (Descargas » Ajustes » Pagos), pero el plugin sí debe estarlo. Esto es para asegurar que la pasarela pueda continuar procesando IPsNs antiguas, como se indica en el paso 2.
¿Nota: Usando Aelia Currency Switcher?
PayPal deberá ser re-añadido en los Ajustes de Pasarelas de Pago de Aelia para las divisas soportadas en tu sitio. De lo contrario, PayPal ya no será una pasarela disponible en el proceso de pago.
¿Tengo que actualizar a la nueva integración?
Todas las integraciones antiguas de PayPal serán descontinuadas. Ya no recibirán actualizaciones en el futuro. Adicionalmente, muchas de las integraciones antiguas también están descontinuadas en el lado de PayPal y representan experiencias de pago más antiguas.
Las integraciones antiguas deberían seguir funcionando en EDD 2.x, pero recomendamos cambiar a la nueva pasarela antes de la 3.0, ya que las extensiones antiguas de PayPal no se actualizarán para ser compatibles con la 3.0.
Preguntas frecuentes
¿Veo SANDHILLS DEVELOPMENT, LLC durante el proceso de conexión, es esto esperado?
Sí, Easy Digital Downloads es un producto de SANDHILLS DEVELOPMENT, LLC. Estás aceptando conectar tu cuenta de PayPal a tu tienda Easy Digital Downloads (un producto de SANDHILLS DEVELOPMENT, LLC). Desafortunadamente, PayPal requiere el uso del nombre de la empresa en lugar del nombre de nuestro producto.
¿Puedo conectarme a PayPal con una cuenta personal?
Se requiere una cuenta de empresa para conectar EDD a PayPal. No puedes conectar EDD a una cuenta personal de PayPal. Si no tienes una cuenta de empresa, puedes crear una cuenta de empresa separada y tener múltiples cuentas de PayPal si no quieres convertir tu cuenta personal en una cuenta de empresa.
¿Por qué aparece el error “Error de autenticación inesperado” en mi página de pago?
Esto se debe probablemente a que PayPal no está correctamente conectado a tu tienda. Comprueba el estado en Descargas » Ajustes » Pagos » PayPal. También querrás confirmar que tu cuenta de PayPal real no está conectada a EDD en Modo de Prueba y que tu cuenta Sandbox de PayPal no está conectada a tu conexión real de PayPal (conectando a PayPal con el Modo de Prueba desactivado).
¿Por qué PayPal no se conecta a EDD?
Esto puede deberse a varios problemas.
– Intenta conectarte a través de un navegador o dispositivo diferente.
– Confirma que el país al que está vinculada tu cuenta de PayPal es un país admitido, que aparece en el menú desplegable durante el proceso de conexión.
– Confirma que tu cuenta de PayPal está completamente activa. Es posible que PayPal tenga acciones pendientes que necesites completar. Busca avisos en tu cuenta de PayPal y/o contacta con el soporte de PayPal para confirmar que tu cuenta está activa.
¿Puedo añadir o quitar los botones de Pagar en 3 o Pagar en 4?
Se requiere PayPal Commerce Pro para que el botón Pagar en 3 o Pagar en 4 aparezca en tu sitio. Si el botón aparece y deseas deshabilitarlo, puedes hacerlo a través de la configuración de PayPal de EDD.
También puedes admitir un número determinado de pagos utilizando nuestra extensión de Pagos Recurrentes.
¿Por qué no se muestra el pago de invitado de PayPal?
Al pagar a través de una página de pago en PayPal.com, a veces existe la opción de pagar con tarjeta de crédito sin iniciar sesión en PayPal. Esto se conoce como modo de pago "invitado" o Cuenta opcional de PayPal. Consulta las instrucciones de PayPal aquí para habilitarlo o deshabilitarlo. Así es como se habilita la configuración de cuenta opcional de PayPal:
- Coloca el cursor sobre tu nombre en la esquina superior derecha.
- Haz clic en Configuración de la cuenta en el menú desplegable.
- Haz clic en Pagos del sitio web en "Productos y servicios" a la izquierda de la página.
- Haz clic en Actualizar junto a "Preferencias del sitio web".
- Selecciona Activado en "Cuenta de PayPal opcional".
¿Necesito SSL si uso PayPal?
Sí, necesitas tener SSL habilitado en tu sitio web, aunque los pagos se procesen fuera del sitio con PayPal.
Los clientes no son redirigidos de vuelta a mi sitio después de pagar.
Cuando las personas pagan con PayPal, esperan ser redirigidas de vuelta a tu sitio web después de pagar. Si esto no funciona correctamente, es probable que la opción de retorno automático deba habilitarse en tu perfil de PayPal.
Log into your PayPal account and go to your profile settings.
In your settings, click on Website Preferences.
There you will have an option to enable automatic return.
En el ejemplo anterior, está desactivado. Para activarlo, elige el botón de opción Activado y, a continuación, en el campo de abajo, asegúrate de introducir la dirección a la que deseas que se redirijan tus clientes.
