Skip to main content
La API actual se versiona con fechas. Los cambios incompatibles solo se publican dentro de una nueva versión fechada a la que decides adherirte. Fija una versión y las estructuras de solicitud y respuesta con las que construiste nunca cambiarán. Los SDK oficiales envían automáticamente la versión con la que se generaron.
Si no pasas un Api-Version-Date ni tienes una versión fijada almacenada en la clave de API, se usa el modelo de API estable. Las solicitudes sin ninguno de los dos se atienden con el comportamiento anterior al versionado, por lo que las integraciones existentes siguen funcionando sin cambios. Fija una versión fechada para adoptar la API más reciente.

Versiones fijadas en las claves de API

Las claves de API llevan su propia versión de API fijada. Las solicitudes autenticadas con una clave de API usan esa versión cuando omiten Api-Version-Date. Las claves existentes sin una versión almacenada usan 2025-01-01. Las claves recién creadas usan la última versión publicada. Un encabezado Api-Version-Date explícito siempre tiene prioridad sobre la versión fijada de la clave de API, por lo que puedes probar una actualización antes de cambiar la versión guardada. Todas las versiones reciben automáticamente los nuevos endpoints y campos opcionales. Los cambios incompatibles crean una nueva versión fechada, que se enumera en el registro de cambios a continuación. Al actualizar, revisa todas las entradas posteriores a tu versión fijada actual hasta tu versión de destino, no solo las entradas del mes de destino. En particular, actualizar de 2026-07-20 a septiembre atraviesa la migración de miembros y membresías de 2026-07-23.

Registro de cambios

