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

# Configurar Paddle

> Configura los pagos de Paddle en tu tienda Komerza

Acepta pagos a través de Paddle en tu tienda Komerza. Paddle gestiona la interfaz de pago — tus clientes son redirigidos a una página de pago segura alojada por Paddle y devueltos a tu tienda una vez completado el pago.

## Requisitos previos

* Una cuenta de [Paddle](https://www.paddle.com/) (gratis crearla)

<Steps>
  <Step title="Obtén tu clave API de Paddle">
    1. Inicia sesión en tu [Panel de Paddle](https://vendors.paddle.com/)
    2. Ve a **Herramientas de desarrollador → Autenticación**
    3. Haz clic en **Generar clave API**
    4. Copia la clave — comienza con `pdl_live_`

    <Note>
      **¿Quieres probar primero?** Usa el [Panel de Sandbox](https://sandbox-vendors.paddle.com/) en su lugar. Las claves sandbox comienzan con `pdl_test_` y no se cobra dinero real.
    </Note>
  </Step>

  <Step title="Conectar Paddle a Komerza">
    1. En tu panel de Komerza, ve a **Métodos de pago**
    2. Encuentra **Paddle** y haz clic en **Configurar**
    3. Pega tu **Clave API** (del Paso 1)
    4. Haz clic en **Guardar**

    Komerza crea automáticamente el endpoint del webhook en tu cuenta de Paddle. No se necesita configuración manual del webhook.
  </Step>

  <Step title="Verificar la conexión">
    Ve a **Métodos de pago → Paddle** en tu panel. El estado mostrará:

    * **Activo** — Todo está conectado y funcionando
    * **Inactivo** — Verifica que tu clave API sea correcta

    <Note>
      Si el estado muestra **Inactivo**, comprueba que tu clave API comience con `pdl_live_` (o `pdl_test_` para sandbox).
    </Note>
  </Step>
</Steps>

## Cómo funciona

1. Un cliente selecciona Paddle en el proceso de pago
2. Es redirigido a la página de pago segura alojada por Paddle
3. Tras pagar, es devuelto a tu tienda con una confirmación
4. Komerza recibe un webhook de Paddle confirmando el pago y entrega el pedido automáticamente

## Gestión de pagos

* **Reembolsos** — Puedes emitir reembolsos completos a través de Komerza. El reembolso se procesa a través del sistema de Paddle y el cliente recibe su dinero de vuelta.
* **Disputas** — Si un cliente abre una disputa con su banco, recibirás una notificación en Komerza. El pedido se marca como disputado y puedes responder a través del panel de Paddle.

## Pruebas en sandbox

Si quieres probar antes de lanzarte en producción:

1. Crea una [cuenta Sandbox](https://sandbox-vendors.paddle.com/)
2. Usa tu clave API sandbox (`pdl_test_...`)
3. No se realizan cargos reales — puedes probar el flujo completo de forma segura
4. Cuando estés listo, desconecta y vuelve a conectar con tu clave API de producción

## Desconectar Paddle

Ve a **Métodos de pago → Paddle** y haz clic en **Desconectar**. Esto también elimina el endpoint del webhook de tu cuenta de Paddle. Tus pedidos existentes no se ven afectados — solo los nuevos pagos dejarán de ofrecer Paddle.

## Solución de problemas

| Problema                             | Solución                                                                                                |
| ------------------------------------ | ------------------------------------------------------------------------------------------------------- |
| Los pagos no se completan            | Verifica que tu clave API sea válida y comience con `pdl_live_` (o `pdl_test_` para sandbox)            |
| Estado inactivo                      | Comprueba tu clave API en **Métodos de pago → Paddle**                                                  |
| No recibe notificaciones de disputas | Contacta con soporte — es posible que el webhook deba recrearse (desconecta y vuelve a conectar Paddle) |