RevGlanceDocumentación

Paddle

Conecta Paddle Billing con una clave de API que pueda leer transacciones, ajustes, suscripciones y clientes.

Conectar

  1. En Paddle, abre Developer tools › Authentication y crea una clave de API. Solo Paddle Billing: Paddle Classic no es compatible.
  2. Permítele leer transactions, adjustments, subscriptions y customers. Añade transaction.write si vas a enviar correos de recuperación.
  3. Copia la clave. Una clave live empieza por pdl_live_apikey_; una clave de sandbox también funciona y sincroniza desde el sandbox de Paddle.
  4. Pégala en Clave de API y elige Conectar Paddle.

Qué pide el formulario

CampoAspecto
Clave de APISe guarda cifradopdl_live_apikey_…

Añadir el webhook

  1. En RevGlance, abre Configuración › Fuentes, abre el menú de la fuente de Paddle y elige Webhook. Copia la URL.
  2. En Paddle, abre Developer tools › Notifications y añade un destino con esa URL. Selecciona los eventos de transacciones, ajustes y suscripciones.
  3. Copia la secret key del destino, pégala en Secreto de firma en RevGlance y guarda.

Qué sincroniza RevGlance

  • Transacciones pagadas o completadas, con su cliente y su dirección.
  • Ajustes: los reembolsos y contracargos aprobados se convierten en reembolsos, y se vuelven a descontar cuando se revierten.
  • Suscripciones, para el MRR, los planes, las pruebas y las cancelaciones, con los descuentos recurrentes restados del MRR.
  • Clientes, activos y archivados.

Paddle no guarda motivos de cancelación, así que las cancelaciones llegan sin motivo.

Cómo se cuenta Paddle

  • Los importes salen de los totales de pago de Paddle, antes de impuestos, con la comisión de Paddle como comisión.
  • Los reembolsos y contracargos cuentan antes de impuestos. Un contracargo que Paddle gana, o un reembolso que Paddle revierte, deja de contar.
  • Una comisión por contracargo que Paddle retiene cuenta como comisión.
  • Un precio con impuestos incluidos cuenta antes de impuestos en el MRR, en la proporción de impuesto de la próxima factura.
  • Los descuentos recurrentes se restan del MRR, también si el descuento se archivó más tarde.
  • Un pago que no se pudo cobrar cuenta como cobro fallido. No mueve dinero.

Correos de recuperación

Recuperar enlaza cada pago fallido con el checkout de actualización del método de pago de Paddle. Para eso la clave necesita transaction.write; sin él, el correo enlaza con tu propia página para actualizar la tarjeta.