Las versiones del SDK de TypeScript que se indican a continuación usan de forma predeterminada la versión de la API de esa entrada. Sobrescribir apiVersionDate cambia la versión de la respuesta, pero no los tipos del SDK.
Latest
Un nivel conserva solo su nivel y sus puntos
level en Obtener usuario y Obtener cuenta ahora tiene current, points, points_by_source y resets_at, además de account_level en una cuenta.Estos campos se eliminan de level: levels, points_to_next, monthly_qualifying_spend, monthly_card_spend, monthly_ads_spend y monthly_trading_volume. boosted se elimina del level de una cuenta. Una cuenta está impulsada cuando su account_level es inferior a current.
El `applied_level` de un nivel ahora es `current`
level.applied_level pasa a llamarse level.current en Obtener usuario y Obtener cuenta. El valor no cambia: el nivel que se aplica, de 0 a 10.
La lista de usuarios referidos deja de responder después del 17 de noviembre
GET /partners/referred_users deja de responder después del 17 de noviembre de 2026. A partir del 18 de noviembre, todas las versiones devuelven un 410. Hasta entonces, cada respuesta incluye los encabezados Deprecation y Sunset. La lista no tiene reemplazo.
Las solicitudes de atribución a un usuario han terminado
Los partners ya no pueden enviar una solicitud de atribución a un usuario. Esto se aplica a todas las versiones de la API, no solo a esta.Crear una solicitud de referencia de partner rechaza target_user_id, target_username y target_email con un 400 cuyo code es user_referral_requests_retired. Envía account_id o account_url para solicitar la atribución de un negocio. Las solicitudes que se enviaron a un usuario ya no se listan ni se obtienen, el filtro target_user_id en listar solicitudes de referencia de partner no devuelve solicitudes, y user en una solicitud siempre es null.
El nivel de un usuario es público
Obtener usuario devuelve level para cualquier usuario cuyas cuentas estén en Whop Levels, no solo para ti. level.applied_level es el nivel del usuario, de 0 a 10.Los demás campos de level, como points, points_by_source, los importes monthly_* y levels, son null a menos que te obtengas a ti mismo con el ID reservado me y tengas el permiso de lectura de saldo. Comprueba si son null antes de leerlos.
Lista y obtén tus propias compras
Con una credencial de usuario, user_id=me en listar pagos devuelve tus propios pagos. Eso incluye tus compras en todas las cuentas y tus pagos en las cuentas para las que vendes. Añade el account_id de una cuenta a la que compraste para listar solo esas compras. Obtener pago devuelve un pago que compraste.Una compra muestra lo que puedes ver como comprador. Los campos del lado de la cuenta, como amount_after_fees, usd_total, holds y metadata, son nulos o están vacíos en ella. amount_charged indica lo que se te cobró, incluidas las comisiones del comprador.
Los miembros del equipo incluyen su cuenta como un objeto
Los miembros del equipo ya no tienen un account_id de nivel superior. Lee el ID de la cuenta en account.id. El objeto account también tiene el title, la route y el logo_url de la cuenta.
La API de leads se retira
Los endpoints /leads están obsoletos y ya no aparecen en la referencia de la API. En esta versión y posteriores devuelven un 410. Las versiones anteriores siguen funcionando hasta el 20 de noviembre de 2026, con los encabezados Deprecation, Sunset y Link de sucesor. Después de esa fecha, todas las versiones devuelven un 410.Cada lead también es miembro de su negocio, con el ID del lead en el metadata del miembro como lead_id. Usa Listar miembros en lugar de listar leads. Añade un miembro por correo electrónico con Crear miembro. Lee o actualiza uno con Obtener miembro y Actualizar miembro.
La lista de usuarios referidos está obsoleta
GET /partners/referred_users está obsoleto y ya no aparece en la referencia de la API. Sigue respondiendo para las integraciones existentes, con un encabezado Deprecation en cada respuesta, y no tiene reemplazo.
Las facturas recurrentes incluyen la tarifa inicial
Crear una factura o reemplazar sus artículos cobra el initial_price más el renewal_price de una variante recurrente en la primera factura. Las facturas de renovación cobran solo el renewal_price. Editar otros campos conserva los precios guardados de la factura.Pagar la primera factura inicia inmediatamente un período de facturación pagado, sin la prueba de la variante. Un número finito de pagos incluye esa factura: una tarifa inicial de $75 con tres cuotas de $40 factura $115, luego $40 y luego $40.
La oferta renovable de Economic Intelligence es `3_days`
SDK de TypeScript: @whop/sdk@2.8.0.La oferta renovable en economic_intelligence_offers de Obtener preferencias de la cuenta ahora tiene la clave 3_days. Se renueva cada 3 días. Para activarla, envía economic_intelligence_duration_key: "3_days" a Actualizar preferencias de la cuenta. La clave weekly se rechaza.
Las estadísticas de anuncios ya no aceptan `clicks`
El campo clicks se elimina de Crear estadísticas de anuncios. Los clicks de una hora son las visitas a la página del anuncio registradas por el píxel de Whop, y un valor de clicks enviado en cualquier versión se ignora.
API de chat: canales, miembros y mensajes
Integra el chat en tu app. Los canales cubren mensajes directos, chats grupales, chats de comunidad y chats de soporte. Los miembros del canal añaden y eliminan personas. Los mensajes se pueden enviar, editar, fijar, recibir reacciones y votos./messages cambia de estructura a partir de esta versión. Un mensaje tiene channel_id y author en lugar de user, y edited y pinned en lugar de is_edited y is_pinned. Fija con POST /messages/{id}/pin y /unpin en lugar de una actualización. Eliminar mensaje devuelve 204. Reacciona y vota con POST /messages/{id}/react, /unreact y /vote.
El tipo de línea de libro mayor `bank_transfer` se retira
Los depósitos bancarios de Iron son líneas de actividad del libro mayor con line_type onchain_deposit, y su source.sender_address es iron. El filtro line_types de la actividad financiera y de los informes financieros ya no acepta bank_transfer.
Las listas de pagos salientes incluyen la Whop Card
Listar métodos de pago saliente guardados incluye la Whop Card de la cuenta. Listar pagos salientes incluye los pagos salientes que movieron fondos a ella. Un método de pago saliente guardado, y el payout_method de un pago saliente, tiene un type. external envía fondos fuera de Whop. whop_card mueve fondos a la propia Whop Card de la cuenta. Excluye los métodos whop_card de una lista en la que un usuario elige dónde retirar.
Una presentación de disputa en curso reporta `generating_response`
Una disputa cuya evidencia está con el procesador de pagos y aún no ha sido aceptada reporta generating_response en lugar de under_review. Cuando el procesador la acepta, la disputa pasa a under_review. Cuando el procesador la rechaza, la disputa vuelve a needs_response, y al obtenerla se devuelve submission_failure_reason. Ambos cambios se envían como dispute.updated.
Whop Levels: el nivel aplicado es `applied_level`
En el level de un usuario y de una cuenta, current ahora es applied_level, y se elimina processing_rate_percentage. Lee el porcentaje estándar de procesamiento con tarjeta de un nivel en su entrada de levels, y la tarifa propia de una cuenta en Obtener comisiones de la cuenta. El level de una cuenta también añade account_level, el nivel que alcanzan sus propios puntos.
Se eliminan las certificaciones de publicidad
Whop ya no ofrece certificaciones de publicidad. Obtener preferencias de la cuenta y Actualizar preferencias de la cuenta ya no devuelven ads_certifications, y una actualización ya no lo acepta.
Las cuentas conectadas ahora son subcuentas
Las cuentas hijas de la plataforma se llaman subcuentas. En Listar pagos y Listar disputas, y en sus endpoints de resumen, include_connected_accounts ahora es include_subaccounts. En Actualizar preferencias de la cuenta, covers_connected_account_negative_balances ahora es covers_subaccount_negative_balances tanto en la respuesta como en el cuerpo de la actualización. Las filas de informes financieros que usaban la agrupación connected_accounts ahora usan subaccounts.
Las solicitudes de pago saliente requieren una cotización
Crear un pago saliente ahora requiere quote_token. Primero llama a POST /payouts/quotes y luego envía su token con los mismos detalles del pago saliente antes de que caduque la cotización. Las cotizaciones ausentes o no válidas devuelven 400 con invalid_payout_quote. Al reintentar un pago saliente incierto, reenvía el token original y la Idempotency-Key para que el pago saliente existente pueda recuperarse incluso después de que caduque su cotización.
El cliente de una factura no puede cambiar después de crear el borrador
En Actualizar factura, un member_id que difiere del cliente actual del borrador devuelve un 400, incluido null. Para facturar a otra persona, primero anula el borrador. Después, crea una nueva factura. Un borrador guardado sin cliente todavía puede recibir uno.
Se eliminan las conexiones de Snapchat
Conectar una cuenta externa ya no acepta snapchat, la última plataforma que usaba el permiso advertise, por lo que su campo scopes también desaparece. Enviar snapchat o cualquier scopes devuelve un 400.
Las campañas publicitarias eliminan bid_type
Las campañas publicitarias ya no aceptan ni devuelven bid_type. Cada red publicitaria elige su propia puja de campaña, y desired_cost_per_result es tu objetivo en todas las redes: nunca cambia cómo pujan los anuncios. Enviar bid_type devuelve un 400.
Se eliminan las conexiones de publicidad
Los anuncios se publican bajo las propias páginas y perfiles de Whop, por lo que ya no conectas cuentas para publicidad. Conectar una cuenta externa ya no acepta meta_business, y tiktok ya no acepta el permiso advertise. Enviar cualquiera de ellos devuelve un 400.
Se eliminan las reglas de valor de conversión
Se eliminan las reglas de valor de conversión, y las redes publicitarias reciben el valor original de cada conversión. Listar las reglas de valor de conversión está obsoleto: devuelve una lista vacía, ya no está documentado y sus respuestas incluyen un encabezado Deprecation. Todos los demás endpoints de reglas de valor de conversión devuelven un 410.
Las audiencias eliminan las reglas de interacción, y los destinos de reglas eliminan platform
Las audiencias ya no se pueden crear a partir de la interacción en redes sociales. Las audiencias de interacción existentes siguen apareciendo con source_type engagement, pero ya no devuelven engagement. Enviar engagement, o engagement como source_type, a Crear audiencia devuelve un 400. Los destinos de las reglas de valor de conversión ya no aceptan ni devuelven platform. Cada destino cubre todas las redes en las que Whop lo ejecuta, y enviar platform en un destino devuelve un 400.
Los partners de cuentas externas están obsoletos
Los anuncios de colaboración ya no están disponibles. Listar los partners de una cuenta externa devuelve una lista vacía. Añadir o eliminar un partner devuelve un 400. Estos endpoints ya no están documentados, y sus respuestas incluyen un encabezado Deprecation.
Las duplicaciones eliminan preserve_engagement, y las listas de publicaciones y formularios de leads están obsoletas
Duplicar una campaña publicitaria, un grupo de anuncios o un anuncio ya no acepta preserve_engagement. Enviarlo a Duplicar una campaña publicitaria, Duplicar un grupo de anuncios o Duplicar un anuncio devuelve un 400. Listar las publicaciones o los formularios de leads de una cuenta externa está obsoleto: ambos devuelven una lista vacía, ya no están documentados y sus respuestas incluyen un encabezado Deprecation.
Los anuncios eliminan post_id, y la búsqueda de segmentación está obsoleta
Los anuncios ya no devuelven post_id. Buscar opciones de segmentación de grupos de anuncios y estimar el alcance de grupos de anuncios está obsoleto: ambos siguen funcionando, pero ya no están documentados y sus respuestas incluyen un encabezado Deprecation. Un destino de regla de valor de conversión puede omitir platform para cubrir todas las redes en las que Whop lo ejecuta.
Los anuncios eliminan los campos específicos de red y el objetivo de reconocimiento
Las campañas publicitarias, los grupos de anuncios y los anuncios ya no devuelven platform, y Crear una campaña publicitaria ya no lo acepta. Las nuevas campañas no pueden usar el objetivo awareness. Las campañas de reconocimiento existentes siguen devolviéndolo. Los anuncios ya no aceptan ni devuelven existing_post_id, post_source, external_accounts ni translations, y ya no devuelven post_thumbnail_url. Enviar un campo eliminado, o awareness como objetivo, a Crear una campaña publicitaria, Crear anuncio o Actualizar anuncio devuelve un 400.
Los anuncios eliminan los campos avanzados de entrega y de creatividades
Las campañas publicitarias ya no devuelven optimization_goal. Los grupos de anuncios ya no aceptan ni devuelven optimization_goal, conversion_location, message_apps, minimum_daily_spend, dynamic_creative, placements, frequency_cap ni detailed_targeting, y Whop establece la entrega a partir del objective de la campaña. Los anuncios ya no aceptan ni devuelven messaging_config, multi_advertiser_ads, lead_form, lead_form_id ni music. Enviar cualquiera de estos a Crear grupo de anuncios, Actualizar grupo de anuncios, Crear anuncio o Actualizar anuncio devuelve un 400 que nombra el campo.
Las listas de variantes de la cuenta excluyen las variantes de facturas heredadas
Listar variantes con account_id excluye las variantes generadas para una factura heredada, incluida una cuya factura se eliminó después. Para leer una, obtén la variante por ID. La lista obsoleta GET /plans se comporta de la misma manera.
Los swaps rechazan un importe superior al saldo de la billetera
En Crear swap, un amount decimal superior al saldo de from_token de la billetera devuelve un 400. El error indica el saldo disponible. Las versiones anteriores inician el swap, que luego falla en la cadena. La comprobación se omite cuando no se puede leer el saldo. USDT no se comprueba, ya que un swap de USDT también puede usar el saldo de la tarjeta.
Todos los demás recursos llaman variantes a las variantes
Membresías, miembros y entradas de lista de espera. En las membresías y las entradas de lista de espera, plan_id ahora es variant_id, y en la variante incrustada en una entrada de lista de espera, plan_type ahora es billing_type. Invitar a una membresía y Crear entrada de lista de espera aceptan variant_id, y Aprobar todas las entradas de lista de espera acepta y devuelve variant_id. Listar membresías filtra con variant_id y variant_ids, Listar miembros con variant_ids, y Listar entradas de lista de espera con variant_id, en lugar de plan_id y plan_ids.Pagos, facturas y disputas. En los pagos, las disputas y los casos del Resolution Center, plan_id ahora es variant_id, y en sus line_items, plan_id y plan_title ahora son variant_id y variant_title. En los line_items de cotizaciones de pago y facturas, plan_id ahora es variant_id. Listar pagos filtra con variant_ids en lugar de plan_ids. Crear pago y Crear cotización de pago aceptan variant_id y variant en lugar de plan_id y plan, en el cuerpo y en cada entrada de line_items. Crear y actualizar una factura aceptan variant_id y variant en lugar de plan_id y plan en cada entrada de items. Una variant en línea acepta billing_type en lugar de plan_type. En los eventos, related.plan ahora es related.variant.Checkout. En las configuraciones de checkout, plan ahora es variant, y su plan_type ahora es billing_type. Crear configuración de checkout acepta variant_id en lugar de plan_id y una variant en línea (con billing_type) en lugar de plan, y Listar configuraciones de checkout filtra con variant_id. Las solicitudes y respuestas de sesiones de checkout usan items[].variant en lugar de items[].plan.Códigos promocionales y partners. Listar códigos promocionales filtra con variant_ids en lugar de plan_ids, y Crear código promocional acepta variant_ids.
Los productos y las variantes llaman variantes a las variantes
En los productos, default_plan ahora es default_variant. En las variantes, y en las variantes incrustadas en un producto, plan_type ahora es billing_type. Crear variante acepta billing_type, y Listar variantes y Listar productos filtran con billing_types en lugar de plan_types.Usa /variants y el espacio de nombres variants del SDK en lugar de /plans. Los endpoints /plans siguen respondiendo en todas las versiones, con los encabezados Deprecation y Link de sucesor. Para previsualizar impuestos, crea una cotización de pago en lugar de llamar a POST /variants/{id}/calculate_tax o POST /plans/{id}/calculate_tax, que están obsoletos de la misma manera.Los ID de variante conservan el prefijo plan_, y los permisos plan:* y los nombres de eventos de webhook plan.* no cambian.
Las invitaciones devuelven el miembro del equipo pendiente
Cuando Crear miembro del equipo envía una invitación en lugar de añadir al miembro, la respuesta 202 ahora es el miembro del equipo pendiente. Su status es pending y su ID empieza por ausri_. La respuesta ya no incluye object ni invitation_sent.
Facturas respaldadas por recibos
La API nativa de facturas usa ID pay_ y items respaldados por variantes, incluida la creación de variantes en línea. Crear guarda un borrador. Puedes actualizar borradores y anular un borrador que ya no necesites. El cliente facturado es un miembro. Un correo electrónico que no pertenece a un usuario de Whop crea uno. recipient_emails son las direcciones de entrega propias de la factura, independientes del miembro facturado. La comisión del comprador es un porcentaje ajustable.
Las cuentas ya no incluyen stablecoin_rails
Las cuentas ya no incluyen stablecoin_rails.
Los tipos de documento de verificación están en minúsculas
En Crear verificación, y en los propietarios de owners, document_type acepta valores en minúsculas: passport, id_card, drivers o residence_permit. La guía de documentos de identidad indica cuáles acepta cada país.
El cargo con tarjeta del depósito se movió dentro de methods
En Crear depósito, el cargo a un método de pago guardado se movió del card de nivel superior a methods.card, junto a bank y crypto. Sus campos no cambian, y sigue siendo null a menos que se haya pasado payment_method_id. Quienes llaman con una versión anterior fijada conservan el card de nivel superior.
Los dominios de métodos de pago están obsoletos en favor de los dominios
Los endpoints de dominios de métodos de pago están obsoletos y ya no aparecen en la referencia de la API. Añade, comprueba y elimina dominios de Apple Pay con la capacidad apple_pay de la API de dominios:
  • GET /payment_method_domains: GET /domains con apple_pay=any, o apple_pay=ready para dominios verificados. Filtra por nombre de host con domain en lugar de hostname.
  • GET /payment_method_domains/{id}: GET /domains/{id}.
  • POST /payment_method_domains: POST /domains con domain, account_id y apple_pay: {}. Si la cuenta ya tiene el dominio, PATCH /domains/{id} con apple_pay: {}.
  • POST /payment_method_domains/{id}/verify: POST /domains/{id}/check.
  • DELETE /payment_method_domains/{id}: PATCH /domains/{id} con apple_pay: null. DELETE /domains/{id} elimina todo el dominio, incluido cualquier sitio web que tenga.
  • status: verified equivale a apple_pay.state: ready. status: pending equivale a apple_pay.state: pending mientras Whop registra el dominio, o a action_required hasta que alojes el archivo de asociación y compruebes el dominio.
