OpportunitiesEntities
Docs
    Ring Platform

    Futuro descentralizado que se construye a sí mismo

    Iniciar sesión
    Entities
    Opportunities
    Store
    Docs
    Conceptos de la plataforma
    RING EconomíaSonoratek LLCImpacto globalIA encuentra Web3
    Empezar
    Inicio rápidoCalculadoraHoja de ruta
    Privacidad|Contacto
    v1.106.29|Sonoratek LLC

    Documentation

    Conceptos, valor y escenarios típicos de clon — menos código.

    Primeros pasos
    Requisitos previos
    Instalación
    Validación del primer éxito
    Próximos pasos
    Funcionalidades
    Tienda multivendedor
    Membership
    Cortina de página
    Entidades
    Oportunidades
    Mensajería en tiempo real
    Módulo de noticias
    Blogs de miembros
    Notificaciones
    Personalización
    Ringization playbook
    Despliegue
    Despliegue autoalojado
    Arquitectura
    Arquitectura de News Kingdom
    Desarrollo
    OSS frente a enterprise

    Entrada rápida (CTOs · auditores · agentes)

    Bienvenida — misión y audiencias
    Referencia rápida
    Primeros pasos
    Arquitectura y Auth.js
    Modos de backend y bases de datos (DB_BACKEND_MODE)
    Self-hosted
    Ring MCP Tools
    Ring MCP Server
    Token economics
    Token launch jurisdictions
    Deploy (Docker · k8s)
    Lecturas de seguridad y cumplimiento
    ringdom.org — base LegioX
    Código fuente — licencia MIT (GitHub)

    Documentation

    Conceptos, valor y escenarios típicos de clon — menos código.

    Primeros pasos
    Requisitos previos
    Instalación
    Validación del primer éxito
    Próximos pasos
    Funcionalidades
    Tienda multivendedor
    Membership
    Cortina de página
    Entidades
    Oportunidades
    Mensajería en tiempo real
    Módulo de noticias
    Blogs de miembros
    Notificaciones
    Personalización
    Ringization playbook
    Despliegue
    Despliegue autoalojado
    Arquitectura
    Arquitectura de News Kingdom
    Desarrollo
    OSS frente a enterprise

    Entrada rápida (CTOs · auditores · agentes)

    Bienvenida — misión y audiencias
    Referencia rápida
    Primeros pasos
    Arquitectura y Auth.js
    Modos de backend y bases de datos (DB_BACKEND_MODE)
    Self-hosted
    Ring MCP Tools
    Ring MCP Server
    Token economics
    Token launch jurisdictions
    Deploy (Docker · k8s)
    Lecturas de seguridad y cumplimiento
    ringdom.org — base LegioX
    Código fuente — licencia MIT (GitHub)

    Documentation

    Conceptos, valor y escenarios típicos de clon — menos código.

    Primeros pasos
    Requisitos previos
    Instalación
    Validación del primer éxito
    Próximos pasos
    Funcionalidades
    Tienda multivendedor
    Membership
    Cortina de página
    Entidades
    Oportunidades
    Mensajería en tiempo real
    Módulo de noticias
    Blogs de miembros
    Notificaciones
    Personalización
    Ringization playbook
    Despliegue
    Despliegue autoalojado
    Arquitectura
    Arquitectura de News Kingdom
    Desarrollo
    OSS frente a enterprise

    Entrada rápida (CTOs · auditores · agentes)

    Bienvenida — misión y audiencias
    Referencia rápida
    Primeros pasos
    Arquitectura y Auth.js
    Modos de backend y bases de datos (DB_BACKEND_MODE)
    Self-hosted
    Ring MCP Tools
    Ring MCP Server
    Token economics
    Token launch jurisdictions
    Deploy (Docker · k8s)
    Lecturas de seguridad y cumplimiento
    ringdom.org — base LegioX
    Código fuente — licencia MIT (GitHub)
    Ring Logo

    Loading documentation...

    Preparing Ring content

    Ring Logo

    Loading documentation...

    Preparing Ring content

    Ring Logo

    Loading documentation...

    Preparing Ring content


    title: Membresía y créditos description: Niveles de membresía de Ring y saldo de crédito: la escalera de seis roles, precios de mejora en token RING con el desk oracle, carriles de pago de PaymentConductor y el registro de suscripciones last_modified: "2026-10-26" audience: both

    Membresía y créditos

    Usa las pestañas Founder / Developer de la barra lateral para filtrar esta página. Los flujos de usuario se muestran en /membership; este artículo documenta niveles, precios y carriles de pago.

    La membresía es cómo un clon de Ring distingue niveles de comunidad y monetiza el acceso. La escalera de roles es la SSOT (features/auth/user-role.ts), los precios de mejora dependen de la configuración (lib/membership/pricing.ts) y cada pago, ya sea con tarjeta, saldo de crédito, PayPal o token nativo, pasa por PaymentConductor.

    Escalera de roles (SSOT)

    RolSignificado
    visitorSin autenticar, solo lectura
    subscriberSuscriptor básico de pago: acceso básico a la comunidad
    memberEstatus elevado con acceso más amplio
    confidentialAcceso a recursos confidenciales
    adminAdministrador de la plataforma
    superadminAdministrador de la plataforma de nivel superior

    Las mejoras pasan a un usuario de subscriber a member. La configuración del nivel confidential requiere explícitamente el rol confidential.

    Por qué importa para tu clon

    • Monetiza el acceso con un nivel member de pago, mientras visitors y subscribers mantienen el acceso básico.
    • Un checkout, muchos carriles. PaymentConductor unifica tarjeta, saldo de crédito, PayPal y token nativo: el mismo motor de checkout que usa la tienda.
    • Precios en RING predecibles. La mejora mensual por defecto es 1 RING (membership.ring.memberUpgradeAmount), la anual tiene un 20% de descuento sobre mensual × 12, y las cotizaciones en vivo pasan por el desk oracle para que el importe facturado coincida con la cotización.
    • El saldo de crédito es la denominación principal. Por encima de 10 unidades de crédito (MEMBERSHIP_DESK_CREDIT_HINT_MIN) la UI sugiere cambiar en el Token Desk en lugar de comprar crédito.

    Lista de comprobación del operador

    1. Confirma tus procesadores de pago en PaymentConductor (WayForPay / Stripe / PayPal según el clon).
    2. Revisa los importes de membership.ring y la configuración de los niveles member y memberAnnual en ring-config.json. Para cobrar un precio fiat fijo en lugar de uno derivado de RING, pon "pricedInNativeToken": false en ese nivel.
    3. Haz una mejora real por carril (tarjeta, crédito, token) en un clon de staging antes de salir a producción.

    Módulos de precios (verificado)

    MóduloFunción
    lib/membership/pricing.tsHelpers síncronos: importes RING por periodo, descuento anual del 20%, sugerencia del credit desk
    lib/membership/pricing-live.tsCotizaciones en vivo del desk solo en servidor mediante getNativeTokenToMainCurrencyRate
    lib/payments/conductor/handlers/membership-upgrade.tsManejo del propósito de mejora
    lib/payments/conductor/handlers/membership-upgrade-stripe.ts / -paypal.tsCarriles de mejora específicos de cada proveedor
    lib/payments/payment.config.tsPropósito membership_upgrade → PAYMENT_MEMBERSHIP_PROCESSOR

    Niveles con precio fiat (desde 2026-10-17)

    MemberTierConfig en lib/ring-config-types.ts incorpora pricedInNativeToken. Cuando es false, lib/membership/pricing.ts usa amount y del nivel como precio fiat. Cuando se omite o es (el valor por defecto de la plantilla), el importe sigue derivándose de la tarifa en token nativo.

    Documentación relacionada

    Related documentation

    WalletConductor

    En profundidad: el registro de crédito y la SSOT de dos tasas en la que se liquidan los pagos de membresía.

    PaymentConductor

    Depende de: los carriles de tarjeta, PayPal y token pasan todos por PaymentConductor.

    SubscriptionConductor

    Mismo flujo: ciclo de renovación y gestión de cancelaciones.

    Data Model

    Ver también: cómo viven credit_balance y el registro de suscripciones en el esquema JSONB.

    1. Docs
    2. /Funcionalidades
    3. /Membership

    4 min de escucha


    title: Membresía y créditos description: Niveles de membresía de Ring y saldo de crédito: la escalera de seis roles, precios de mejora en token RING con el desk oracle, carriles de pago de PaymentConductor y el registro de suscripciones last_modified: "2026-10-26" audience: both

    Membresía y créditos

    Usa las pestañas Founder / Developer de la barra lateral para filtrar esta página. Los flujos de usuario se muestran en /membership; este artículo documenta niveles, precios y carriles de pago.

    La membresía es cómo un clon de Ring distingue niveles de comunidad y monetiza el acceso. La escalera de roles es la SSOT (features/auth/user-role.ts), los precios de mejora dependen de la configuración (lib/membership/pricing.ts) y cada pago, ya sea con tarjeta, saldo de crédito, PayPal o token nativo, pasa por PaymentConductor.

    Escalera de roles (SSOT)

    RolSignificado
    visitorSin autenticar, solo lectura
    subscriberSuscriptor básico de pago: acceso básico a la comunidad
    memberEstatus elevado con acceso más amplio
    confidentialAcceso a recursos confidenciales
    adminAdministrador de la plataforma
    superadminAdministrador de la plataforma de nivel superior

    Las mejoras pasan a un usuario de subscriber a member. La configuración del nivel confidential requiere explícitamente el rol confidential.

    Por qué importa para tu clon

    • Monetiza el acceso con un nivel member de pago, mientras visitors y subscribers mantienen el acceso básico.
    • Un checkout, muchos carriles. PaymentConductor unifica tarjeta, saldo de crédito, PayPal y token nativo: el mismo motor de checkout que usa la tienda.
    • Precios en RING predecibles. La mejora mensual por defecto es 1 RING (membership.ring.memberUpgradeAmount), la anual tiene un 20% de descuento sobre mensual × 12, y las cotizaciones en vivo pasan por el desk oracle para que el importe facturado coincida con la cotización.
    • El saldo de crédito es la denominación principal. Por encima de 10 unidades de crédito (MEMBERSHIP_DESK_CREDIT_HINT_MIN) la UI sugiere cambiar en el Token Desk en lugar de comprar crédito.

    Lista de comprobación del operador

    1. Confirma tus procesadores de pago en PaymentConductor (WayForPay / Stripe / PayPal según el clon).
    2. Revisa los importes de membership.ring y la configuración de los niveles member y memberAnnual en ring-config.json. Para cobrar un precio fiat fijo en lugar de uno derivado de RING, pon "pricedInNativeToken": false en ese nivel.
    3. Haz una mejora real por carril (tarjeta, crédito, token) en un clon de staging antes de salir a producción.

    Módulos de precios (verificado)

    MóduloFunción
    lib/membership/pricing.tsHelpers síncronos: importes RING por periodo, descuento anual del 20%, sugerencia del credit desk
    lib/membership/pricing-live.tsCotizaciones en vivo del desk solo en servidor mediante getNativeTokenToMainCurrencyRate
    lib/payments/conductor/handlers/membership-upgrade.tsManejo del propósito de mejora
    lib/payments/conductor/handlers/membership-upgrade-stripe.ts / -paypal.tsCarriles de mejora específicos de cada proveedor
    lib/payments/payment.config.tsPropósito membership_upgrade → PAYMENT_MEMBERSHIP_PROCESSOR

    Niveles con precio fiat (desde 2026-10-17)

    MemberTierConfig en lib/ring-config-types.ts incorpora pricedInNativeToken. Cuando es false, lib/membership/pricing.ts usa amount y del nivel como precio fiat. Cuando se omite o es (el valor por defecto de la plantilla), el importe sigue derivándose de la tarifa en token nativo.

    Documentación relacionada

    Related documentation

    WalletConductor

    En profundidad: el registro de crédito y la SSOT de dos tasas en la que se liquidan los pagos de membresía.

    PaymentConductor

    Depende de: los carriles de tarjeta, PayPal y token pasan todos por PaymentConductor.

    SubscriptionConductor

    Mismo flujo: ciclo de renovación y gestión de cancelaciones.

    Data Model

    Ver también: cómo viven credit_balance y el registro de suscripciones en el esquema JSONB.

    1. Docs
    2. /Funcionalidades
    3. /Membership

    4 min de escucha


    title: Membresía y créditos description: Niveles de membresía de Ring y saldo de crédito: la escalera de seis roles, precios de mejora en token RING con el desk oracle, carriles de pago de PaymentConductor y el registro de suscripciones last_modified: "2026-10-26" audience: both

    Membresía y créditos

    Usa las pestañas Founder / Developer de la barra lateral para filtrar esta página. Los flujos de usuario se muestran en /membership; este artículo documenta niveles, precios y carriles de pago.

    La membresía es cómo un clon de Ring distingue niveles de comunidad y monetiza el acceso. La escalera de roles es la SSOT (features/auth/user-role.ts), los precios de mejora dependen de la configuración (lib/membership/pricing.ts) y cada pago, ya sea con tarjeta, saldo de crédito, PayPal o token nativo, pasa por PaymentConductor.

    Escalera de roles (SSOT)

    RolSignificado
    visitorSin autenticar, solo lectura
    subscriberSuscriptor básico de pago: acceso básico a la comunidad
    memberEstatus elevado con acceso más amplio
    confidentialAcceso a recursos confidenciales
    adminAdministrador de la plataforma
    superadminAdministrador de la plataforma de nivel superior

    Las mejoras pasan a un usuario de subscriber a member. La configuración del nivel confidential requiere explícitamente el rol confidential.

    Por qué importa para tu clon

    • Monetiza el acceso con un nivel member de pago, mientras visitors y subscribers mantienen el acceso básico.
    • Un checkout, muchos carriles. PaymentConductor unifica tarjeta, saldo de crédito, PayPal y token nativo: el mismo motor de checkout que usa la tienda.
    • Precios en RING predecibles. La mejora mensual por defecto es 1 RING (membership.ring.memberUpgradeAmount), la anual tiene un 20% de descuento sobre mensual × 12, y las cotizaciones en vivo pasan por el desk oracle para que el importe facturado coincida con la cotización.
    • El saldo de crédito es la denominación principal. Por encima de 10 unidades de crédito (MEMBERSHIP_DESK_CREDIT_HINT_MIN) la UI sugiere cambiar en el Token Desk en lugar de comprar crédito.

    Lista de comprobación del operador

    1. Confirma tus procesadores de pago en PaymentConductor (WayForPay / Stripe / PayPal según el clon).
    2. Revisa los importes de membership.ring y la configuración de los niveles member y memberAnnual en ring-config.json. Para cobrar un precio fiat fijo en lugar de uno derivado de RING, pon "pricedInNativeToken": false en ese nivel.
    3. Haz una mejora real por carril (tarjeta, crédito, token) en un clon de staging antes de salir a producción.

    Módulos de precios (verificado)

    MóduloFunción
    lib/membership/pricing.tsHelpers síncronos: importes RING por periodo, descuento anual del 20%, sugerencia del credit desk
    lib/membership/pricing-live.tsCotizaciones en vivo del desk solo en servidor mediante getNativeTokenToMainCurrencyRate
    lib/payments/conductor/handlers/membership-upgrade.tsManejo del propósito de mejora
    lib/payments/conductor/handlers/membership-upgrade-stripe.ts / -paypal.tsCarriles de mejora específicos de cada proveedor
    lib/payments/payment.config.tsPropósito membership_upgrade → PAYMENT_MEMBERSHIP_PROCESSOR

    Niveles con precio fiat (desde 2026-10-17)

    MemberTierConfig en lib/ring-config-types.ts incorpora pricedInNativeToken. Cuando es false, lib/membership/pricing.ts usa amount y del nivel como precio fiat. Cuando se omite o es (el valor por defecto de la plantilla), el importe sigue derivándose de la tarifa en token nativo.

    Documentación relacionada

    Related documentation

    WalletConductor

    En profundidad: el registro de crédito y la SSOT de dos tasas en la que se liquidan los pagos de membresía.

    PaymentConductor

    Depende de: los carriles de tarjeta, PayPal y token pasan todos por PaymentConductor.

    SubscriptionConductor

    Mismo flujo: ciclo de renovación y gestión de cancelaciones.

    Data Model

    Ver también: cómo viven credit_balance y el registro de suscripciones en el esquema JSONB.

    1. Docs
    2. /Funcionalidades
    3. /Membership

    4 min de escucha

    currency
    true

    POST /api/membership/subscription/create acepta billingPeriod (monthly por defecto, o yearly) y lo tarifica con getMemberMainCurrencyTierForPeriod. El proveedor Stripe crea un precio anual o mensual según corresponda, envía el importe en céntimos y devuelve client_secret cuando la suscripción aún necesita confirmar el pago (estado pending en el registro hasta entonces).

    Superficie de la API

    RutaMétodosPropósito
    /api/membership/payment/cardPOST, GETCheckout con tarjeta para la membresía
    /api/membership/payment/creditPOST, GETPago con saldo de crédito
    /api/membership/payment/paypalPOST, GETCheckout con PayPal
    /api/membership/payment/tokenPOST, GETPago con token nativo
    /api/membership/subscription/createPOSTCrear una suscripción. El cuerpo incluye provider, auto_renew, billingPeriod
    /api/membership/subscription/statusGETLeer el estado de la suscripción
    /api/membership/subscription/cancelPOST, GETCancelar una suscripción

    La verdad del registro

    1. 1

      Dónde llega el dinero

      Las mejoras pagadas se escriben en el registro de suscripciones (subscription_ledger): el proveedor credit_balance marca las renovaciones pagadas con crédito (next_payment_due indexado en data/schema.sql). El crédito en sí vive en el registro del usuario (users.data.credit_balance), con las transacciones del monedero como pista de auditoría (features/wallet/services/credit-balance-service.ts).

    2. 2

      Periodos de facturación

      MembershipBillingPeriod = 'monthly' | 'yearly'. Coste anual = annualUpgradeAmount si está definido; si no, mensual × 12 × 0.8 (20% de descuento). Forma del nivel: MemberTierConfig { amount, currency, description, duration }.

    currency
    true

    POST /api/membership/subscription/create acepta billingPeriod (monthly por defecto, o yearly) y lo tarifica con getMemberMainCurrencyTierForPeriod. El proveedor Stripe crea un precio anual o mensual según corresponda, envía el importe en céntimos y devuelve client_secret cuando la suscripción aún necesita confirmar el pago (estado pending en el registro hasta entonces).

    Superficie de la API

    RutaMétodosPropósito
    /api/membership/payment/cardPOST, GETCheckout con tarjeta para la membresía
    /api/membership/payment/creditPOST, GETPago con saldo de crédito
    /api/membership/payment/paypalPOST, GETCheckout con PayPal
    /api/membership/payment/tokenPOST, GETPago con token nativo
    /api/membership/subscription/createPOSTCrear una suscripción. El cuerpo incluye provider, auto_renew, billingPeriod
    /api/membership/subscription/statusGETLeer el estado de la suscripción
    /api/membership/subscription/cancelPOST, GETCancelar una suscripción

    La verdad del registro

    1. 1

      Dónde llega el dinero

      Las mejoras pagadas se escriben en el registro de suscripciones (subscription_ledger): el proveedor credit_balance marca las renovaciones pagadas con crédito (next_payment_due indexado en data/schema.sql). El crédito en sí vive en el registro del usuario (users.data.credit_balance), con las transacciones del monedero como pista de auditoría (features/wallet/services/credit-balance-service.ts).

    2. 2

      Periodos de facturación

      MembershipBillingPeriod = 'monthly' | 'yearly'. Coste anual = annualUpgradeAmount si está definido; si no, mensual × 12 × 0.8 (20% de descuento). Forma del nivel: MemberTierConfig { amount, currency, description, duration }.

    currency
    true

    POST /api/membership/subscription/create acepta billingPeriod (monthly por defecto, o yearly) y lo tarifica con getMemberMainCurrencyTierForPeriod. El proveedor Stripe crea un precio anual o mensual según corresponda, envía el importe en céntimos y devuelve client_secret cuando la suscripción aún necesita confirmar el pago (estado pending en el registro hasta entonces).

    Superficie de la API

    RutaMétodosPropósito
    /api/membership/payment/cardPOST, GETCheckout con tarjeta para la membresía
    /api/membership/payment/creditPOST, GETPago con saldo de crédito
    /api/membership/payment/paypalPOST, GETCheckout con PayPal
    /api/membership/payment/tokenPOST, GETPago con token nativo
    /api/membership/subscription/createPOSTCrear una suscripción. El cuerpo incluye provider, auto_renew, billingPeriod
    /api/membership/subscription/statusGETLeer el estado de la suscripción
    /api/membership/subscription/cancelPOST, GETCancelar una suscripción

    La verdad del registro

    1. 1

      Dónde llega el dinero

      Las mejoras pagadas se escriben en el registro de suscripciones (subscription_ledger): el proveedor credit_balance marca las renovaciones pagadas con crédito (next_payment_due indexado en data/schema.sql). El crédito en sí vive en el registro del usuario (users.data.credit_balance), con las transacciones del monedero como pista de auditoría (features/wallet/services/credit-balance-service.ts).

    2. 2

      Periodos de facturación

      MembershipBillingPeriod = 'monthly' | 'yearly'. Coste anual = annualUpgradeAmount si está definido; si no, mensual × 12 × 0.8 (20% de descuento). Forma del nivel: MemberTierConfig { amount, currency, description, duration }.