Skip to main content
Los afiliados ganan comisiones por las ventas que refieren. El flujo de la API tiene dos partes: crear un registro de afiliado y, después, añadir anulaciones (overrides) que definen la comisión.

Cómo funciona la atribución

  1. Creas un registro de afiliado para un usuario y luego añades anulaciones. Cada anulación devuelve los campos product_direct_link y checkout_direct_link. Son URL de referido que comparte el afiliado (incluyen ?a=<username>).
  2. Un comprador usa el enlace. Whop guarda la cookie del afiliado (ventana de atribución de 30 días por defecto).
  3. El comprador paga dentro de la ventana. La anulación correspondiente calcula la comisión: standard (por variante, porcentaje o tarifa fija) o rev_share (porcentaje de los ingresos, para un producto concreto o para toda la cuenta).
  4. Whop atribuye la comisión al afiliado y la refleja en el campo total_referral_earnings_usd de 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)

Reglas de 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 pases commission_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 campo total_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.