El registro se ejecuta en segundo plano, por lo que crear o comprobar un dominio devuelve pending. Obtén el dominio hasta que apple_pay.state sea ready o action_required.Los endpoints /payment_method_domains siguen respondiendo en todas las versiones, con los encabezados Deprecation y Link de sucesor. Un dominio conserva su ID, por lo que /domains/{id} acepta el ID que devolvió un dominio de método de pago. La API de dominios necesita los permisos domain:read y domain:manage en lugar de company:manage_checkout.
Reseñas nativas
SDK de TypeScript: @whop/sdk@2.5.0.Las reseñas ahora usan un recurso nativo.
  • Listar y obtener reseñas devuelve solo las reseñas publicadas. Obtener una reseña pendiente o eliminada devuelve 404.
  • Una reseña obtenida devuelve account en lugar de company.
  • Listar reseñas filtra por account_id o product_id, ordena con order y direction, y devuelve 20 reseñas por página de forma predeterminada. Sin un filtro, un usuario lista las reseñas que escribió y una clave de API de cuenta o de app lista las reseñas de su cuenta.
  • company_id ya no se acepta. Usa account_id.
  • DELETE /reviews/{id} elimina una reseña que escribió el usuario que ha iniciado sesión y requiere el permiso review:delete.
Las cuentas ya no tienen grupo de industria, y la clasificación de la cuenta es de solo lectura
Las cuentas ya no incluyen industry_group, y PATCH /accounts/{id} ya no lo acepta. business_type e industry_type clasifican una cuenta.La clasificación de la cuenta es de solo lectura. Whop establece business_type e industry_type, y PATCH /accounts/{id} ya no los acepta.
Las apps ya no listan las URL alojadas anteriores
SDK de TypeScript: @whop/sdk@2.4.0.Las apps ya no incluyen previous_hosted_urls. Las direcciones de una app son los dominios que la sirven: lístalos con GET /domains, o lee domains en la app.
Perfiles, importes y tipos de creación de transferencias
Las transferencias devuelven perfiles origin y destination con name y logo_url. Los objetos monetarios amount y fee contienen el crédito del destinatario y todas las comisiones de transferencia. Las respuestas también incluyen las marcas de tiempo de fallo disponibles y una URL de seguimiento. Los importes históricos y tiempos de transición desconocidos son null.Sin filtros de cuenta, GET /transfers lista las transferencias de las cuentas permitidas del llamador y de su billetera personal. Las credenciales limitadas a una cuenta siguen restringidas a su cuenta.POST /transfers requiere type, ya sea balance o claim_link. Las solicitudes sin él devuelven 400. El tipo ledger pasa a llamarse balance, y se elimina wallet_send. Las versiones anteriores aceptan ledger y wallet_send, y crean una transferencia balance cuando se omite type.
Genera el PDF del recibo de un pago
Los pagos ya no incluyen pdf_url. Para obtener el recibo de un pago en PDF, llama a POST /payments/{id}/generate_pdf. Devuelve una url para descargar el archivo y el expires_at en el que ese enlace deja de funcionar.
Los fondos pendientes pueden estar a la espera de una revisión de cumplimiento
SDK de TypeScript: @whop/sdk@2.3.0.El payment_controls.undated_pending_reason de una cuenta puede ser compliance_review. Significa que una verificación que el comerciante ya envió está en revisión, por lo que los fondos pendientes siguen pendientes hasta que se resuelva. Quienes llaman con una versión anterior fijada ven null para este estado.
Economic Intelligence puede renovarse cada semana
economic_intelligence_offers incluye una oferta weekly que se renueva cada semana hasta que se desactiva. Cada oferta tiene auto_renew, y weekly es la oferta recomendada. Para activarla, envía economic_intelligence_duration_key: "weekly" a PATCH /accounts/{account_id}/preferences.economic_intelligence_offers lista solo lo que la cuenta puede elegir en este momento. Ya no es null mientras Economic Intelligence está activo: durante un período comprometido lista solo weekly, como mejora, y mientras weekly se está renovando está vacío. Las versiones anteriores mantienen null mientras Economic Intelligence está activo, omiten weekly y recomiendan 1_day.
Los pagos con tarjeta guardada consideran presente al comprador de forma predeterminada
Un cargo a un método de pago guardado (member_id y payment_method_id) con una return_url ahora considera que el comprador está presente. Esto se aplica cuando omites off_session. Si el emisor pide al comprador que se autentique, el pago queda en requires_action con una next_action. Cuando cobras la tarjeta sin el comprador, como una renovación según tu propio calendario, pasa off_session: true.
Los destinatarios de pago de facturas ya no necesitan cuentas de Whop
Crear un método de pago saliente con recipient crea una cuenta de pago saliente de destinatario no predeterminada vinculada al libro mayor del remitente. No crea ningún usuario de Whop, cuenta de Whop ni libro mayor del destinatario. La respuesta del destinatario contiene first_name, last_name y country. Ya no contiene user_id. Las versiones anteriores de la API omiten los datos del destinatario cuando no hay un usuario de Whop. Las versiones anteriores conservan el ID de usuario para los destinatarios existentes.
Las compilaciones de apps ya no aceptan un prompt de IA
Crear una compilación de app ya no acepta ai_prompt_id.
La serie temporal de una métrica tiene su propia ruta
Obtén la serie temporal de una métrica en GET /stats/time_series/{metric}. GET /stats/{metric} todavía la sirve e indica el sucesor en un encabezado Deprecation.
Las cuentas sociales son cuentas externas
Las cuentas sociales ahora son cuentas externas. Usa /external_accounts y el espacio de nombres externalAccounts del SDK. Los antiguos endpoints /social_accounts siguen respondiendo en todas las versiones, con los encabezados Deprecation y Link de sucesor. Los ID de cuentas externas conservan su prefijo sacc_, y los permisos social_account:* no cambian.Los anuncios llaman a sus cuentas external_accounts en lugar de social_accounts tanto en las solicitudes como en las respuestas. Las reglas de interacción de audiencias llaman a su cuenta external_account_id en lugar de social_account_id. En /external_accounts, la página propietaria de una cuenta de Instagram es parent_external_account en lugar de parent_social_account. Los webhooks de anuncios sin una versión de API fijada reciben external_accounts.
Los usuarios ya no incluyen cuentas sociales
Los usuarios ya no devuelven social_accounts.
Los setup intents se guardan en segundo plano
Crear un setup intent ahora lo devuelve como processing y guarda el método de pago en segundo plano. Crear un pago ya funciona así. Para conocer el resultado, consulta periódicamente el setup intent o pasa su client_secret a handleNextAction. Termina guardado, rechazado o a la espera de un paso del comprador. Las versiones anteriores siguen guardándolo durante la solicitud.
Las disputas prevenidas reportan prevented
SDK de TypeScript: @whop/sdk@2.1.0, @whop/sdk@2.2.0.Una disputa por la que se reembolsó al cliente antes de cualquier resolución ahora tiene status: prevented en lugar de closed. El reembolso provino de la red de tarjetas (Visa RDR) o de un reembolso anterior.
Las ejecuciones de Economic Intelligence tienen sus propios estados
Una recomendación que Whop AI está llevando a cabo tiene status: running. Cuando la ejecución termina pasa a executed, o a incomplete si terminó sin llevar a cabo la recomendación. Las versiones anteriores muestran una recomendación en ejecución como ready y una incompleta como superseded.Las recomendaciones también devuelven run_started_at, run_ended_at, run_by_user_id, result_url y acknowledged_at. Para ejecutar una recomendación tú mismo, envía status: running a PATCH /economic_intelligence/{id} y luego status: executed (con una result_url opcional) o status: incomplete. Envía status: acknowledged para marcar una ejecución completada como vista. La recomendación permanece en executed y registra acknowledged_at.
Las duraciones de Economic Intelligence se eligen por clave
Para activar Economic Intelligence, envía economic_intelligence_duration_key a PATCH /accounts/{account_id}/preferences en lugar de economic_intelligence_duration_days. Usa la key de una entrada de economic_intelligence_offers.Cada entrada de economic_intelligence_offers tiene key, duration y duration_unit en lugar de duration_days. Una duración se puede contar en hours o days.
El texto de los anuncios lleva etiqueta de idioma, y los anuncios de Meta pueden publicarse en otros idiomas
Los primary_texts, headlines y descriptions de un anuncio son arrays de objetos { language, text } en las solicitudes y respuestas. En un anuncio sin traducciones, omite language. La API rechaza cadenas simples, así que envía [{ "text": "…" }] en su lugar.Un anuncio de Meta también puede publicarse en otros idiomas. Establece translations: { source_language, automatic_languages } con el idioma del texto propio del anuncio y los idiomas a los que Meta traduce automáticamente. Cada entrada de texto y de creatives de ese anuncio indica entonces su language. El texto y la creatividad propios del anuncio usan source_language, y cada idioma que escribas tú mismo recibe una entrada de primary_texts y otra de headlines, además de entradas opcionales de descriptions y creatives. translations: null desactiva los demás idiomas.Las versiones anteriores de la API no pueden actualizar un anuncio que tenga traducciones. Reciben un 400 que indica esta versión.
Economic Intelligence se activa durante un período elegido
Para activar Economic Intelligence, envía economic_intelligence_duration_days a PATCH /accounts/{account_id}/preferences. Elige una duración de economic_intelligence_offers, que lista la tarifa de cada duración. Economic Intelligence no se puede cambiar ni desactivar hasta economic_intelligence_ends_at, y se desactiva automáticamente en ese momento.economic_intelligence es de solo lectura. Enviarlo devuelve un error 400.
El acceso al trading aparece en las comprobaciones de permisos
SDK de TypeScript: @whop/sdk@2.0.0.GET /permissions incluye crypto_wallet:trade y crypto_wallet:trade:read al listar o comprobar acciones de permisos para una cuenta.
Descripciones de operaciones de Economic Intelligence
Las recomendaciones de Economic Intelligence devuelven expected_tool_calls como un array ordenado de objetos con tool_name y description. Las descripciones identifican la acción planificada y el recurso afectado. Las recomendaciones más antiguas tienen una descripción null.
Los enlaces de referencia de partners usan un único tipo de solicitud
Las solicitudes de referencia de partners usan request_type: "link" para enlaces con o sin recompensas. Usa link al crear o filtrar enlaces. Solo el personal autorizado puede configurar recompensas.
Las recompensas de la cuenta muestran el progreso de las recompensas de partners
Obtener cuenta devuelve los hitos de recompensas de partners en rewards. Cada hito incluye el progreso de calificación y el estado del pago para esa cuenta. El campo contiene un array vacío cuando no hay recompensas coincidentes o cuando el llamador no tiene acceso de lectura al saldo o a las estadísticas.El formato heredado de recompensas de incorporación se retira. Las versiones anteriores de la API omiten rewards de las respuestas de cuenta.
Los setup intents pasan a ser un recurso nativo
La API nativa de pagos ahora sirve POST /setup_intents, GET /setup_intents y GET /setup_intents/{id}. El objeto Setup Intent adopta la estructura de todos los demás recursos nativos.
  • Los registros relacionados son ID de clave foránea en lugar de objetos incrustados: account_id (antes company), member_id (antes member), payment_method_id (antes payment_method) y checkout_configuration_id (antes checkout_configuration). El comprador es un resumen de user (id, username, name, profile_picture).
  • error_message pasa a last_setup_error, el mismo bloque { code, message } que devuelve Obtener estado de configuración. Permanece en null hasta que algo falla, y desaparece una vez que la configuración se completa correctamente.
  • return_url, payment_method_type y updated_at son nuevos. created_at y updated_at son marcas de tiempo ISO 8601.
  • payment_instrument, el método con formato de visualización que ya incluye el objeto Payment, también está en el Setup Intent, de modo que una tarjeta guardada se muestra sin una segunda solicitud. Su card añade exp_month y exp_year en ambos recursos. card.brand puede ser null: una tarjeta guardada cuya red no registró la bóveda conserva sus últimos cuatro dígitos y su vencimiento en lugar de perder todo el objeto card.
  • Crear un setup intent responde 201 Created (antes 200), respeta Idempotency-Key y requiere exactamente uno de confirmation_token o payment_method_id. Un token de confirmación de otra cuenta devuelve 404.
  • client_secret se devuelve al crear y al obtener, y solo para configuraciones creadas a través de esta API. Requiere un llamador que pueda actuar sobre la configuración: la credencial payment:charge de la cuenta o el propio token del comprador. Las filas de lista siempre incluyen null.
  • Los webhooks setup_intent.requires_action, setup_intent.succeeded y setup_intent.canceled fijados en esta versión o posterior entregan este mismo objeto Setup Intent como su data. Los webhooks fijados antes, y los webhooks sin versión fijada, conservan el payload anterior.
  • GET /setup_intents lista con el envoltorio estándar { data, page_info } y paginación por cursor. account_id es opcional: una clave de API de cuenta lista su propia cuenta, y un token de usuario lista todas las cuentas que puede leer. status es un nuevo filtro, y un valor no válido devuelve 400. created_before y created_after funcionan como antes.
Los reintentos de pago de anuncios usan el endpoint de cuenta
POST /ad_campaigns/{id}/retry_payment devuelve 410 Gone. Usa POST /accounts/{id}/retry_ads_payment con el ID biz_ de la cuenta para poner en cola un reintento de pago para todas sus campañas. Un reintento aceptado no confirma que el pago se haya realizado correctamente. Revisa el delivery_status y los issues de la campaña para conocer el resultado.
Tres políticas distintas de 3D Secure
SDK de TypeScript: @whop/sdk@1.1.5.Las cuentas, las variantes, las configuraciones de checkout y las sesiones de checkout exponen tres opciones de 3D Secure:
  • mandate_challenge solicita un desafío antes de procesar un pago con tarjeta compatible en sesión.
  • mandate_if_required exige un desafío solo cuando lo requiere el procesador de pagos.
  • frictionless_if_required usa el flujo 3DS sin fricción habitual.
Los pagos de $1,000 o más usan al menos mandate_if_required. Los requisitos de riesgo y de recuperación de autenticación pueden anular la preferencia. Los desafíos obligatorios explícitos se rechazan hasta que se habilitan en la plataforma.Las versiones anteriores de la API conservan sus valores existentes: las nuevas selecciones de mandate_challenge siguen siendo condicionales, las preferencias obligatorias existentes se conservan y frictionless sigue siendo frictionless. Las cuentas en versiones anteriores representan la opción sin fricción como null.
Las transferencias de trading tienen categorías propias en los informes financieros
Las filas de los informes financieros distinguen trading_account_deposit, trading_account_withdrawal y sus entradas _offset de otras transferencias en cadena. Los importes y saldos no cambian.Las versiones anteriores conservan las categorías existentes: topup para los depósitos de cuenta y onchain_withdrawal para los retiros de cuenta. Los informes globales usan las categorías correspondientes onchain_deposit, onchain_withdrawal y _offset. Las filas coincidentes se combinan sin perder los importes transferidos.
Estado de Triple Whale renombrado para comerciantes de marca blanca
ads_triple_whale_integration.status de las preferencias de la cuenta reporta requires_shop_domain en lugar de requires_shopify_store. Ahora se puede establecer un shop_domain explícitamente en la integración, por lo que una tienda de Shopify conectada ya no es la única forma de proporcionarlo.
Las categorías de negocio provienen de una única tabla
SDK de TypeScript: @whop/sdk@1.1.4.Los campos business_type, industry_group e industry_type de la cuenta son cadenas tomadas de la tabla de categorías de negocio de Whop en lugar de enums fijos. Las nuevas categorías aparecen sin una nueva versión de la API. El glosario de tipos de negocio e industrias lista los valores actuales.
  • coaching_and_courses ahora es education, physical_product ahora es ecommerce y marketplace ahora es platform.
  • Los grupos y tipos de industria se reorganizaron bajo los ocho tipos de negocio. PATCH /accounts/{id} solo acepta los slugs del glosario. Los valores desconocidos devuelven 400.
