Requisitos previos
- Una cuenta de Paddle (gratis crearla)
1
Obtén tu clave API de Paddle
- Inicia sesión en tu Panel de Paddle
- Ve a Herramientas de desarrollador → Autenticación
- Haz clic en Generar clave API
- 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
- En tu panel de Komerza, ve a Métodos de pago
- Encuentra Paddle y haz clic en Configurar
- Pega tu Clave API (del Paso 1)
- Haz clic en Guardar
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
- Un cliente selecciona Paddle en el proceso de pago
- Es redirigido a la página de pago segura alojada por Paddle
- Tras pagar, es devuelto a tu tienda con una confirmación
- 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:- Crea una cuenta Sandbox
- Usa tu clave API sandbox (
pdl_test_...) - No se realizan cargos reales - puedes probar el flujo completo de forma segura
- Cuando estés listo, desconecta y vuelve a conectar con tu clave API de producción