Conectar Paddle

Paddle envía tus ventas, renovaciones y reembolsos a Clakta mediante un webhook que creas una sola vez en Paddle.

Conectar

1. Ve a Configuración del proyecto → Plataformas de venta.
2. Elige Paddle, ponle nombre a la conexión y haz clic en Crear conexión. Clakta genera una URL de webhook. Cópiala.
3. En Paddle, ve a Events → Notifications y haz clic en New destination.
   
4. En notification type, selecciona Webhook y pega la URL que copiaste de Clakta.
   
5. En events, selecciona los eventos de la tabla de abajo y guarda.

6. Abre el destination que acabas de crear y copia su secret key. Empieza por pdl_ntfset_.
   
7. De vuelta en Clakta, pega la secret key en el campo Clave secreta y haz clic en Finalizar.
   

La tarjeta muestra Añadida en cuanto se guarda la clave.

Seleccionar eventos de más no causa problemas: Clakta confirma la recepción e ignora todo lo que no gestiona.

Activa el script de Clakta

Para atribuir cada venta a la visita que la trajo, instala el script de Clakta en las páginas que abren el checkout de Paddle. El script añade la sesión del visitante al checkout por sí solo, así que no hay nada más que configurar. Los proyectos en modo Respetuoso con la privacidad no envían esta sesión.

Si creas el checkout en tu propio código

Si creas transacciones desde tu servidor, envía clakta.getSessionId() desde la página junto con la petición de checkout y ponlo en custom_data:

await fetch("https://api.paddle.com/transactions", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${PADDLE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    items,
    custom_data: { clakta_session_id: claktaSessionId },
  }),
})

Si construyes tú las opciones del checkout, decóralas antes:

Paddle.Checkout.open(
  clakta.decoratePaddleCheckout({
    items: [{ priceId: "pri_01gm81eqze2vmmvhpjg13bfeqg", quantity: 1 }],
  }),
)

Resolución de problemas