Quienes llaman con una versión anterior fijada siguen recibiendo los nombres de tipo de negocio anteriores, y los valores de industria que no existían antes de esta versión se devuelven como null.
Experimentos propiedad de la cuenta
Crear un experimento requiere un account_id propietario, con prefijo biz_. Los experimentos también aceptan referencias opcionales a recursos y claves de flags locales a la cuenta. Listar devuelve los experimentos de una cuenta, y leerlos o gestionarlos requiere permisos de cuenta. Los experimentos de cuenta no admiten etiquetas de equipo ni aprovisionan un proveedor de informes.La evaluación identifica al sujeto mediante subject[account_id], subject[anonymous_id] y subject[user_id]. Quienes llaman con versiones anteriores conservan sus parámetros de identidad de evaluación existentes. Pasa las properties de segmentación como un valor de consulta JSON. Las claves de consulta de propiedades anidadas existentes siguen siendo compatibles. La exposición acepta credenciales opcionales y registra su identidad en el evento.
Retenciones de retiro de Whop identificadas en los fondos pendientes
SDK de TypeScript: @whop/sdk@1.1.3.El payment_controls.undated_pending_reason de la cuenta puede ser withdrawals_disabled cuando Whop ha bloqueado los retiros, por lo que esos fondos pendientes no pueden pasar a estar disponibles.kyc_incomplete, pending_information_request y null para los fondos que aún se están liquidando no cambian.
Fuentes de audiencias por interacción
POST /audiences admite la interacción con videos, formularios de leads, perfiles de Instagram y páginas de Facebook mediante una definición tipada de engagement.
  • Los valores explícitos de source_type validan que los campos de origen requeridos estén presentes y que los campos de origen en conflicto estén ausentes.
  • Las respuestas de audiencias incluyen engagement, y source_type puede ser engagement. Las audiencias de interacción también se pueden usar como fuentes de audiencias similares.
  • GET /social_accounts/{id}/posts incluye video_id y caption para ayudar a seleccionar videos sin tener que buscar manualmente sus identificadores de plataforma.
