business_type, industry_group e industry_type clasifican las cuentas. Consulta el glosario de tipos de negocio e industrias para ver todos los valores válidos.
Endpoints
Recargos de comisiones
Los recargos de comisiones permiten a una plataforma añadir cargos o subvencionar las comisiones de pago de sus subcuentas. Gestiónalos a través del documento de comisiones de la cuenta: define valores predeterminados en la cuenta de plataforma o anula comisiones individuales en una subcuenta. Consulta Recargos y subvenciones de comisiones para ver ejemplos, límites y requisitos de financiación.Endpoints de comisiones
company:update_child_fees para configurar los recargos. Cada recargo devuelto incluye adjustable y unadjustable_reason para que tu integración pueda determinar si se puede editar.
Leer las comisiones
markups contiene las tasas efectivas de la subcuenta. La sección child_markups de una cuenta de plataforma contiene sus valores predeterminados para las subcuentas.
El source de un recargo es custom cuando se ha configurado en ese nivel, o default cuando recurre a una tasa heredada o a cero. Su campo default muestra la tasa que se aplicaría si se borrara el recargo personalizado. Los importes fijos devueltos usan el objeto Money; las actualizaciones aceptan fixed como un número en dólares estadounidenses.
Definir los valores predeterminados de la plataforma
Actualizachild_markups en la cuenta de plataforma. Este ejemplo define un recargo de pago del 2 % sin cargo fijo:
percentage: 2 significa 2 %. Los valores predeterminados se aplican a las subcuentas que no tienen una anulación para esa comisión. Los recargos de pago se aplican cuando no se ha definido ninguna comisión de aplicación en el checkout.
Definir una anulación para una subcuenta
Actualizamarkups en la subcuenta. Este ejemplo sustituye su recargo de pago heredado por un 1 % más 0,25 $:
transfers, crypto_swaps, deposits indexado por vía de pago, o payouts indexado por método de pago. Consulta el endpoint de actualización para ver las claves admitidas y el esquema de la solicitud.
Borrar un recargo
Envíanull para el recargo para borrarlo. Borrar la anulación de una subcuenta restaura el valor predeterminado de su plataforma, o cero si no hay ningún valor predeterminado configurado:
child_markups: { payments: null } a la cuenta de plataforma. Un { percentage: 0, fixed: 0 } explícito sigue siendo una tasa configurada; usa null para restaurar la herencia.
Documentos legales
Una cuenta publica sus documentos legales como archivos PDF:terms_of_service, privacy_policy, return_policy, cancellation_policy, shipping_policy y eula. Cada uno se lee como un File y se define mediante Update Account con el id de un archivo que hayas subido.
Las nuevas disputas toman de forma predeterminada las pruebas de sus políticas de estos documentos. El espacio de la política de cancelación usa cancellation_policy, después terms_of_service y después return_policy. El espacio de la política de reembolso usa return_policy y después terms_of_service. Cualquiera de los dos espacios recurre a la política de la plataforma Whop cuando no hay ninguno definido, y shipping_policy se incluye en las disputas de bienes físicos. Defínelos una vez aquí y usa Upload Dispute Evidence solo cuando una disputa necesite una versión distinta de una política.
null para un documento para eliminarlo. Solo se aceptan archivos PDF.
Atributos
list para quienes llaman con stats:read en la cuenta; null en caso contrario.total_usd es null.Propiedades
Propiedades
Propiedades
Propiedades
pending que ya se ha liquidado y está esperando para pasar a la billetera de criptomonedas o a la Whop Card de la cuenta, donde pasa a ser available. El movimiento suele empezar en menos de una hora; mientras se ejecuta, el importe se informa en in_transit. No se incluye el dinero movido solo para recargar el saldo mínimo retenido de la cuenta. En unidades nativas, como cadena decimal.finishing_settlement, queda fuera, por lo que estas entradas más finishing_settlement pueden sumar menos que pending, nunca más.null cuando no hay ningún tipo de cambio disponible.line1, line2, city, state, postal_code y country. null cuando no hay ninguna dirección definida.null si no ha publicado ninguno.Propiedades
Propiedades
application/pdf. Se conserva cuando la moderación elimina el archivo.complete. Solo está presente al crear, y solo para cargas multiparte.true, url sirve una imagen de sustitución. filename, size y content_type siguen describiendo el archivo original.pending, processing, ready, failednull hasta que la carga haya terminado. Cuando la moderación elimina el archivo, una URL de imagen de sustitución.public se sirven desde una URL de CDN sin firmar. Los archivos private se sirven desde una URL firmada que caduca.Opciones disponibles: public, privateactive, inactive o pending (incorporación o revisión en curso). Solo se calcula en retrieve y me para quienes llaman con el alcance company:balance:read; null en caso contrario.Propiedades
Propiedades
active, inactive, pendingactive, inactive, pendingactive, inactive, pendingactive, inactive, pendingactive, inactive, pendingactive, inactive, pendingactive, inactive, pendingactive, inactive, pendingactive, inactive, pendinginactive hasta que se verifique la identidad o el negocio de la cuenta, mientras un acuerdo de servicios publicitarios solicitado esté pendiente de la firma de la cuenta y mientras la cuenta esté suspendida de Whop Ads.Opciones disponibles: active, inactive, pendingactive, inactive, pendinglist, retrieve y me para quienes llaman con el alcance company:balance:read; null en caso contrario, o cuando la cuenta no tiene ninguna solicitud de tarjeta ni ninguna revisión de solicitud bloqueante.Propiedades
Propiedades
unsupported_state sustituye a unsupported_region para una persona o un negocio verificado en Estados Unidos. compliance abarca las comprobaciones de sanciones, personas expuestas políticamente y medios adversos. other abarca los motivos que no están en esta lista. null cuando status no es denied, o cuando el emisor no rechazó la solicitud.Opciones disponibles: compromised_identity, duplicate, unsupported_region, compliance, fraud, verification_failed, unsupported_state, otherbusiness, KYB) o una persona (individual, identidad del consumidor). null cuando la solicitud aún no está vinculada a una verificación.Opciones disponibles: individual, businessapproved significa que se pueden emitir tarjetas. needs_verification significa que el solicitante aún no ha completado la verificación de identidad; needs_information significa que sí lo hizo, pero los documentos se rechazaron por un motivo subsanable y deben volver a enviarse. pending y manual_review están en curso. denied, locked y canceled son definitivos.Opciones disponibles: approved, pending, manual_review, denied, locked, canceled, needs_verification, needs_informationstatus draft hasta que se paga el checkout de constitución; después, el progreso de la presentación con documentos descargables y firmas pendientes. Vacío cuando el estado de constitución no está disponible temporalmente.Propiedades
Propiedades
status deja de ser draft.Propiedades
Propiedades
articles_of_organization, operating_agreement, ein_letter, signed_ss4, signed_form8821 o mail para la correspondencia postal recibida en nombre de la empresa.Acme, LLC. Presente una vez que status deja de ser draft.status deja de ser draft; vacío cuando no hay nada que firmar.Propiedades
Propiedades
Propiedades
Propiedades
pending cuando hay una sesión de firma lista para el fundador; unknown cuando no se pudo determinar el estado de la firma.Opciones disponibles: pending, unknownPropiedades
Propiedades
pending cuando hay una sesión de firma lista para el fundador; unknown cuando no se pudo determinar el estado de la firma.Opciones disponibles: pending, unknownstatus deja de ser draft.retrieve para quienes llaman con stats:read en la cuenta; null en caso contrario y cuando el recuento no está disponible.null si no ha publicado ninguno.Propiedades
Propiedades
application/pdf. Se conserva cuando la moderación elimina el archivo.complete. Solo está presente al crear, y solo para cargas multiparte.true, url sirve una imagen de sustitución. filename, size y content_type siguen describiendo el archivo original.pending, processing, ready, failednull hasta que la carga haya terminado. Cuando la moderación elimina el archivo, una URL de imagen de sustitución.public se sirven desde una URL de CDN sin firmar. Los archivos private se sirven desde una URL firmada que caduca.Opciones disponibles: public, privatenull cuando no está definido.retrieve y me para quienes llaman con el alcance company:balance:read; null en caso contrario, o cuando la cuenta nunca ha solicitado financiación.Propiedades
Propiedades
requires_collection (a la espera del comerciante, incluso después de una solicitud de más información), awaiting_review, approved, denied o completed. Si los métodos de pago con financiación están habilitados se indica en capabilities.accept_bnpl_payments.Opciones disponibles: requires_collection, awaiting_review, completed, approved, deniedretrieve, me y suspend; null en caso contrario, cuando status no es suspended y cuando la suspensión retiene el saldo.hide_member_count, hide_members_cardowner de la cuenta, contabilizado en todas las cuentas que posee, por lo que todas muestran el mismo nivel. Solo se calcula en retrieve y me para quienes llaman con el alcance company:basic:read; null en caso contrario y cuando la cuenta no está en Whop Levels.Propiedades
Propiedades
0 a 10. current es mayor cuando las otras cuentas del propietario lo elevan.0 a 10.Propiedades
Propiedades
platform, sellerwhite, black, orangeemail anterior. Es distinto del rol owner de los miembros del equipo, que puede tener cualquier número de ellos.Propiedades
Propiedades
url siempre está presente y es un marcador de posición generado cuando el usuario no ha definido ninguna imagen.null para las cuentas independientes.Propiedades
Propiedades
crypto_deposit_markup), cada una con percentage_fee y fixed_fee_usd. Se resuelven dando prioridad a las anulaciones propias de la subcuenta sobre el valor predeterminado de la plataforma.Propiedades
Propiedades
url siempre está presente y es un marcador de posición generado cuando el usuario no ha definido ninguna imagen.retrieve y me para quienes llaman con el alcance company:balance:read; null en caso contrario.Propiedades
Propiedades
null cuando no está disponible.capabilities.accept_bnpl_payments.payment_method, measure (disputes, disputes_and_tc40s o fraud_disputes), warned_at como marca de tiempo ISO 8601, y rate, warning_rate y target_rate como fracciones en las que 0.01 es el 1 %. Vacío cuando no hay ninguno advertido. Un método advertido se pausa, y aparece en restricted_payment_methods, si sigue por encima de su tasa objetivo unas cuatro semanas después.2 significa 2 %. 0 cuando la cuenta está exenta.Propiedades
Propiedades
null cuando los reembolsos automáticos están desactivados para tarjetas.null cuando los reembolsos automáticos están desactivados para la financiación.card_visa, card_mastercard, card_american_express, card_discover_global_network, addi, affirm, afterpay_clearpay, alma, billie, capchase_pay, claritypay, flex_pay, klarna, kriya, kueski, mondu, oney, scalapay, sequra, sezzle, splitit, sunbit, tabby, tamara, zip, card_installments_three, card_installments_six, card_installments_twelve, oney_3x, oney_4x, klarna_pay_now, us_bank_account, sepa_debit, bacs_debit, au_becs_debit, acss_debit, pay_by_bank, payto, paypal, cashapp, venmo, amazon_pay, link, wechat_paykyc_incomplete, pending_information_request y update_payout_profile son cuestiones sobre las que el comerciante puede actuar. compliance_review significa que se está revisando una verificación que el comerciante ya envió, por lo que estos fondos siguen pendientes hasta que se apruebe. withdrawals_disabled significa que Whop ha bloqueado los retiros, por lo que estos fondos no pueden pasar a estar disponibles. null cuando no hay ningún motivo que mostrar: aún se están liquidando o se retienen por un motivo que no se indica aquí.Opciones disponibles: kyc_incomplete, pending_information_request, update_payout_profile, compliance_review, withdrawals_disabledPropiedades
Propiedades
weekly, 1-31 para monthly. null para manual y daily.manual, daily, weekly, monthlypayment_method_configuration propio de una variante o de una configuración de checkout tiene prioridad. null cuando la cuenta usa los valores predeterminados de la plataforma Whop.Propiedades
Propiedades
balances ni en total_usd. Vacío cuando la cuenta no tiene ninguno o total_usd es null.Propiedades
Propiedades
"10.00" son diez dólares. Es una cadena para que ningún número de coma flotante lo redondee en tránsito.null si no ha publicado ninguno.Propiedades
Propiedades
application/pdf. Se conserva cuando la moderación elimina el archivo.complete. Solo está presente al crear, y solo para cargas multiparte.true, url sirve una imagen de sustitución. filename, size y content_type siguen describiendo el archivo original.pending, processing, ready, failednull hasta que la carga haya terminado. Cuando la moderación elimina el archivo, una URL de imagen de sustitución.public se sirven desde una URL de CDN sin firmar. Los archivos private se sirven desde una URL firmada que caduca.Opciones disponibles: public, privateid, name y product_type. null cuando no hay ningún valor predeterminado definido.GET /economic_intelligence?account_id=\{account_id}.Propiedades
Propiedades
theme_business, create_product, create_plan, verify_identity, connect_affiliate_program, create_promotion, migrate_from_stripe, accept_first_payment, launch_first_ad, launch_draft_campaign, increase_ad_budget, refresh_ad_creatives, fix_ad_billing, exclude_customers_from_ads, retarget_abandoned_checkouts, fix_funnel_dropoff, invite_team_member, enable_tax_collection, create_card, apply_for_financingretrieve y me para quienes llaman con el alcance company:balance:read; null en caso contrario.Propiedades
Propiedades
deposit_funds, review_held_payments, submit_information_request, update_automatic_withdrawal_method, reauthorize_payout_methods, update_payout_method, update_payout_profile, card_usage_review, verify_identity, scale_account_setup, sign_formation_documents, configure_tax_remitter, add_vat_registration, confirm_tax_details, accept_payout_terms, enable_two_factor_authentication, respond_to_abuse_reportrequired, pendingnull si no ha publicado ninguno.Propiedades
Propiedades
application/pdf. Se conserva cuando la moderación elimina el archivo.complete. Solo está presente al crear, y solo para cargas multiparte.true, url sirve una imagen de sustitución. filename, size y content_type siguen describiendo el archivo original.pending, processing, ready, failednull hasta que la carga haya terminado. Cuando la moderación elimina el archivo, una URL de imagen de sustitución.public se sirven desde una URL de CDN sin firmar. Los archivos private se sirven desde una URL firmada que caduca.Opciones disponibles: public, privatePropiedades
Propiedades
prwd_. El progreso y el estado se aplican a la cuenta que lo contiene.Propiedades
Propiedades
"10.00" son diez dólares. Es una cadena para que ningún número de coma flotante lo redondee en tránsito.Propiedades
Propiedades
"10.00" son diez dólares. Es una cadena para que ningún número de coma flotante lo redondee en tránsito.sales, ad_spendPropiedades
Propiedades
"10.00" son diez dólares. Es una cadena para que ningún número de coma flotante lo redondee en tránsito.in_progress, processing, credited, reversing, reversed, unavailablenull si no ha publicado ninguno.Propiedades
Propiedades
application/pdf. Se conserva cuando la moderación elimina el archivo.complete. Solo está presente al crear, y solo para cargas multiparte.true, url sirve una imagen de sustitución. filename, size y content_type siguen describiendo el archivo original.pending, processing, ready, failednull hasta que la carga haya terminado. Cuando la moderación elimina el archivo, una URL de imagen de sustitución.public se sirven desde una URL de CDN sin firmar. Los archivos private se sirven desde una URL firmada que caduca.Opciones disponibles: public, privatePropiedades
Propiedades
active o suspended. Se calcula en list, retrieve, me y suspend; null en caso contrario.Suspended - Fraudulent activity. Suspended cuando no hay ningún motivo registrado. Se calcula en retrieve, me y suspend. null en caso contrario, o cuando status no es suspended.Propiedades
Propiedades
ruby, tomato, red, crimson, pink, plum, purple, violet, iris, cyan, teal, jade, green, grass, brown, blue, orange, indigo, sky, mint, yellow, amber, lime, lemon, magenta, gold, bronze, grayfeatured, compactpersonal, businessDC) en los que la cuenta recauda impuestos: el conjunto completo cuando Whop los ingresa (tax_remitted_by whop), el subconjunto configurado cuando la cuenta los ingresa por su cuenta (self) y vacío cuando no se da ninguno de los dos casos. Al actualizar, envía la lista completa para reemplazarla (solo se permite cuando es self).Propiedades
Propiedades
ad_nrt, ao_tin, ar_cuit, al_tin, am_tin, aw_tin, au_abn, au_arn, eu_vat, az_tin, bs_tin, bh_vat, bd_bin, bb_tin, by_tin, bj_ifu, bo_tin, ba_tin, br_cnpj, br_cpf, bg_uic, bf_ifu, kh_tin, cm_niu, ca_bn, ca_gst_hst, ca_pst_bc, ca_pst_mb, ca_pst_sk, ca_qst, cv_nif, cl_tin, cn_tin, co_nit, cd_nif, cr_tin, hr_oib, do_rcn, ec_ruc, eg_tin, sv_nit, et_tin, eu_oss_vat, ge_vat, gh_tin, de_stn, gb_vat, gn_nif, hk_br, hu_tin, is_vat, in_gst, id_npwp, il_vat, jp_cn, jp_rn, jp_trn, kz_bin, ke_pin, kg_tin, la_tin, li_uid, li_vat, my_frp, my_itn, my_sst, mr_nif, mx_rfc, md_vat, me_pib, ma_vat, np_pan, nz_gst, ng_tin, mk_vat, no_vat, no_voec, om_vat, pe_ruc, ph_tin, pl_nip, ro_tin, ru_inn, ru_kpp, sa_vat, sn_ninea, rs_pib, sg_gst, sg_uen, si_tin, za_vat, kr_brn, es_cif, ch_uid, ch_vat, tw_vat, tj_tin, tz_vat, th_vat, tr_tin, ug_tin, ua_vat, ae_trn, us_ein, uy_ruc, uz_tin, uz_vat, ve_rif, vn_tin, zm_tin, zw_tin, sr_fin, xi_vatDE123456789. Consulta la guía de IDs fiscales.whop significa que Whop los calcula y los ingresa. self significa que Whop los calcula y la cuenta los recauda y los ingresa. none significa que ninguno de los dos, y la cuenta es responsable. Los negocios nuevos empiezan con whop y las cuentas conectadas nuevas empiezan con none. null significa que la cuenta aún no tiene ningún ajuste.Opciones disponibles: whop, self, noneinclusive (impuestos incluidos en el precio indicado) o exclusive (impuestos añadidos al precio). Toma exclusive como valor predeterminado cuando no está definido; null solo cuando la cuenta no tiene conexión de pagos.Opciones disponibles: inclusive, exclusivenull si no ha publicado ninguno.Propiedades
Propiedades
application/pdf. Se conserva cuando la moderación elimina el archivo.complete. Solo está presente al crear, y solo para cargas multiparte.true, url sirve una imagen de sustitución. filename, size y content_type siguen describiendo el archivo original.pending, processing, ready, failednull hasta que la carga haya terminado. Cuando la moderación elimina el archivo, una URL de imagen de sustitución.public se sirven desde una URL de CDN sin firmar. Los archivos private se sirven desde una URL firmada que caduca.Opciones disponibles: public, privatemandate_challenge exige un desafío 3DS antes de procesar el pago; mandate_if_required exige un desafío solo cuando el procesador de pagos lo requiere; frictionless_if_required usa el flujo 3DS sin fricción habitual. Los pagos de 1000 $ o más usan mandate_if_required a menos que se seleccione mandate_challenge. Los requisitos de riesgo y de recuperación de la autenticación pueden anular la preferencia. null usa el flujo de checkout estándar.Opciones disponibles: mandate_challenge, mandate_if_required, frictionless_if_requiredretrieve y me para quienes llaman con el alcance stats:read; null en caso contrario.retrieve y me); null en las respuestas de listas, las escrituras, cuando falta el permiso de lectura de saldos o cuando la fuente de saldos no está disponible.include_trading=true en las lecturas de una sola cuenta. null en caso contrario, sin permiso de trading o sin una billetera de Ethereum.Propiedades
Propiedades
cwal_.biz_. null cuando la posee un usuario.provider es hyperliquid; en caso contrario, null.Propiedades
Propiedades
deposit puede mover a esta cuenta, como cadena decimal. null cuando no se pudo leer la cadena.xyz, leídos de Hyperliquid como máximo una vez por segundo. null cuando no se pudo leer Hyperliquid. Usa websocket_subscriptions para recibir actualizaciones en tiempo real.Propiedades
Propiedades
Propiedades
Propiedades
"10.00" son diez dólares. Es una cadena para que ningún número de coma flotante lo redondee en tránsito.Propiedades
Propiedades
"10.00" son diez dólares. Es una cadena para que ningún número de coma flotante lo redondee en tránsito.Propiedades
Propiedades
"10.00" son diez dólares. Es una cadena para que ningún número de coma flotante lo redondee en tránsito.Propiedades
Propiedades
"10.00" son diez dólares. Es una cadena para que ningún número de coma flotante lo redondee en tránsito.xyz, leídas de Hyperliquid como máximo una vez por segundo. null cuando no se pudo leer Hyperliquid. Usa websocket_subscriptions para recibir actualizaciones en tiempo real.Propiedades
Propiedades
trdpos_. Estable para un mercado dentro de una cuenta de trading.null cuando el proveedor lo omite.Propiedades
Propiedades
"10.00" son diez dólares. Es una cadena para que ningún número de coma flotante lo redondee en tránsito.null.Propiedades
Propiedades
Propiedades
Propiedades
null cuando no está disponible.Propiedades
Propiedades
"10.00" son diez dólares. Es una cadena para que ningún número de coma flotante lo redondee en tránsito.null cuando no está disponible.Propiedades
Propiedades
"10.00" son diez dólares. Es una cadena para que ningún número de coma flotante lo redondee en tránsito.null cuando no está disponible.Propiedades
Propiedades
"10.00" son diez dólares. Es una cadena para que ningún número de coma flotante lo redondee en tránsito.null cuando Hyperliquid no informa de ninguno.Propiedades
Propiedades
"10.00" son diez dólares. Es una cadena para que ningún número de coma flotante lo redondee en tránsito.Propiedades
Propiedades
"10.00" son diez dólares. Es una cadena para que ningún número de coma flotante lo redondee en tránsito.Propiedades
Propiedades
"10.00" son diez dólares. Es una cadena para que ningún número de coma flotante lo redondee en tránsito.Propiedades
Propiedades
"10.00" son diez dólares. Es una cadena para que ningún número de coma flotante lo redondee en tránsito.message sin cambios después de conectarte a websocket_url.hyperliquidnull cuando no se pudo leer.Propiedades
Propiedades
Propiedades
Propiedades
null cuando no se conoce.Propiedades
Propiedades
"10.00" son diez dólares. Es una cadena para que ningún número de coma flotante lo redondee en tránsito.Propiedades
Propiedades
"10.00" son diez dólares. Es una cadena para que ningún número de coma flotante lo redondee en tránsito.id del mercado al contado de GET /trades/markets, como BTC, XAUT o el ticker de una acción tokenizada, como AAPL.Propiedades
Propiedades
"10.00" son diez dólares. Es una cadena para que ningún número de coma flotante lo redondee en tránsito.cost_basis, en USD.Propiedades
Propiedades
"10.00" son diez dólares. Es una cadena para que ningún número de coma flotante lo redondee en tránsito.individual (KYC) y business (KYB). Cada uno es null hasta que se crea; en caso contrario, un status de not_started, pending, manual_review, approved o rejected.list para quienes llaman con stats:read en la cuenta; null en caso contrario.list para quienes llaman con stats:read en la cuenta; null en caso contrario.null si no se ha aprovisionado ninguna.null si no se ha proporcionado ninguna. Definirla también añade una entrada website a social_links.Tipos de negocio e industrias
Tres campos clasifican las cuentas:business_type, industry_group e industry_type. La taxonomía completa se encuentra en su propia página:

