RevGlancePaddle
Conecte o Paddle Billing com uma chave de API que possa ler transações, ajustes, assinaturas e clientes.
Conectar
- No Paddle, abra Developer tools › Authentication e crie uma chave de API. Somente Paddle Billing: o Paddle Classic não é compatível.
- Permita que ela leia transactions, adjustments, subscriptions e customers. Adicione
transaction.writese você for enviar e-mails de recuperação. - Copie a chave. Uma chave de produção começa com
pdl_live_apikey_; uma chave sandbox também funciona e sincroniza a partir do sandbox do Paddle. - Cole-a em Chave de API e escolha Conectar Paddle.
O que o formulário pede
| Campo | Formato |
|---|---|
| Chave de APIArmazenado criptografado | pdl_live_apikey_… |
Adicione o webhook
- No RevGlance, abra Configurações › Fontes, abra o menu da fonte Paddle e escolha Webhook. Copie o URL.
- No Paddle, abra Developer tools › Notifications e adicione um destino com esse URL. Selecione os eventos de transação, ajuste e assinatura.
- Copie a secret key do destino, cole-a em Segredo de assinatura no RevGlance e salve.
O que o RevGlance sincroniza
- Transações pagas ou concluídas, com o cliente e o endereço.
- Ajustes: reembolsos e estornos aprovados viram reembolsos, e saem de novo quando são revertidos.
- Assinaturas, para MRR, planos, testes e cancelamentos, com os descontos recorrentes descontados do MRR.
- Clientes, ativos e arquivados.
O Paddle não guarda motivos de cancelamento, então os cancelamentos chegam sem motivo.
Como o Paddle é contado
- Os valores vêm dos totais de repasse do Paddle, antes de impostos, com a taxa do Paddle como taxa.
- Reembolsos e estornos contam antes de impostos. Um estorno que o Paddle ganha, ou um reembolso que o Paddle reverte, deixa de contar.
- Uma taxa de estorno que o Paddle retém conta como taxa.
- Um preço com impostos inclusos conta antes de impostos no MRR, na proporção de impostos da próxima fatura.
- Descontos recorrentes são descontados do MRR, também quando o desconto foi arquivado depois.
- Um pagamento que não pôde ser cobrado conta como cobrança com falha. Não movimenta dinheiro.
E-mails de recuperação
O Recuperar liga cada pagamento com falha ao checkout de atualização do método de pagamento do Paddle. Isso exige transaction.write na chave; sem isso, o e-mail leva à sua própria página de atualização do cartão.