Finalizar un experimento requiere conclusiones
POST /experiments/{id}/end requiere findings en el cuerpo de la solicitud: una breve explicación de lo que se aprendió y de por qué el experimento terminó como terminó.Quienes llaman con una versión anterior fijada aún pueden omitirlo. En lugar de un 400, se registra un valor de conclusiones provisional en su nombre.
Los destinos de depósito son un ID de cuenta
SDK de TypeScript: @whop/sdk@1.1.1, @whop/sdk@1.1.2.POST /deposits acepta una cadena de ID de cuenta destination (biz_… o user_…) y nada más.
  • Ya no se aceptan direcciones de billetera sin procesar. Financia una cuenta y lee sus direcciones en methods.crypto.
  • Se elimina la forma de objeto de destination ({ account_id } / { address, network }). Envía solo el ID de cuenta.
  • Se elimina la sobrescritura network de nivel superior. Nunca cambió la respuesta: cada depósito ya devuelve una dirección para cada red compatible, así que elige la que quieras en methods.crypto.
  • metadata se elimina tanto de la solicitud como de la respuesta. Se devolvía tal cual y nunca se almacenaba, por lo que no se podía usar para conciliar un depósito posterior.
  • account_id en la respuesta ya no es nulo, porque cada destino ahora indica una cuenta.
Quienes llaman con una versión anterior fijada siguen enviando la forma de objeto y las entradas eliminadas, y sus respuestas siguen incluyendo metadata, como un objeto vacío en lugar del valor que enviaron. Una dirección de billetera se rechaza en todas las versiones: nunca identificó una cuenta, por lo que no hay una estructura anterior que mantener. metadata enviado con un payment_method_id se conserva en todas las versiones, porque se adjunta al cargo con tarjeta.
Los pagos pasan a ser un recurso nativo
SDK de TypeScript: @whop/sdk@1.1.0.POST /payments, GET /payments y GET /payments/{id} ahora los sirve la API nativa de pagos, y el objeto Payment adopta la estructura de todos los demás recursos nativos.
  • Los registros relacionados son ID de clave foránea en lugar de objetos incrustados: account_id (antes company), plan_id, product_id, membership_id, member_id, promo_code_id, shipment_id, payment_method_id. El comprador es un resumen de user (id, username, name, profile_picture).
  • Los importes son objetos monetarios ({ amount, currency, decimals, display_decimals }) en lugar de números simples: total, subtotal, tax_amount, refunded_amount, tax_refunded_amount, amount_after_fees, usd_total. settlement_amount, settlement_currency y settlement_exchange_rate se integran en total y currency. refunded_amount y tax_refunded_amount se expresan tal como se liquidaron, al tipo vigente cuando se emitió cada reembolso, y tax_refunded_amount ahora aparece tanto en las respuestas de lista como en las de obtención.
  • Las disputas, los reembolsos y los casos del Resolution Center ya no están incrustados: lístalos desde sus propios endpoints con ?payment_id=. Las transacciones de financiación incrustadas y la comisión de aplicación no se trasladan a la estructura nativa.
  • last_payment_attempt / next_payment_attempt pasan a ser last_payment_attempt_at / next_payment_attempt_at. Los datos de la tarjeta están en payment_instrument.
  • Crear un pago acepta account_id (antes company_id), responde 201 Created, respeta Idempotency-Key y acepta capture: false para realizar una retención de autorización.
  • Las lecturas de pagos nativas están limitadas a la cuenta: la credencial debe poder leer los pagos de la cuenta (el token de un miembro del equipo o la clave de API de la cuenta). El token de usuario propio de un comprador, que las versiones proxy fijadas aceptan para leer su propio pago, todavía no se sirve de forma nativa; los compradores siguen funcionando en su versión fijada.
  • Las filas de GET /payments/{id}/fees son { type, origin, label, description, amount, settlement_amount, collected_at } con objetos monetarios (antes name/amount/currency/type).
  • GET /refunds y GET /refunds/{id} devuelven el Refund nativo: payment_id y account_id en lugar de un pago incrustado, amount como objeto monetario en la moneda de liquidación del pago y original_amount en la moneda del procesador. El filtro company_id pasa a ser account_id, y enviar company_id devuelve un 400.
  • POST /payments/{id}/refund, POST /payments/{id}/retry y POST /payments/{id}/void también son nativos y devuelven el mismo objeto Payment. El reembolso sigue aceptando un partial_amount opcional.
  • GET /payments lista con el envoltorio estándar { data, page_info } y paginación por cursor. Los filtros son parámetros de igualdad en singular (status, billing_reason, currency, plan_id, product_id, membership_id, member_id, user_id, account_id) en lugar de los arrays en plural del proxy. Al igual que en el proxy, billing_reason=subscription_cycle también coincide con las renovaciones registradas como subscription_update. Se incluyen los pagos de importe cero, por lo que desaparece el include_free del proxy. Un status no válido devuelve un 400, al igual que cualquier filtro exclusivo del proxy (substatuses, updated_before/updated_after, checkout_configuration_ids, arrays en plural), en lugar de una página sin filtrar. La búsqueda de compradores query funciona como antes. La ventana created_before/created_after cubre solo la hora de creación del pago. El proxy filtraba por la fecha de pago cuando existía. En las filas de lista, settlement_time_at es nulo; obtén el pago para consultarlo.
Se retira el endpoint heredado de informes de anuncios
El endpoint heredado GET /ad_reports está obsoleto en favor de las métricas nativas de Stats y los endpoints de entidades de anuncios. Ya no se sirve en esta versión.
  • GET /ad_reports devuelve 410 Gone con un error.type de gone. Usa GET /stats/time_series/ad_delivery para spend, impressions y clicks a lo largo del tiempo, limitado con una ruta source como whop:adcamp_xxx:*. Usa GET /stats/time_series/events para las conversiones atribuidas.
  • El rendimiento por entidad para una ventana está en los endpoints de entidades. GET /ad_campaigns, GET /ad_groups y GET /ads aceptan stats_from y stats_to y devuelven spend, results y return_on_ad_spend en cada fila.
  • Cada respuesta del endpoint heredado, en cualquier versión, ahora incluye los encabezados Deprecation y Link: <…/stats/ad_delivery>; rel="successor-version". Las solicitudes fijadas a versiones anteriores, y las solicitudes sin versión, siguen funcionando sin cambios hasta que un encabezado Sunset anuncie la fecha en que deja de responder para todas las versiones.
Rangos de marcas de tiempo en los informes financieros
GET /financial_reports y GET /financial_reports/breakdown ahora usan marcas de tiempo ISO 8601 from y to para las ventanas de los informes.
  • from_date y to_date pasan a llamarse from y to.
  • Ya no se aceptan fechas sin hora. Incluye una hora y un desplazamiento en ambas marcas de tiempo.
Filtrado explícito por verificación de apps
GET /apps ahora usa verified como filtro de igualdad opcional en lugar de tratar su ausencia como verified=false para las listas públicas de sitios web.
  • Omite verified para devolver plantillas de sitios web públicamente visibles de ambos estados de verificación.
  • Establece verified=true para plantillas verificadas por Whop o verified=false para plantillas de la comunidad.
  • recommended=true filtra las apps recomendadas independientemente del estado de verificación.
Se retiran los endpoints heredados de retiros
Los endpoints heredados /withdrawals están obsoletos en favor de la API nativa de pagos salientes y ya no se sirven en esta versión.
  • GET /withdrawals y POST /withdrawals devuelven 410 Gone con un error.type de gone. Usa GET /payouts y POST /payouts en su lugar. Los ID de pagos salientes son los mismos ID wdrl_, por lo que los identificadores existentes se siguen resolviendo.
  • GET /withdrawals/{id} sigue respondiendo en esta versión. Usa GET /payouts/{id} para el trabajo nuevo.
  • Cada respuesta de los endpoints heredados, en cualquier versión, ahora incluye los encabezados Deprecation y Link: <…/payouts>; rel="successor-version". Un encabezado Sunset anunciará la fecha en que dejarán de responder para todas las versiones. Hasta entonces, las solicitudes fijadas a versiones anteriores, y las solicitudes sin versión, siguen funcionando sin cambios.
