Cómo funciona la atribución
- Creas un registro de afiliado para un usuario y luego añades anulaciones. Cada anulación devuelve los campos
product_direct_linkycheckout_direct_link. Son URL de referido que comparte el afiliado (incluyen?a=<username>). - Un comprador usa el enlace. Whop guarda la cookie del afiliado (ventana de atribución de 30 días por defecto).
- El comprador paga dentro de la ventana. La anulación correspondiente calcula la comisión:
standard(por variante, porcentaje o tarifa fija) orev_share(porcentaje de los ingresos, para un producto concreto o para toda la cuenta). - Whop atribuye la comisión al afiliado y la refleja en el campo
total_referral_earnings_usdde la anulación.
Los reembolsos revierten las comisiones. Si un comprador obtiene un reembolso dentro de la ventana, la ganancia del afiliado en esa venta se recupera automáticamente.
Los afiliados necesitan una cuenta de Whop para recibir pagos. Las ganancias se acumulan en el registro. Los pagos van a su saldo de cuenta mediante transferencias. Si todavía no tienen una cuenta, dalos de alta con la inscripción de subcuentas.
Crear un afiliado
user_identifier se resuelve de forma flexible. Pasa un nombre de usuario, un correo electrónico, un ID de usuario o un ID de Discord. Si ya existe un registro de afiliado para el par de cuenta y usuario, Whop devuelve el registro existente (idempotente).
Añadir anulaciones de comisión
Un registro de afiliado no define una comisión por sí solo. Añade anulaciones para decidir cuánto se le paga al afiliado.Estándar (por variante)
commission_value:
"percentage": número entero de 1 a 100 (40= 40 %)."flat_fee": importe en dólares (10= 10 $).
applies_to_payments:
"first_payment": el afiliado solo gana con la compra inicial."all_payments": el afiliado también gana con cada pago recurrente.
Reparto de ingresos (porcentaje de los ingresos)
Las anulaciones de reparto de ingresos siempre se basan en un porcentaje. No pasescommission_type: "flat_fee".
Gestionar anulaciones
Gestionar afiliados
Configuración de afiliados a nivel de cuenta
Tres campos de la cuenta controlan cómo presenta Whop el programa de afiliados a los usuarios. Actualízalos a través del recurso Account.Seguimiento de ganancias
Cada anulación incluye un campototal_referral_earnings_usd que refleja las ganancias acumuladas (en dólares estadounidenses) de esa anulación concreta. Vuelve a obtener la anulación (o lista las anulaciones de un afiliado) para conseguir el total actual.
No hay ningún webhook
affiliate.* dedicado en v1, y el esquema público de payment no expone la vinculación con afiliados. Consulta periódicamente affiliates.overrides.list según tu calendario de pagos y compara los últimos valores de total_referral_earnings_usd con los últimos valores que guardaste.Campos de respuesta de una anulación
Próximos pasos
Pagar las ganancias de afiliados
Transfiere las comisiones acumuladas desde tu saldo a las cuentas de los afiliados.
Aceptar pagos
Las configuraciones de checkout atribuyen las ventas automáticamente cuando hay cookies de referido.
Escuchar webhooks
Usa
payment.succeeded para la telemetría general de ventas. La atribución de afiliados sigue requiriendo consultas periódicas.Referencia de la API de afiliados
Recurso completo. Endpoints, campos y esquemas de anulaciones.

