Conectar Paddle

O Paddle envia suas vendas, renovações e reembolsos ao Clakta por um webhook, que você cria uma única vez no Paddle.

Conectar

1. Vá em Configurações do projeto → Plataformas de vendas.
2. Escolha Paddle, dê um nome à conexão e clique em Criar conexão. O Clakta gera uma URL de webhook. Copie a URL.
3. No Paddle, vá em Events → Notifications e clique em New destination.
   
4. Em notification type, selecione Webhook e cole a URL que você copiou do Clakta.
   
5. Em events, selecione os eventos da tabela abaixo e salve.

6. Abra a destination que você acabou de criar e copie a secret key dela. Ela começa com pdl_ntfset_.
   
7. De volta ao Clakta, cole a secret key no campo Chave secreta e clique em Concluir.
   

O card mostra Adicionada assim que a chave é salva.

Selecionar eventos a mais não causa problema: o Clakta confirma o recebimento e ignora tudo o que não trata.

Ative o script do Clakta

Para creditar cada venda à visita que a trouxe, instale o script do Clakta nas páginas que abrem o checkout do Paddle. O script adiciona a sessão do visitante ao checkout sozinho, então não há mais nada para configurar. Projetos no modo Amigável à privacidade não enviam essa sessão.

Se você monta o checkout no seu próprio código

Se você cria transações pelo seu servidor, envie clakta.getSessionId() da página junto com o pedido de checkout e coloque o valor em 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 },
  }),
})

Se você monta as opções do checkout por conta própria, decore-as antes:

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

Solução de problemas