ID de publicaciones de anuncios
El post_id de un anuncio ahora indica la publicación que sirve la red publicitaria, sin importar cómo se haya creado el anuncio.
  • post_id devuelve la publicación de la red para el anuncio: la que Meta creó para una creatividad subida, o la publicación que se promociona. Antes era null para todos los anuncios creados a partir de creatividades subidas.
  • La publicación a la que apuntas un anuncio se movió a existing_post_id, tanto en la respuesta como en el cuerpo de creación/actualización. post_source y post_thumbnail_url describen ese campo.
API nativa de archivos
SDK de TypeScript: @whop/sdk@1.0.14.POST /files y GET /files/{id} se sirven de forma nativa con un objeto de archivo rediseñado, y las subidas multiparte finalizan mediante el nuevo POST /files/{id}/complete.
  • Las respuestas de archivos incluyen el envoltorio estándar: object, visibility y un created_at ISO 8601. Los campos size y url son null hasta que la subida está en ready.
  • GET /files/{id} solo resuelve los archivos que creaste; otros llamadores reciben un 404.
Estado de pagos salientes v2
SDK de TypeScript: @whop/sdk@1.0.13.El vocabulario del ciclo de vida del objeto de pago saliente se reconstruye y sus campos monetarios pasan a ser cadenas decimales.
  • status usa ocho palabras: requested, in_review, processing, completed, reversed, canceled, failed, denied. Un pago saliente liquidado que el proveedor revierte muestra reversed, con el código de devolución y funds_returned_at en failure.
  • Un nuevo campo status_detail incluye la fase de máquina más detallada bajo la palabra de estado. Sus valores pueden crecer sin un cambio de versión; status es el contrato versionado.
  • amount, fee_amount, net_amount, markup_fee y destination_amount son cadenas decimales. exchange_rate sigue siendo un número.
  • Los pagos salientes se crean con su ID wdrl_: el ID que devuelve POST /payouts es el ID que lista GET /payouts, y la solicitud de conversión de un pago saliente se conserva como payout_request_id. Las solicitudes de conversión creadas antes de esta versión siguen respondiendo con su ID cofr_.
  • La clave de idempotencia se envía solo en el encabezado Idempotency-Key, y el campo idempotency_key del cuerpo se rechaza.
Las solicitudes fijadas a versiones anteriores conservan el vocabulario anterior, los importes en coma flotante y las claves de idempotencia en el cuerpo. Los payloads de webhooks siguen el api_version_date de la suscripción de la misma manera: las suscripciones fijadas en 2026-08-21 o posterior reciben la nueva estructura de pago saliente, y las suscripciones anteriores o sin versión fijada conservan la anterior.
account_id en el envoltorio de webhooks
El campo company_id del envoltorio de webhooks pasa a llamarse account_id.
  • Las entregas de webhooks fijadas en 2026-08-14 o posterior incluyen account_id en el envoltorio.
  • Los webhooks fijados a versiones anteriores, y los webhooks sin una versión api_version_date fijada, conservan company_id.
Desgloses del saldo en tránsito
SDK de TypeScript: @whop/sdk@1.0.11.Los desgloses de saldo de la cuenta y personales ahora exponen in_transit junto a pending.
  • Suma pending e in_transit para mostrar el importe total pendiente de liquidación.
  • Quienes llaman con versiones anteriores fijadas siguen recibiendo el importe combinado en pending.
Se elimina la entrada de versión de API de los webhooks
Se elimina la entrada api_version en POST /webhooks y PATCH /webhooks/{id}.
  • Los nuevos webhooks siempre usan los eventos y payloads v1. Las solicitudes que pasan api_version se rechazan con un 400.
  • Fija la estructura del payload de un webhook con api_version_date en su lugar.
  • Los webhooks v2 y v5 existentes siguen entregando. Ya no puedes crear webhooks ni cambiarlos a estas versiones.
Endpoints nativos de alertas de disputas
Las alertas de disputas ahora son un recurso REST nativo y siguen sirviéndose también a través del proxy heredado.
  • GET /dispute_alerts lista las alertas de una cuenta con paginación por cursor, y filtra por account_id, payment_id, type y una ventana de creación.
  • type reemplaza a alert_type e indica los dos tipos que envía un emisor: early_fraud_warning (informes de fraude Visa TC40 / Mastercard SAFE) y dispute_alert (avisos previos a la disputa).
  • fee_charged reemplaza a charge_for_alert e indica si Whop realmente cobró a la cuenta. Las advertencias tempranas de fraude nunca se cobran.
  • actionable indica si reembolsar el pago todavía puede evitar un contracargo.
  • Los objetos payment y dispute se reemplazan por las etiquetas payment_id y account_id. Las marcas de tiempo son ISO 8601, con reported_at para cuando el emisor presentó el informe.
Conversión de moneda fiduciaria en los swaps
Los swaps de pares fiduciarios (POST /swaps con dos monedas fiduciarias) ahora admiten la conversión de moneda libre, y amount coincide con la semántica de los swaps de criptomonedas.
  • amount es el importe de from_token que se convierte al tipo de mercado medio. No se requiere un saldo negativo.
  • El cálculo de un reembolso parcial de un saldo negativo de to_token se movió al nuevo campo to_amount (expresado en to_token, con un límite igual a la deuda). amount y to_amount son mutuamente excluyentes.
  • Omitir ambos sigue reembolsando el saldo negativo completo de to_token.
  • Quienes llaman con versiones anteriores fijadas conservan el comportamiento anterior: su amount fiduciario se trata como el importe de reembolso de to_token.
Requisitos de verificación planos
El requested_information de una verificación ahora es una lista plana: un requisito por entrada, una escritura por respuesta.
  • Cada entrada indica lo que se necesita en requirement: un documento como bank_statement, o una clave de campo como ssn, con una label para mostrar al usuario.
  • Responde a las entradas file con file (un ID de subida directa). Responde a las entradas text, date, phone y select con value, y a las entradas address con address. No se devuelve nada de la respuesta.
  • Una entrada marcada como multiple acepta varios archivos en una sola respuesta, en el orden de los espacios, con el anverso primero para un documento de dos caras.
  • Una entrada que lista options también acepta un value. Para las entradas select, las opciones son las respuestas permitidas. Para los documentos de identidad, las opciones son los tipos de identificación aceptados.
  • Las claves que no se aplican se omiten, y los envíos rechazados incluyen errors estructurados con un code estable y un reason.
  • La estructura de formulario anidada requested_files/category desaparece en esta versión. Quienes llaman con versiones anteriores fijadas la conservan, y sus respuestas se traducen automáticamente.
Endpoints nativos de códigos promocionales
Los códigos promocionales ahora son un recurso REST de nivel superior completo y siguen sirviéndose también a través del proxy heredado.
  • GET /promo_codes lista los códigos promocionales de una cuenta y usa account_id en lugar de company_id.
  • POST /promo_codes crea códigos promocionales. GET y DELETE /promo_codes/{id} los obtienen y archivan.
  • POST /promo_codes/{id}/activate y POST /promo_codes/{id}/deactivate reemplazan la escritura de estado heredada con PATCH.
  • Las respuestas de lista usan paginación por cursor y admiten filtros por estado, producto, variante, marca de tiempo y ordenación.
  • Quienes llaman con versiones anteriores fijadas conservan sin cambios el contrato del proxy heredado.
Cuentas principales más completas
Las respuestas de cuenta ahora exponen una relación más completa con la cuenta principal para las cuentas conectadas.
  • parent_account reemplaza a parent_account_id.
  • La cuenta principal incluye su id, title, route y logo_url.
