Integración con Polar

Software de afiliados para Polar.sh, nativo hoy, no en una hoja de ruta.

Polar.sh es el Merchant of Record de código abierto hecho para desarrolladores (la empresa de pagos de polar.sh, no la marca de relojes), y Rekomi se integra con él de forma nativa: pegas un Organization Access Token y Rekomi lo valida, resuelve tu organización y crea el endpoint del webhook por su cuenta. A partir de ahí, los pedidos, las renovaciones de suscripción y los reembolsos suman y descuentan la comisión del afiliado correcto automáticamente, sin configurar nada en Polar.

Polar
nativa
Rekomi
Para desarrolladores que venden software, SaaS y productos digitales a través del checkout alojado de Polar.sh.
Todos los planes · desde $29/mes
Cómo funciona con Polar

Pega un token, marca el referido y deja que fluya order.paid.

01 / 03
Conecta pegando un token

Crea un Organization Access Token en Polar (Organization Settings > Developers) solo con los scopes organizations:read y webhooks:write y pégalo en Rekomi. Rekomi lo valida al momento, resuelve tu organización y crea el endpoint del webhook por su cuenta, suscrito exactamente a los eventos de pedido, suscripción y reembolso que necesita; Polar genera el secreto de firma y Rekomi lo guarda cifrado.

02 / 03
Marca rekomi_ref en los checkouts

Polar aloja el checkout, así que el referido viaja en los metadatos del pedido. Instala el script del head y luego pasa window.Rekomi.getReferral() como metadata.rekomi_ref en los checkouts creados por API; los enlaces de checkout normales de tus páginas se etiquetan con ?reference_id= automáticamente gracias al script, y Polar lo copia en el pedido.

03 / 03
Pedidos, renovaciones, reembolsos

order.paid es el único evento de dinero: las primeras compras se registran una vez y cada renovación acumula comisión recurrente, sobre el importe neto antes de impuestos. Los reembolsos, totales o parciales, se descuentan de forma proporcional por la misma vía de reembolso y en el mismo registro de auditoría.

Un solo token, verificado para siempre

Pega un token. Rekomi crea el webhook por su cuenta.

Toda la conexión depende de un único token que pegas. Rekomi lo valida, resuelve tu organización y crea el endpoint del webhook por su cuenta, suscrito exactamente a los siete eventos que necesita; al desconectar, el endpoint se elimina. Cada entrega se verifica contra el secreto de firma generado por Polar (firmas HMAC standard-webhooks con una ventana de repetición de 5 minutos) antes de procesar nada. Y como Polar desactiva los endpoints que fallan de forma repetida, la comprobación de estado de Rekomi detecta ese caso en concreto y te avisa por correo; al reconectar, el endpoint se crea de nuevo con un secreto nuevo y tu historial se conserva.

Conexión con un solo tokenFirmado · ventana de repetición de 5 min
tú pegas
polar_oat_… · validado
organización resuelta sola
Rekomi crea
endpoint de webhook · 7 eventos
se elimina al desconectar
order.paid+$29.00 recurrente · neto sin impuestos
refund.updated-$11.60 · anulación proporcional
subscription.uncanceledla comisión se reanuda
El impuesto del MoR nunca genera comisión.
Polar recauda y remite los impuestos como Merchant of Record; la comisión se calcula sobre el importe neto antes de impuestos, y los reembolsos se miden igual.
Los pedidos de prueba de $0 nunca generan comisiónReconoce el sandbox · errores claros
Qué incluye

Hecho para la forma en que Polar.sh vende de verdad.

Un solo evento de dinero

Las comisiones salen de order.paid: dinero que de verdad se movió. Los pedidos solo creados, las renovaciones pendientes y el pedido de $0 que genera una prueba al registrarse nunca generan comisión; un inicio de prueba atribuido se registra como lead de $0, y la comisión llega con el primer cobro real. A los afiliados se les paga por ingresos que llegaron, no por ingresos que podrían llegar.

Firmado y a prueba de repeticiones

Cada entrega se verifica contra el secreto de firma generado por Polar con firmas HMAC standard-webhooks y una ventana de repetición de 5 minutos; las entregas que no pasan la verificación se rechazan. Los scopes del token son solo de lectura y de webhooks, así que Rekomi nunca toca productos, precios ni pagos.

Comisiones netas antes de impuestos

Polar recauda los impuestos como Merchant of Record, y ese impuesto nunca fue ingreso tuyo, así que Rekomi nunca paga comisión sobre él. La comisión se calcula sobre el importe neto del pedido, tras descuentos y sin impuestos, y los reembolsos se miden también antes de impuestos, para que las anulaciones sean simétricas.

Anulación por cada reembolso

Totales o parciales, los reembolsos anulan la comisión de forma proporcional en el mismo registro de auditoría, y los reembolsos pendientes no se descuentan hasta que se completan. Polar no envía webhooks de disputas, así que un contracargo perdido es lo único que invalidas a mano.

Una conexión que se recupera

Polar desactiva los endpoints de webhook que fallan de forma repetida, y la comprobación de estado de Rekomi detecta ese caso en concreto; un token revocado se detecta igual. Recibes un correo, y al reconectar el endpoint se crea de nuevo con un secreto de firma nuevo, con el historial intacto.

Parte de un stack más grande

Stripe, Paddle, Braintree y más tienen integración nativa junto a Polar, y cualquier otra pasarela atribuye a través de la API S2S segura.

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, pagos a cargo de Rekomi y formularios fiscales recogidos · Precios completos

