Qué puedes crear
- Un programa de referidos que gestionas tú mismo, compartiendo tu propio enlace con tu propia audiencia.
- Informes sobre lo que has referido: qué negocios y usuarios siguen activos y qué genera cada uno.
- Extractos de ganancias desglosados hasta la transacción y la tasa que hay detrás de cada línea.
- Una página pública de clasificación a partir de la clasificación de partners.
Objetos principales
Partner, negocio referido, ganancia de partner. Cada uno se define en Conceptos principales.Inscripción
POST /partners inscribe al usuario que hace la llamada y hace que sus negocios de partner puedan generar ganancias. Devuelve referral_link, la URL que compartes para que se te atribuyan los referidos, y whop_partner_enabled_at. Volver a inscribirse conserva la fecha de inscripción original en lugar de restablecerla, lo que hace que la llamada sea segura de repetir.
Requiere el permiso partner:create. Consultar referidos y ganancias requiere partner:basic:read, y listar negocios referidos también acepta referral:basic:read. Consulta Permisos.
Por qué ganas
payout_percentages en un negocio referido indica tu tasa por fuente de ingresos como fracción, así que 0.3 significa 30 %. Tres de las cuatro son una parte del beneficio bruto de Whop. El gasto en publicidad es la excepción: es una parte del propio gasto.
En un negocio cerrado para un negocio de partner, esa tasa pertenece al equipo.
GET /partners/businesses/:id también devuelve my_payout_percentages, tu propia parte de cada tasa. Es la tasa completa cuando referiste el negocio tú mismo. En un acuerdo de un negocio de partner, es tu parte de equipo de la tasa. Un responsable gana su parte menos la parte de la persona que tiene por debajo, y un participante del acuerdo gana su parte. Es null cuando no ganas nada con el negocio.
GET /partners/businesses lista todo lo que has referido, del más reciente al más antiguo. Cada negocio de partner incluye un ID coma_, un status de active o removed, y referral_started_at y referral_expires_at.
earnings_usd y volume_usd son objetos, no números individuales. earnings_usd se desglosa en completed, pending y total. volume_usd se desglosa en attributed, awaiting_settlement y settled.
Consultar las ganancias
GET /partners/businesses/{id}/earnings desglosa lo que Whop te paga por un negocio. Cada ganancia indica su income_source, el transaction_amount_usd del que procede y tu payout_percentage.
Las ganancias se liquidan antes de pagarse. Tanto commission_amount_usd como payout_percentage son null hasta entonces.
Cuando existen los datos,
financial_activity desglosa las líneas de ingresos y costes que hay detrás de la comisión. Es null para las ganancias que se liquidaron antes de que Whop registrara ese detalle.
La clasificación
GET /partners/leaderboard clasifica a los referidores según sus ganancias de partner. El parámetro period acepta day, month, year, last_30_days o all_time, y su valor predeterminado es all_time.
La autenticación es opcional. Quienes llaman de forma anónima obtienen la clasificación en leaders, y quienes están autenticados también obtienen su propia posición en me, que es null cuando aún no tienes ganancias por referidos.
Próximos pasos
Inscribirse como partner
Una sola llamada para unirte y obtener tu enlace de referido.
Listar tus referidos
Todos los negocios que has incorporado, con sus ganancias.
Afiliados
Seguimiento de referidos dentro de tus propios productos.
Referencia de Partners
Todos los endpoints de partners, con un playground.