Métodos de pago saliente compatibles
Los métodos de pago saliente compatibles ahora tienen su propio endpoint paginado.
  • GET /payouts/supported_methods lista los métodos de pago saliente que una cuenta o un usuario puede añadir.
  • Los métodos compatibles usan object: "supported_payout_method", y sus ID podst_ se pasan como supported_payout_method_id.
  • Los métodos de pago saliente guardados exponen supported_payout_method. Los pagos salientes exponen payout_method.supported_payout_method.
  • Usa country para listar los métodos compatibles de un país distinto al país de la cuenta de pago saliente.
  • GET /payouts/methods ya no acepta include_available ni devuelve available_destinations.
  • Quienes llaman con versiones anteriores fijadas conservan destination_id, payout_destination y payout_token.
Transacciones de tarjeta nativas, estimaciones de llegada de los métodos de pago saliente
Las transacciones de tarjeta ahora usan endpoints REST nativos y siguen sirviéndose también a través del proxy heredado.
  • GET /card_transactions lista las transacciones de tarjeta de una cuenta, y GET /card_transactions/{id} obtiene una por su ID citx_. La lista también acepta un filtro transaction_ids para obtener transacciones específicas en una sola solicitud.
  • Las transacciones de tarjeta están limitadas a la cuenta: el propietario se selecciona con account_id, que de forma predeterminada es la cuenta a la que pertenece la credencial.
  • Filtra por transaction_ids, card_id, cardholder_id, status, created_after y created_before. Los filtros de marca de tiempo son ISO 8601.
  • cardholder_id es nuevo en la respuesta: el usuario al que está asignada la tarjeta.
Los métodos de pago saliente ahora incluyen condiciones de comisión y entrega independientes del importe, y la cotización ya no duplica las estimaciones de llegada.
  • Cada método de pago saliente devuelve fee_structure (porcentaje, importe fijo y moneda) y estimated_arrival (marcas de tiempo por velocidad) sin requerir un amount.
  • Los objetos standard e instant de la cotización ya no incluyen estimated_arrival. Léelo en el campo estimated_arrival de nivel superior del método.
Endpoints nativos del Resolution Center
Los casos del Resolution Center ahora usan endpoints REST nativos y siguen sirviéndose también a través del proxy heredado.
  • status, escalated, outcome, refund, reason y available_actions exponen el estado del caso y las acciones permitidas.
  • Los eventos están disponibles en GET /resolution_center_cases/{id}/events, con paginación. Los resúmenes están disponibles en GET /resolution_center_cases/summary.
  • Las escrituras usan message y attachments. due_date pasa a llamarse response_due_at. Listar ya no requiere account_id.
Endpoints nativos de envíos
Los envíos ahora usan endpoints REST nativos y siguen sirviéndose también a través del proxy heredado.
  • GET /shipments lista los envíos. GET /shipments/{id} obtiene uno por ID de envío o ID de pago.
  • POST /shipments crea un envío, y PATCH /shipments/{id} actualiza su número de seguimiento.
  • Las respuestas usan account_id y tracking_number, junto con carrier, tracking_url, order_id y payment_id.
  • Quienes llaman con una versión fijada anterior a esta fecha conservan sin cambios el contrato del proxy heredado.
Endpoints nativos de disputas
Las disputas ahora usan endpoints REST nativos y siguen sirviéndose también a través del proxy heredado.
  • PATCH /disputes/{id} edita la evidencia, y POST /disputes/{id}/submit la envía. La evidencia está anidada bajo evidence.
  • GET /disputes/summary proporciona totales agrupados por status y currency. Listar y obtener devuelven los mismos campos.
  • Las respuestas usan account_id, product_id y plan_id, además de buyer junto a payment. Listar ya no requiere account_id.
  • status y reason son enums normalizados, y needs_response_by, rdr y editable se reemplazan por sus nuevos campos.
  • Quienes llaman con una versión fijada anterior a esta fecha conservan sin cambios el contrato del proxy heredado.
Miembros y membresías
Los miembros y las membresías ahora usan recursos nativos con un modelo de membresía orientado a la cuenta y acciones de ciclo de vida rediseñadas.
  • Las respuestas de membresía devuelven los campos de compatibilidad plan_id y product_id en lugar de los objetos de compatibilidad anidados plan y product.
  • Listar membresías devuelve todo lo que el llamador puede leer (las suyas más las de sus cuentas gestionadas), y account_id/user_id acotan esa lista en lugar de cambiar de modo o devolver un error.
  • Establece cancel_at_period_end para programar la cancelación. La acción cancel finaliza el acceso inmediatamente.
  • La acción extend reemplaza a add_free_days.
Coherencia de respuestas REST y marcas de tiempo
La API actual ahora usa respuestas de eliminación, entradas de marca de tiempo y nomenclatura de Account coherentes.
  • Los endpoints de eliminación de productos, variantes, configuraciones de checkout, anuncios, grupos de anuncios, campañas publicitarias, cuentas sociales y envíos de recompensas devuelven { id, deleted: true } en lugar de un booleano simple.
  • Los filtros de marca de tiempo de productos, variantes, configuraciones de checkout, transferencias e informes financieros aceptan solo ISO 8601 en lugar de aceptar también segundos epoch.
  • Las respuestas de productos devuelven account en lugar de company.
Porcentajes de pago de negocios partner
Los negocios partner ahora exponen tasas de pago independientes para cada fuente de ingresos.
  • payout_percentage se reemplaza por payout_percentages.
  • El objeto anidado incluye las tasas sales, ad_spend, transfer y card_interchange.
Productos y configuraciones de checkout
Los productos y las configuraciones de checkout ahora usan el modelo Account de forma coherente.
  • Los parámetros de solicitud de productos usan account_id en lugar de company_id.
  • Las solicitudes de configuración de checkout usan account_id en el nivel superior y dentro de los objetos de variante en línea incluidos en el campo de compatibilidad plan.
  • Las respuestas de configuración de checkout devuelven account_id en lugar de company_id.
Marcas de tiempo de las configuraciones de checkout
Las marcas de tiempo de las configuraciones de checkout ahora usan el mismo formato que el resto de la API.
  • created_at y updated_at son cadenas ISO 8601 en lugar de enteros epoch de Unix.
Saldos de usuario
Los saldos de usuario ahora proporcionan un resumen de saldo completo y estructurado.
  • Los campos planos total_usd y balances se reemplazan por un objeto balance anidado.
  • El resumen separa el efectivo, las criptomonedas, los depósitos de tesorería en curso y los saldos de las cuentas que posee el usuario.
Recursos de ganancias por referencias de negocios
Las ganancias por referencias de negocios ahora identifican el recurso polimórfico que generó la ganancia.
  • receipt se reemplaza por resource.
  • access_pass se reemplaza por product.
  • Las ganancias respaldadas por recibos devuelven resource.object: "receipt" con los detalles de pago del recibo.
  • El campo resource puede admitir recursos de ganancias adicionales en futuras versiones sin reutilizar campos específicos de recibos.
Recurso de referencias de negocios
El volumen y las ganancias por referencias de negocios ahora se reportan como grupos conciliables.
  • processing_volume, total_earnings, pending_payout y completed_payout se reemplazan por los objetos anidados volume_usd y earnings_usd.
  • Las ganancias cambian el nombre de base_amount/amount a transaction_amount_usd/commission_amount_usd y expresan payout_percentage como una fracción.
Recurso de variantes (entonces llamadas Plans)
Las variantes, que entonces se llamaban Plans, ahora usan el modelo Account de forma coherente.
  • Los parámetros y cuerpos de solicitud usan account_id en lugar de company_id.
  • Las respuestas de variantes devuelven account en lugar de company.
Recurso de usuarios
Las solicitudes de acceso de usuarios ahora usan el modelo Account de forma coherente.
  • Los parámetros y cuerpos de solicitud usan account_id en lugar de company_id.
  • Las estructuras de respuesta no cambian.
Versión original
El comportamiento original de la API actual antes de que existiera el versionado por fechas.Las solicitudes sin Api-Version-Date usan esta versión para que las integraciones existentes sigan funcionando.