Saltar al contenido principal
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 (gratis crearla)
1

Obtén tu clave API de Paddle

  1. Inicia sesión en tu Panel de Paddle
  2. Ve a Herramientas de desarrollador → Autenticación
  3. Haz clic en Generar clave API
  4. Copia la clave — comienza con pdl_live_
¿Quieres probar primero? Usa el Panel de Sandbox en su lugar. Las claves sandbox comienzan con pdl_test_ y no se cobra dinero real.
2

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.
3

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
Si el estado muestra Inactivo, comprueba que tu clave API comience con pdl_live_ (o pdl_test_ para sandbox).

​
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
  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

ProblemaSolución
Los pagos no se completanVerifica que tu clave API sea válida y comience con pdl_live_ (o pdl_test_ para sandbox)
Estado inactivoComprueba tu clave API en Métodos de pago → Paddle
No recibe notificaciones de disputasContacta con soporte — es posible que el webhook deba recrearse (desconecta y vuelve a conectar Paddle)