Preguntas frecuentes

Preguntas frecuentes sobre Polar.

¿La integración con Polar es nativa?

Sí, y se conecta pegando un solo token: pegas un Organization Access Token, y Rekomi lo valida, resuelve tu organización y crea el endpoint del webhook en el propio Polar, suscrito exactamente a los eventos que necesita. Al desconectar, el endpoint se elimina de nuevo. Los pedidos, las renovaciones de suscripción y los reembolsos se registran automáticamente, sin código intermedio que escribir ni configuración manual de webhooks en Polar.

¿Polar, como la marca de relojes?

No. Esta página trata de Polar.sh, el Merchant of Record de código abierto que usan los desarrolladores para vender software, SaaS y productos digitales: Polar aloja el checkout, cobra el pago y los impuestos y te remite el dinero. No tiene relación con Polar, la empresa de relojes deportivos. Si vendes con enlaces de checkout de polar.sh o con su API, esta es tu integración.

Casi ninguna plataforma de afiliados funciona con Polar. ¿Por qué Rekomi sí?

Polar es más nueva que las plataformas de facturación con las que crecieron la mayoría de herramientas de afiliados, y Polar, a propósito, no incluye un programa de afiliados propio; las integraciones de partners son su vía oficial. La mayoría de plataformas de afiliados consolidadas no la han añadido, así que quien compara software de afiliados para Polar encuentra una lista corta. Rekomi se integra con Polar de forma nativa hoy, y va más allá de marcar una casilla: la conexión crea y elimina el endpoint del webhook de forma programática, las comisiones salen de order.paid (dinero que de verdad se movió, no pedidos solo creados) y los reembolsos se descuentan uno a uno.

¿Cómo se acredita a los afiliados si Polar aloja el checkout?

El referido viaja en los metadatos del pedido. El script del head de Rekomi captura el clic del afiliado en una cookie de primera parte; los checkouts creados por API pasan window.Rekomi.getReferral() como metadata.rekomi_ref (la clave canónica), y el script etiqueta automáticamente los enlaces de checkout normales de Polar en tus páginas con ?reference_id=, que Polar copia en los metadatos del pedido. Los enlaces que construyes fuera de tu sitio (correos, documentación) pueden añadir reference_id con un snippet de una línea. Rekomi lee primero rekomi_ref, luego reference_id, y un reference_id que no coincide con ningún afiliado simplemente se ignora.

¿Por qué la comisión se calcula sobre el importe neto antes de impuestos?

Porque el impuesto no es ingreso tuyo. Polar es el Merchant of Record: recauda y remite el impuesto sobre las ventas y el IVA por su cuenta, así que la parte de impuestos de un cobro nunca te pertenece, y pagar comisión sobre ella pagaría de más a cada afiliado en cada venta en las jurisdicciones con impuestos. Rekomi calcula la comisión sobre el importe neto del pedido, tras descuentos y sin impuestos, y los reembolsos también se miden antes de impuestos, para que las anulaciones sean simétricas con la comisión original. Las pruebas generan un pedido de $0 al empezar, y ese pedido nunca genera comisión. Cuando el referido se atribuye, Rekomi lo registra como lead de $0, y la comisión llega con el primer cobro real.

¿Se gestionan las renovaciones, los reembolsos y los contracargos?

Las renovaciones y los reembolsos, sí. order.paid es el único evento de dinero: una primera compra registra una conversión única y cada renovación de suscripción registra una recurrente, así que la comisión recurrente sigue acumulándose durante toda la vida de la suscripción. Los reembolsos, totales o parciales, anulan la comisión de forma proporcional en el mismo registro de auditoría, y los reembolsos pendientes no se descuentan hasta que se completan. Una salvedad honesta: Polar no envía webhooks de disputas ni contracargos, así que una disputa perdida nunca llega sola a Rekomi; si ocurre, invalida la conversión a mano y la comisión se anula en el mismo registro de auditoría.

¿Y si el token se revoca o Polar desactiva el webhook?

Dos modos de fallo, ambos vigilados. Si el token se revoca, la comprobación de estado marca la conexión, muestra un aviso para reconectar y te avisa por correo; al pegar un token nuevo, se restaura con el historial intacto (elige "No expiration" al crear el token y nunca caduca por tiempo). Si Polar desactiva el endpoint tras fallos de entrega repetidos, la comprobación de estado detecta ese caso en concreto; vuelve a activarlo en Polar o simplemente reconecta, y el endpoint se crea de nuevo con un secreto de firma nuevo generado por Polar.

¿Reconoce el sandbox de Polar?

Sí, la conexión distingue entornos. El sandbox de Polar (sandbox.polar.sh) es un universo aparte con sus propias cuentas y tokens, y Rekomi mantiene los dos separados: un token de sandbox pegado donde se espera uno de producción se rechaza con un error claro en lugar de fallar el seguimiento en silencio, y la conexión registra de principio a fin a qué entorno pertenece.

¿Puedo usar Polar junto a otra conexión de facturación?

No; Rekomi impone una única fuente de verdad de conversiones por espacio de trabajo para que la misma venta nunca se registre dos veces. Elige una conexión para las ventas de Polar y mantenla; si de verdad vendes en dos plataformas, gestiónalas como espacios de trabajo separados.

Cuando tú quieras

Diez minutos hasta el primer clic.

Pega un token de acceso de Polar y tus ventas del checkout alojado empiezan a atribuirse a tus afiliados hoy. Prueba gratis de 14 días, sin tarjeta.

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