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 omitenApi-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. SobrescribirapiVersionDate cambia la versión de la respuesta, pero no los tipos del SDK.
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.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.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.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.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.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 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.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.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.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.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.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.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.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.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 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.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.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 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.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.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.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 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.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, 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 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 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 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.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.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.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.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.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.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.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.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.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.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 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 /domainsconapple_pay=any, oapple_pay=readypara dominios verificados. Filtra por nombre de host condomainen lugar dehostname.GET /payment_method_domains/{id}:GET /domains/{id}.POST /payment_method_domains:POST /domainscondomain,account_idyapple_pay: {}. Si la cuenta ya tiene el dominio,PATCH /domains/{id}conapple_pay: {}.POST /payment_method_domains/{id}/verify:POST /domains/{id}/check.DELETE /payment_method_domains/{id}:PATCH /domains/{id}conapple_pay: null.DELETE /domains/{id}elimina todo el dominio, incluido cualquier sitio web que tenga.status: verifiedequivale aapple_pay.state: ready.status: pendingequivale aapple_pay.state: pendingmientras Whop registra el dominio, o aaction_requiredhasta que alojes el archivo de asociación y compruebes el dominio.
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.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
accounten lugar decompany. - Listar reseñas filtra por
account_idoproduct_id, ordena conorderydirection, 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_idya no se acepta. Usaaccount_id.DELETE /reviews/{id}elimina una reseña que escribió el usuario que ha iniciado sesión y requiere el permisoreview:delete.
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.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.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.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.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_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.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.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.Crear una compilación de app ya no acepta
ai_prompt_id.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 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.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.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.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.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.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.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.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.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.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.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(antescompany),member_id(antesmember),payment_method_id(antespayment_method) ycheckout_configuration_id(antescheckout_configuration). El comprador es un resumen deuser(id,username,name,profile_picture). error_messagepasa alast_setup_error, el mismo bloque{ code, message }que devuelve Obtener estado de configuración. Permanece ennullhasta que algo falla, y desaparece una vez que la configuración se completa correctamente.return_url,payment_method_typeyupdated_atson nuevos.created_atyupdated_atson 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. Sucardañadeexp_monthyexp_yearen ambos recursos.card.brandpuede sernull: 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 objetocard.- Crear un setup intent responde
201 Created(antes200), respetaIdempotency-Keyy requiere exactamente uno deconfirmation_tokenopayment_method_id. Un token de confirmación de otra cuenta devuelve404. client_secretse 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 credencialpayment:chargede la cuenta o el propio token del comprador. Las filas de lista siempre incluyennull.- Los webhooks
setup_intent.requires_action,setup_intent.succeededysetup_intent.canceledfijados en esta versión o posterior entregan este mismo objeto Setup Intent como sudata. Los webhooks fijados antes, y los webhooks sin versión fijada, conservan el payload anterior. GET /setup_intentslista con el envoltorio estándar{ data, page_info }y paginación por cursor.account_ides opcional: una clave de API de cuenta lista su propia cuenta, y un token de usuario lista todas las cuentas que puede leer.statuses un nuevo filtro, y un valor no válido devuelve400.created_beforeycreated_afterfuncionan como antes.
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.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_challengesolicita un desafío antes de procesar un pago con tarjeta compatible en sesión.mandate_if_requiredexige un desafío solo cuando lo requiere el procesador de pagos.frictionless_if_requiredusa el flujo 3DS sin fricción habitual.
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 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.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.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_coursesahora eseducation,physical_productahora esecommerceymarketplaceahora esplatform.- 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 devuelven400.
null.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.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.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_typevalidan 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, ysource_typepuede serengagement. Las audiencias de interacción también se pueden usar como fuentes de audiencias similares. GET /social_accounts/{id}/postsincluyevideo_idycaptionpara ayudar a seleccionar videos sin tener que buscar manualmente sus identificadores de plataforma.
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.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
networkde nivel superior. Nunca cambió la respuesta: cada depósito ya devuelve una dirección para cada red compatible, así que elige la que quieras enmethods.crypto. metadatase 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_iden la respuesta ya no es nulo, porque cada destino ahora indica una cuenta.
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.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(antescompany),plan_id,product_id,membership_id,member_id,promo_code_id,shipment_id,payment_method_id. El comprador es un resumen deuser(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_currencyysettlement_exchange_ratese integran entotalycurrency.refunded_amountytax_refunded_amountse expresan tal como se liquidaron, al tipo vigente cuando se emitió cada reembolso, ytax_refunded_amountahora 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_attemptpasan a serlast_payment_attempt_at/next_payment_attempt_at. Los datos de la tarjeta están enpayment_instrument.- Crear un pago acepta
account_id(antescompany_id), responde201 Created, respetaIdempotency-Keyy aceptacapture: falsepara 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}/feesson{ type, origin, label, description, amount, settlement_amount, collected_at }con objetos monetarios (antesname/amount/currency/type). GET /refundsyGET /refunds/{id}devuelven el Refund nativo:payment_idyaccount_iden lugar de un pago incrustado,amountcomo objeto monetario en la moneda de liquidación del pago yoriginal_amounten la moneda del procesador. El filtrocompany_idpasa a seraccount_id, y enviarcompany_iddevuelve un 400.POST /payments/{id}/refund,POST /payments/{id}/retryyPOST /payments/{id}/voidtambién son nativos y devuelven el mismo objeto Payment. El reembolso sigue aceptando unpartial_amountopcional.GET /paymentslista 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_cycletambién coincide con las renovaciones registradas comosubscription_update. Se incluyen los pagos de importe cero, por lo que desaparece elinclude_freedel proxy. Unstatusno válido devuelve un400, 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 compradoresqueryfunciona como antes. La ventanacreated_before/created_aftercubre 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_ates nulo; obtén el pago para consultarlo.
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_reportsdevuelve410 Gonecon unerror.typedegone. UsaGET /stats/time_series/ad_deliveryparaspend,impressionsyclicksa lo largo del tiempo, limitado con una rutasourcecomowhop:adcamp_xxx:*. UsaGET /stats/time_series/eventspara las conversiones atribuidas.- El rendimiento por entidad para una ventana está en los endpoints de entidades.
GET /ad_campaigns,GET /ad_groupsyGET /adsaceptanstats_fromystats_toy devuelvenspend,resultsyreturn_on_ad_spenden cada fila. - Cada respuesta del endpoint heredado, en cualquier versión, ahora incluye los encabezados
DeprecationyLink: <…/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 encabezadoSunsetanuncie la fecha en que deja de responder para todas las versiones.
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_dateyto_datepasan a llamarsefromyto.- Ya no se aceptan fechas sin hora. Incluye una hora y un desplazamiento en ambas marcas de tiempo.
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
verifiedpara devolver plantillas de sitios web públicamente visibles de ambos estados de verificación. - Establece
verified=truepara plantillas verificadas por Whop overified=falsepara plantillas de la comunidad. recommended=truefiltra las apps recomendadas independientemente del estado de verificación.
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 /withdrawalsyPOST /withdrawalsdevuelven410 Gonecon unerror.typedegone. UsaGET /payoutsyPOST /payoutsen su lugar. Los ID de pagos salientes son los mismos IDwdrl_, por lo que los identificadores existentes se siguen resolviendo.GET /withdrawals/{id}sigue respondiendo en esta versión. UsaGET /payouts/{id}para el trabajo nuevo.- Cada respuesta de los endpoints heredados, en cualquier versión, ahora incluye los encabezados
DeprecationyLink: <…/payouts>; rel="successor-version". Un encabezadoSunsetanunciará 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.
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_iddevuelve 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 eranullpara 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_sourceypost_thumbnail_urldescriben ese campo.
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,visibilityy uncreated_atISO 8601. Los campossizeyurlsonnullhasta que la subida está enready. GET /files/{id}solo resuelve los archivos que creaste; otros llamadores reciben un 404.
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.statususa ocho palabras:requested,in_review,processing,completed,reversed,canceled,failed,denied. Un pago saliente liquidado que el proveedor revierte muestrareversed, con el código de devolución yfunds_returned_atenfailure.- Un nuevo campo
status_detailincluye la fase de máquina más detallada bajo la palabra de estado. Sus valores pueden crecer sin un cambio de versión;statuses el contrato versionado. amount,fee_amount,net_amount,markup_feeydestination_amountson cadenas decimales.exchange_ratesigue siendo un número.- Los pagos salientes se crean con su ID
wdrl_: el ID que devuelvePOST /payoutses el ID que listaGET /payouts, y la solicitud de conversión de un pago saliente se conserva comopayout_request_id. Las solicitudes de conversión creadas antes de esta versión siguen respondiendo con su IDcofr_. - La clave de idempotencia se envía solo en el encabezado
Idempotency-Key, y el campoidempotency_keydel cuerpo se rechaza.
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.El campo
company_id del envoltorio de webhooks pasa a llamarse account_id.- Las entregas de webhooks fijadas en
2026-08-14o posterior incluyenaccount_iden el envoltorio. - Los webhooks fijados a versiones anteriores, y los webhooks sin una versión
api_version_datefijada, conservancompany_id.
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
pendingein_transitpara 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
api_version en POST /webhooks y PATCH /webhooks/{id}.- Los nuevos webhooks siempre usan los eventos y payloads
v1. Las solicitudes que pasanapi_versionse rechazan con un400. - Fija la estructura del payload de un webhook con
api_version_dateen su lugar. - Los webhooks
v2yv5existentes siguen entregando. Ya no puedes crear webhooks ni cambiarlos a estas versiones.
Las alertas de disputas ahora son un recurso REST nativo y siguen sirviéndose también a través del proxy heredado.
GET /dispute_alertslista las alertas de una cuenta con paginación por cursor, y filtra poraccount_id,payment_id,typey una ventana de creación.typereemplaza aalert_typee indica los dos tipos que envía un emisor:early_fraud_warning(informes de fraude Visa TC40 / Mastercard SAFE) ydispute_alert(avisos previos a la disputa).fee_chargedreemplaza acharge_for_alerte indica si Whop realmente cobró a la cuenta. Las advertencias tempranas de fraude nunca se cobran.actionableindica si reembolsar el pago todavía puede evitar un contracargo.- Los objetos
paymentydisputese reemplazan por las etiquetaspayment_idyaccount_id. Las marcas de tiempo son ISO 8601, conreported_atpara cuando el emisor presentó el informe.
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.amountes el importe defrom_tokenque 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_tokense movió al nuevo campoto_amount(expresado ento_token, con un límite igual a la deuda).amountyto_amountson mutuamente excluyentes. - Omitir ambos sigue reembolsando el saldo negativo completo de
to_token. - Quienes llaman con versiones anteriores fijadas conservan el comportamiento anterior: su
amountfiduciario se trata como el importe de reembolso deto_token.
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 comobank_statement, o una clave de campo comossn, con unalabelpara mostrar al usuario. - Responde a las entradas
fileconfile(un ID de subida directa). Responde a las entradastext,date,phoneyselectconvalue, y a las entradasaddressconaddress. No se devuelve nada de la respuesta. - Una entrada marcada como
multipleacepta 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
optionstambién acepta unvalue. Para las entradasselect, 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
errorsestructurados con uncodeestable y unreason. - La estructura de formulario anidada
requested_files/categorydesaparece en esta versión. Quienes llaman con versiones anteriores fijadas la conservan, y sus respuestas se traducen automáticamente.
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_codeslista los códigos promocionales de una cuenta y usaaccount_iden lugar decompany_id.POST /promo_codescrea códigos promocionales.GETyDELETE /promo_codes/{id}los obtienen y archivan.POST /promo_codes/{id}/activateyPOST /promo_codes/{id}/deactivatereemplazan la escritura de estado heredada conPATCH.- 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.
Las respuestas de cuenta ahora exponen una relación más completa con la cuenta principal para las cuentas conectadas.
parent_accountreemplaza aparent_account_id.- La cuenta principal incluye su
id,title,routeylogo_url.
Los métodos de pago saliente compatibles ahora tienen su propio endpoint paginado.
GET /payouts/supported_methodslista 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 IDpodst_se pasan comosupported_payout_method_id. - Los métodos de pago saliente guardados exponen
supported_payout_method. Los pagos salientes exponenpayout_method.supported_payout_method. - Usa
countrypara listar los métodos compatibles de un país distinto al país de la cuenta de pago saliente. GET /payouts/methodsya no aceptainclude_availableni devuelveavailable_destinations.- Quienes llaman con versiones anteriores fijadas conservan
destination_id,payout_destinationypayout_token.
Las transacciones de tarjeta ahora usan endpoints REST nativos y siguen sirviéndose también a través del proxy heredado.
GET /card_transactionslista las transacciones de tarjeta de una cuenta, yGET /card_transactions/{id}obtiene una por su IDcitx_. La lista también acepta un filtrotransaction_idspara 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_afterycreated_before. Los filtros de marca de tiempo son ISO 8601. cardholder_ides nuevo en la respuesta: el usuario al que está asignada la tarjeta.
- Cada método de pago saliente devuelve
fee_structure(porcentaje, importe fijo y moneda) yestimated_arrival(marcas de tiempo por velocidad) sin requerir unamount. - Los objetos
standardeinstantde la cotización ya no incluyenestimated_arrival. Léelo en el campoestimated_arrivalde nivel superior del método.
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,reasonyavailable_actionsexponen 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 enGET /resolution_center_cases/summary. - Las escrituras usan
messageyattachments.due_datepasa a llamarseresponse_due_at. Listar ya no requiereaccount_id.
Los envíos ahora usan endpoints REST nativos y siguen sirviéndose también a través del proxy heredado.
GET /shipmentslista los envíos.GET /shipments/{id}obtiene uno por ID de envío o ID de pago.POST /shipmentscrea un envío, yPATCH /shipments/{id}actualiza su número de seguimiento.- Las respuestas usan
account_idytracking_number, junto concarrier,tracking_url,order_idypayment_id. - Quienes llaman con una versión fijada anterior a esta fecha conservan sin cambios el contrato del proxy heredado.
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, yPOST /disputes/{id}/submitla envía. La evidencia está anidada bajoevidence.GET /disputes/summaryproporciona totales agrupados porstatusycurrency. Listar y obtener devuelven los mismos campos.- Las respuestas usan
account_id,product_idyplan_id, además debuyerjunto apayment. Listar ya no requiereaccount_id. statusyreasonson enums normalizados, yneeds_response_by,rdryeditablese reemplazan por sus nuevos campos.- Quienes llaman con una versión fijada anterior a esta fecha conservan sin cambios el contrato del proxy heredado.
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_idyproduct_iden lugar de los objetos de compatibilidad anidadosplanyproduct. - Listar membresías devuelve todo lo que el llamador puede leer (las suyas más las de sus cuentas gestionadas), y
account_id/user_idacotan esa lista en lugar de cambiar de modo o devolver un error. - Establece
cancel_at_period_endpara programar la cancelación. La accióncancelfinaliza el acceso inmediatamente. - La acción
extendreemplaza aadd_free_days.
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
accounten lugar decompany.
Los negocios partner ahora exponen tasas de pago independientes para cada fuente de ingresos.
payout_percentagese reemplaza porpayout_percentages.- El objeto anidado incluye las tasas
sales,ad_spend,transferycard_interchange.
Los productos y las configuraciones de checkout ahora usan el modelo Account de forma coherente.
- Los parámetros de solicitud de productos usan
account_iden lugar decompany_id. - Las solicitudes de configuración de checkout usan
account_iden el nivel superior y dentro de los objetos de variante en línea incluidos en el campo de compatibilidadplan. - Las respuestas de configuración de checkout devuelven
account_iden lugar decompany_id.
Las marcas de tiempo de las configuraciones de checkout ahora usan el mismo formato que el resto de la API.
created_atyupdated_atson cadenas ISO 8601 en lugar de enteros epoch de Unix.
Los saldos de usuario ahora proporcionan un resumen de saldo completo y estructurado.
- Los campos planos
total_usdybalancesse reemplazan por un objetobalanceanidado. - 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.
Las ganancias por referencias de negocios ahora identifican el recurso polimórfico que generó la ganancia.
receiptse reemplaza porresource.access_passse reemplaza porproduct.- Las ganancias respaldadas por recibos devuelven
resource.object: "receipt"con los detalles de pago del recibo. - El campo
resourcepuede admitir recursos de ganancias adicionales en futuras versiones sin reutilizar campos específicos de recibos.
El volumen y las ganancias por referencias de negocios ahora se reportan como grupos conciliables.
processing_volume,total_earnings,pending_payoutycompleted_payoutse reemplazan por los objetos anidadosvolume_usdyearnings_usd.- Las ganancias cambian el nombre de
base_amount/amountatransaction_amount_usd/commission_amount_usdy expresanpayout_percentagecomo una fracción.
Las variantes, que entonces se llamaban Plans, ahora usan el modelo Account de forma coherente.
- Los parámetros y cuerpos de solicitud usan
account_iden lugar decompany_id. - Las respuestas de variantes devuelven
accounten lugar decompany.
Las solicitudes de acceso de usuarios ahora usan el modelo Account de forma coherente.
- Los parámetros y cuerpos de solicitud usan
account_iden lugar decompany_id. - Las estructuras de respuesta no cambian.

