Integración con Paddle

Software de afiliados para Paddle, hecho para cobrar con un Merchant of Record.

Paddle es tu Merchant of Record, así que el checkout, la factura y el reembolso ocurren del lado de Paddle. Rekomi se conecta como el software de seguimiento de comisiones que hay detrás: apunta un destino de notificaciones de Paddle a tu URL única de Rekomi, pega el secreto de firma y cada transacción completada que lleve el rekomi_ref de tu afiliado queda verificada y acreditada. Sin relé de backend que construir.

Paddle
nativa
Rekomi
Para SaaS y productos digitales que cobran con el checkout alojado o superpuesto de Paddle Billing.
Todos los planes · desde $29/mes
Cómo funciona con Paddle

Un destino de webhooks, un secreto de firma y una clave en customData.

01 / 03
Apunta un destino a Rekomi

Copia la URL de webhook única de tu espacio de trabajo en Rekomi, crea con ella un destino de notificaciones en Paddle, activa los eventos de transacción, suscripción y ajuste, y pega el secreto de firma del destino de vuelta en Rekomi.

02 / 03
Lleva la referencia al checkout

Instala el script de cabecera para que el clic quede capturado antes de que el comprador abra Paddle Checkout, y luego adjunta window.Rekomi.getReferral() a customData bajo rekomi_ref. Paddle lo guarda en la transacción y lo repite en cada webhook.

03 / 03
Verificado, registrado, revertido

transaction.completed anota la venta al afiliado correcto; adjustment.created y adjustment.updated revierten la comisión de forma proporcional en reembolsos y contracargos. Los importes llegan como unidades menores enteras y se leen tal cual.

A través del muro del MoR

La referencia viaja dentro de la propia transacción.

Un Merchant of Record aloja el checkout en su propio dominio, y ahí es donde la mayoría de herramientas de afiliados pierden el hilo. Rekomi pasa la referencia por el campo customData de Paddle, así que sobrevive al salto de dominio, aterriza en la transacción y vuelve en cada webhook, incluidas cada renovación y cada ajuste. La atribución y la reversión funcionan sobre datos que el propio Paddle firmó.

Destino de notificaciones de Paddleverificado con secreto
checkout alojado
customData.rekomi_ref
= "mira-builds"
evento
transaction.completed
+$49.00 · @mira-builds
reembolso o contracargo
adjustment.created / adjustment.updated
-$49.00 revertido
importes
unidades menores enteras, leídas tal cual
renovaciones
el mismo rekomi_ref, en cada ciclo
Secreto de firma · pdl_ntfset_…Guardado cifrado · nunca se vuelve a mostrar
Qué incluye

Hecho para cómo se comporta de verdad un Merchant of Record.

Sin servicio de relé, nunca

Rekomi aloja el endpoint del webhook y verifica cada evento contra el secreto de firma de tu destino, guardado cifrado. Nada corre en tu infraestructura y nada te despierta a las 3 de la mañana.

Reversiones guiadas por ajustes

Los reembolsos y los contracargos llegan como ajustes de Paddle, y ambos revierten la comisión de forma proporcional en cuanto aterrizan. Los reembolsos parciales se revierten parcialmente, en el mismo registro de auditoría.

Sonda de salud opcional

Pega una clave de API de Paddle de solo lectura y Rekomi confirma de forma activa que la conexión está sana. El seguimiento funciona solo con el secreto de firma; la sonda añade tranquilidad.

Divisas bien gestionadas

Paddle envía los totales como cadenas de unidades menores enteras en la divisa del pedido, y Rekomi las lee tal cual. Los informes multidivisa lo consolidan todo sin que toques una hoja de cálculo.

Los pagos siguen hechos por ti

Cobrar con Paddle no cambia nada en los pagos a afiliados: se dan de alta con Stripe Express, Stripe se encarga del KYC, Rekomi ejecuta el pago y el papeleo fiscal se resuelve a fin de año.

Parte de un stack más grande

Stripe, Braintree y más son nativas junto a Paddle, y cualquier otra pasarela puede acreditar a los afiliados a través de la API servidor a servidor firmada. Cambia de facturación más adelante sin reconstruir el programa.

Todas las integraciones
Precios

Planes fijos más un 3% sobre los pagos. Sin comisión sobre tus ingresos.

Prueba gratis de 14 días en todos los planes · 3% sobre los pagos a afiliados, con los pagos hechos y los formularios fiscales recogidos por ti · Precios completos

Preguntas frecuentes

Preguntas frecuentes sobre Paddle.

¿Necesito escribir código de backend para conectar Paddle?

No. Rekomi te da una URL de webhook única para tu espacio de trabajo; creas un destino de notificaciones en Paddle que apunte a ella, activas los eventos de transacción, suscripción y ajuste, y pegas el secreto de firma del destino de vuelta en Rekomi. Rekomi aloja el endpoint, verifica cada evento contra ese secreto y registra la conversión. No hay ningún servicio de relé que construir ni mantener.

Paddle aloja mi checkout. ¿Cómo se acredita al afiliado?

La referencia viaja dentro de la propia transacción. El script de cabecera de Rekomi captura el clic del afiliado en una cookie de origen propio en tu web; cuando abres Paddle Checkout, adjuntas window.Rekomi.getReferral() a customData bajo la clave rekomi_ref. Paddle lo guarda en la transacción y lo incluye en cada webhook de ese pedido, que es donde Rekomi identifica al afiliado.

¿Pueden los afiliados usar códigos de cupón para la atribución en Paddle?

No. La atribución por código de cupón por afiliado es una función específica de Stripe construida sobre los códigos de promoción de Stripe; no hay equivalente para Paddle en Rekomi. En Paddle, la atribución se basa por completo en el valor rekomi_ref de customData, que el script de cabecera más una línea de marcado resuelven en cada checkout. Los afiliados comparten enlaces rastreados como siempre.

¿Puedo tener el seguimiento de Paddle y el de Stripe a la vez?

No; Rekomi impone una única fuente de facturación por espacio de trabajo para que la misma venta nunca se cuente dos veces. Si tienes Stripe Connect vinculado, desconéctalo antes de conectar Paddle (y viceversa). Si de verdad cobras en dos plataformas, gestiónalas como espacios de trabajo separados.

¿Qué pasa con los reembolsos y los contracargos?

Paddle informa de ambos como ajustes. Cuando llega adjustment.created o adjustment.updated con un reembolso o un contracargo, Rekomi revierte la comisión de forma proporcional y actualiza el saldo pendiente del afiliado, sin configuración extra ni contabilidad manual.

¿Los ingresos recurrentes de suscripción siguen pagando comisión?

Sí. Cada transacción completada de Paddle para la suscripción lleva el customData del pedido original, así que cada renovación se acredita al mismo afiliado según las condiciones de participación recurrente de tu campaña. Las cancelaciones de suscripción detienen el reloj automáticamente.

¿Es para Paddle Billing o para Paddle Classic?

La integración nativa está pensada para el Paddle Billing moderno (destinos de notificaciones, eventos de transacción y de ajuste). Si todavía estás en Paddle Classic, la API firmada servidor a servidor puede enviar las conversiones desde tu backend hasta que migres.

Cuando tú quieras

Diez minutos hasta el primer clic.

Apunta un destino de notificaciones de Paddle a Rekomi y las ventas de tu Merchant of Record empiezan a acreditar a tus afiliados hoy mismo. Prueba gratis de 14 días, sin tarjeta.

  • Prueba gratis de 14 días
  • Cancela cuando quieras, $0 cobrados