Cómo configurar PayPal Business en una tienda online de España

Requisitos: cuenta Business y datos de la tienda

Antes de activar PayPal, comprueba que el país de tu tienda sea España y que el pedido se cobre en euros. PayPal requiere una cuenta Business de la persona o empresa que recibirá el dinero, habilitada para los pagos que desea aceptar.

En Tiendli hay dos opciones: el bloque PayPal Personal / PayPal.Me en Negocio → Pagos permite crear un pedido y presentar un enlace manual de cobro; y el bloque PayPal Business permite iniciar y conciliar pagos automáticamente con la API REST. También puedes publicar un enlace PayPal.Me independiente en Medios de pago directos.

• Acceso al panel propietario de la tienda Tiendli y a la cuenta PayPal Business.
• Acceso a PayPal Developer para gestionar Apps & Credentials.
• Client ID y Client Secret de la misma aplicación y entorno (Live o Sandbox).
• Webhook ID de un webhook creado en esa misma aplicación.
• Tienda española con moneda de cobro EUR.

Crear o seleccionar la aplicación REST en PayPal

Entra en PayPal Developer con la cuenta que cobrará las ventas. En Apps & Credentials, crea una aplicación REST o utiliza una existente. Selecciona Live para credenciales de producción o Sandbox si solo estás ensayando con cuentas de prueba.

Copia el Client ID y el Client Secret. Los dos deben pertenecer al mismo entorno: mezclar claves Live y Sandbox provocará errores de OAuth. Nunca envíes el Client Secret por WhatsApp, email o capturas; introdúcelo únicamente en el formulario autenticado de Tiendli.

• En PayPal Developer, abre Apps & Credentials.
• Selecciona la aplicación que recibirá los pagos.
• Anota Client ID y guarda Client Secret en un lugar seguro.
• Confirma que tu cuenta Business tiene las capacidades comerciales necesarias.

Registrar el webhook para notificaciones de pago

Abre la configuración de tu aplicación PayPal y añade la URL de webhook que Tiendli muestra en el bloque PayPal de los ajustes de la tienda. Esa URL contiene el identificador interno de tu comercio; no uses la URL de otra tienda.

Activa al menos los eventos CHECKOUT.ORDER.APPROVED y PAYMENT.CAPTURE.COMPLETED. Copia el Webhook ID que proporciona PayPal y pégalo en Tiendli. El webhook complementa el retorno del navegador: el pedido solo se confirma tras verificar la operación contra PayPal.

• Copiar la URL de webhook específica de tu tienda desde Tiendli.
• Añadirla a la aplicación PayPal del mismo entorno.
• Suscribirse a los eventos de aprobación y captura completada.
• Guardar el Webhook ID correspondiente en la configuración de Tiendli.

Activar PayPal en Tiendli y probar la conexión

En el panel propietario de Tiendli entra en Negocio → Pagos. Busca PayPal, introduce Client ID, Client Secret y Webhook ID, activa el interruptor del método y desactiva Modo de prueba para ventas reales. Guarda la configuración.

El botón Probar conexión verifica que PayPal acepta las credenciales de la aplicación. Una respuesta correcta no demuestra por sí sola que los webhooks funcionen ni que una compra haya sido capturada: completa una compra real de importe mínimo para comprobar esos pasos.

• PayPal marcado como activo en el panel.
• Sandbox desactivado para un checkout real.
• Client ID, Client Secret y Webhook ID presentes.
• Probar conexión ejecutado y resultado revisado.
• Compra de importe mínimo confirmada en PayPal y en el pedido Tiendli.

Qué ve el comprador y cuándo se marca pagado el pedido

En el checkout, el comprador elige PayPal y Tiendli crea una orden a través de la API Orders v2. El cliente confirma el pago en el entorno de PayPal y luego regresa a Tiendli.

La vuelta al sitio no es por sí misma prueba de cobro. Tiendli consulta el estado auténtico de la orden, comprueba moneda, importe y referencia, y actualiza el pedido cuando la captura está completada. Nunca entregues productos digitales ni marques pedidos como pagados únicamente porque el comprador mostró una pantalla de regreso.

Solucionar errores comunes

Si no aparece PayPal: revisa primero si lo has activado en Pagos y no solamente en Medios de pago directos; confirma EUR, modo Live, credenciales completas y el estado activo. Después revisa el checkout desde una ventana privada y vuelve a cargar el carrito.

Si Probar conexión indica Client Authentication failed, PayPal rechazó la pareja Client ID / Client Secret. Primero comprueba qué modo está guardado en Tiendli: con Modo de prueba apagado utiliza las claves LIVE de una misma aplicación REST; con Modo de prueba encendido utiliza las claves SANDBOX. No pegues el correo o contraseña de PayPal como credenciales. Pulsa Guardar PayPal antes de Probar conexión: el test solo utiliza los datos guardados. Este error ocurre antes de validar Webhook ID, pedidos o capturas. Si el pago se abre pero no se acredita, entonces revisa Webhook ID, URL de eventos y conciliación. No repitas cargos reales sin revisar la transacción.