> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lumi.new/llms.txt
> Use this file to discover all available pages before exploring further.

# PayPal

> Acepta pagos y suscripciones con PayPal en tu sitio web.

Puedes configurar los pagos con PayPal por completo a través del chat de Lumi. Menciona PayPal en tu solicitud y describe lo que quieres vender:

* «Permite que la gente pague mi libro electrónico con PayPal, \$15 en un solo pago».
* «Añade una membresía de \$9.99/mes cobrada a través de PayPal».

Con las credenciales de tu aplicación de PayPal, Lumi trabaja directamente en tu cuenta empresarial de PayPal y crea todo el flujo de pago en tu sitio web:

* **Pagos únicos**: un botón de PayPal que lleva al comprador a PayPal para aprobar el pago y, después, registra el pago completado en tu base de datos.
* **Suscripciones**: Lumi crea el producto y el plan de suscripción en tu cuenta de PayPal (reutilizando los que ya existen con el mismo nombre y precio), añade un botón de suscripción y mantiene actualizado el estado de cada suscripción.
* **Webhook**: Lumi registra un webhook para que tu sitio web reciba un aviso cuando los pagos se completan o se reembolsan, o cuando las suscripciones se activan, se cancelan, se suspenden o no se renuevan.
* **Página de precios y acceso restringido**: el contenido de pago solo se muestra a los clientes que han pagado.

También puedes preguntarle a Lumi por tu cuenta de PayPal en cualquier momento, por ejemplo «Muestra mis transacciones recientes», «Muestra mis planes de suscripción», «Reembolsa este pedido» o «Cancela esta suscripción».

> [!NOTE]
>
> PayPal está disponible para proyectos web. Si no indicas un proveedor de pagos, Lumi usa [Stripe](https://docs.lumi.new/es/features/stripe.md).

## Conecta tus credenciales de PayPal

**1. Crea una aplicación REST en PayPal**

En el PayPal Developer Dashboard, ve a **Apps & Credentials** y crea o abre una aplicación REST. Usa la pestaña **Sandbox** para las pruebas o la pestaña **Live** para pagos reales. Copia el **Client ID** y la **Secret key** de la aplicación.

**2. Introduce las credenciales en Lumi**

Rellena la tarjeta de credenciales de PayPal que Lumi muestra en el chat, o abre la pestaña **Herramientas** de tu espacio de trabajo y haz clic en la tarjeta **PayPal**. Introduce el **PayPal client ID** y el **PayPal client secret**, elige el **Environment** (**Sandbox (pruebas)** o **Producción**) y luego haz clic en **Guardar** y **Verificar**.

> [!WARNING]
>
> Nunca pegues tus credenciales en un mensaje del chat. Se guardan de forma segura en los [Secretos](https://docs.lumi.new/es/features/secrets.md) de tu proyecto. Las credenciales de Sandbox solo funcionan con el entorno Sandbox, y las credenciales Live solo con Producción. Que no coincidan es el motivo más habitual por el que PayPal rechaza las credenciales.

### Controla lo que Lumi puede cambiar

En la tarjeta **PayPal** de la pestaña Herramientas, cada acción que modifica tu cuenta de PayPal tiene un ajuste de aprobación: **Permitir siempre**, **Preguntar cada vez** o **No permitir nunca**. De forma predeterminada, crear productos y planes está permitido, mientras que los **reembolsos** y la **cancelación de suscripciones** piden tu aprobación cada vez. Las acciones de solo lectura, como mostrar las transacciones, siempre están permitidas.

## Prueba y sal en vivo

**1. Prueba en el sandbox**

Con credenciales de Sandbox no se mueve dinero real. En la página de PayPal, inicia sesión con una cuenta de comprador de sandbox (PayPal Developer Dashboard → **Testing Tools** → **Sandbox Accounts** → el correo electrónico y la contraseña de una cuenta Personal). Después de pagar, comprueba que el registro del pago o de la suscripción aparece en [Nube → Datos](https://docs.lumi.new/es/features/databases.md) y que tu página muestra la compra.

**2. Cambia al modo en vivo**

Crea una aplicación Live en PayPal y, en la tarjeta **PayPal**, introduce su Client ID y su Secret y establece el Environment en **Producción**. Pide a Lumi que cambie al modo en vivo: los productos y planes del sandbox no se trasladan, así que Lumi los vuelve a crear en tu cuenta en vivo y vuelve a registrar el webhook.

**3. Prueba final y lanzamiento**

Haz una última prueba con un artículo de bajo precio y, después, publica tu sitio web y compártelo.

Si algo sale mal en cualquier paso, díselo a Lumi. Revisa tu cuenta de PayPal y los registros de tus funciones para encontrar y corregir el problema.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.