Esta página es una traducción automática de la página en inglés, que es la versión de referencia. Leer la página en inglés
Mecenas (planes de pago)
Solo cuando un administrador lo activa, los usuarios locales pueden suscribirse a un plan de pago en la web y conservar el rol vinculado al plan mientras sigan pagando. El programa está desactivado por defecto y no aparece ningún punto de entrada a planes ni suscripciones hasta que se activa.
La clave de despliegue payments se describe en la referencia de configuración.
mycroblog no garantiza el cumplimiento de ninguna ley, incluida la Ley japonesa de Transacciones Comerciales Específicas. Los operadores deben comprobar el contenido de la divulgación comercial, la pantalla de confirmación final y el tratamiento del impuesto sobre el consumo y de las facturas conforme a las leyes de su propio país (consulta «Qué deben comprobar los operadores» más abajo).
Cómo funciona una suscripción
Sección titulada «Cómo funciona una suscripción»De arriba abajo en el diagrama:
- Suscripción. El usuario elige un plan y un intervalo (mes o año) en
/settings/supporter. Tras la confirmación final, el servidor (my serve) crea la página de pago en el proveedor indicado enpayments(stripeopayjp), y el usuario paga en esa página. - Eventos. El proveedor envía sus eventos al endpoint de webhook
POST /payments/webhooks/{provider}, que registra cada evento una sola vez y encola un trabajo. Un evento es solo una señal: el servidor nunca toma el estado de su contenido. - Lectura de vuelta. El trabajo
supporters.apply_payment_event, y la conciliaciónsupporters.reconcile_paymentscadapayments_reconcile_interval, leen de vuelta la suscripción y los movimientos de dinero desde la API del proveedor. La conciliación repara cualquier evento que no haya llegado. - El estado y el rol. El servidor deriva el estado de la suscripción a partir de lo que ha leído y de cada plazo vencido (por ejemplo, el período de gracia de 7 días), y con ello concede o retira el rol del plan.
- Ingresos. Los movimientos de dinero se convierten en registros de ingresos (importe bruto, comisión e importe neto de cada pago, reembolso, contracargo y comisión). Sus totales se muestran en la pantalla de finanzas (
/finance, para quienes tienenview_finance) y, en la medida que permitaincome_visibility, en/about/costs(consulta instance-settings.md).
Los estados de una suscripción, tal como los muestran la administración y my admin supporters subscriptions:
pending: iniciada, aún sin pagar. Sin rol. El primer pago la pasa aactive, y una suscripción que termina antes de su primer pago pasa aabandoned.active: pagada. Conserva el rol del plan, que cada renovación mantiene.past_due: un pago ha fallado. Conserva el rol durante 7 días desde el fallo; un pago en ese tiempo la devuelve aactive.lapsed: han pasado 7 días desde el fallo. Se retira el rol. Un pago posterior la devuelve aactivey el rol vuelve.canceling: cancelada al final del período. Conserva el rol hasta entonces y pasa aexpired.expired,revoked(un reembolso total o un contracargo) yabandonedson finales y no conservan ningún rol.
Activar el programa
Sección titulada «Activar el programa»- Define la clave de despliegue
paymentscon tu proveedor de pagos y pasa las claves del proveedor y el secreto del webhook. Los pasos específicos de cada proveedor están en payments-stripe.md y payments-payjp.md. El programa no puede activarse mientras la clave esnone. - Configura el servidor para que envíe correo (
maildistinto denone). Solo los usuarios con una dirección de correo confirmada pueden suscribirse, así que un servidor que no envía correo no puede activar el programa. - En la página «Divulgación comercial» de «Términos y políticas» en la administración (
/admin/documents/commerce-disclosure), escribe en Markdown la divulgación comercial (para Japón, el aviso que exige la Ley de Transacciones Comerciales Específicas), el texto de la instanciacommerce_disclosure. Se publica en/about/commerce, y puedes registrar esa URL en el panel del proveedor. El programa puede activarse con el texto vacío, pero la administración muestra una advertencia. - En «Roles» en la administración, crea el rol que vincular al plan. No debe tener titulares, solo permisos de miembro (grupo
member), y unapositioninferior a la de todo rol del personal,moderatorincluido. Los permisos de miembro son las ventajas que puede dar un plan:create_custom_emojis(solicitar emoji personalizados),view_finance(leer las finanzas del servidor),start_voice_rooms(abrir salas de chat de voz mientras solo pueden las personas autorizadas),create_invites(invitar a personas mientras solo pueden las personas autorizadas, dentro de los límites de las invitaciones de miembros),keep_posts_longer(conservar publicaciones más allá del máximo de la eliminación automática, y desactivar la eliminación automática mientras el máximo está activado),create_articles(escribir artículos mientras solo pueden las personas autorizadas; consulta artículos) ycreate_events(crear eventos mientras solo pueden las personas autorizadas). Cuando la suscripción termina, el rol se va, y también las ventajas: las invitaciones que creó el mecenas dejan de funcionar hasta que se suscriba de nuevo, y el máximo de la eliminación automática se aplica de nuevo a sus publicaciones tras su periodo de gracia. - En «Mecenas» en la administración (permiso
manage_supporters), abre la página «Planes» (/admin/supporters/plans) y elige «Crear un plan». Define el nombre, la descripción, el precio mensual, el descuento por pago anual, el límite mensual de creación de emoji personalizados (se restablece el primer día de cada mes, UTC; consulta emoji personalizados), el orden y la visibilidad, y elige el rol: el formulario enumera los roles que pueden recibir un plan, o, sin el permisomanage_roles, pide la clave del rol. El servidor crea los precios mensual y anual en el proveedor (no crees precios en el panel del proveedor). Hasta que los precios existen, el plan está «en preparación» y no acepta suscripciones. - En la primera página de «Mecenas» (
/admin/supporters), elige «Activar el programa». La página dice qué falta mientras el programa no puede activarse, y muestra el proveedor de pagos de la configuración, que solo cambia la configuración.
Una vez que existe un plan, su rol ya no puede concederse ni revocarse a mano, y cambias sus permisos y su posición en la página del plan (elige el plan en la página «Planes»). Un plan superior (un orden mayor) se sitúa por encima de los roles de los planes inferiores, tiene todos sus permisos y tiene un límite de emoji al menos tan alto como el de ellos.
Configuración en el proveedor
Sección titulada «Configuración en el proveedor»- Desactivación: un suscriptor no puede desactivar su cuenta mientras la suscripción está viva, incluida una configurada para terminar al final de su periodo. La pantalla de configuración lo lleva a la suscripción, para que no se cobre a nadie mientras está oculto.
- Reintentos (dunning): siete días después de que falle un pago, el servidor quita el rol (independientemente de los reintentos del proveedor). Define el periodo de reintentos del proveedor en al menos 7 días y haz que la acción final sea «cancelar». Cuando el pago tiene éxito tras el periodo de gracia, el rol vuelve.
- Comprobar el proveedor: la sección «Proveedor de pagos» de la primera página de «Mecenas» muestra el modo del proveedor (de prueba o real), la última entrega del webhook y la última conciliación con el motivo por el que se detuvo, y avisa cuando el webhook parece sin definir. «Conciliar ahora» ejecuta una conciliación de inmediato, como máximo una vez por hora.
- Portal del cliente: el portal se abre para métodos de pago y facturas. Desactiva los cambios de plan en el portal y permite solo la cancelación al final del periodo. Los cambios de plan y las cancelaciones se hacen en las propias pantallas del servidor.
- Reembolsos: el servidor reembolsa solo un pago que no compró nada: una segunda suscripción de un mismo pago, y un pago de una suscripción pendiente que se cerró. La guía del proveedor (Stripe, PAY.JP) describe ambos. Todo otro reembolso es del operador, en el panel del proveedor. Un reembolso completo y una contracargo quitan el rol de inmediato y cancelan de inmediato la suscripción del proveedor. Un reembolso parcial no quita el rol. Ganar una contracargo no restablece el rol; el usuario se suscribe de nuevo.
Lo que ven los usuarios
Sección titulada «Lo que ven los usuarios»- En la web, el usuario abre «Planes de apoyo» (
/settings/supporter), elige un plan y un intervalo de pago (mes o año), pasa por una pantalla de confirmación final y continúa a la página de pago del proveedor. Los datos de la tarjeta nunca pasan por este servidor. La página de pago vuelve a esta pantalla, que entonces lee de nuevo el estado de la suscripción. Mientras está suscrito, el usuario puede cambiar de plan desde la misma pantalla (una mejora de plan y un cambio de mensual a anual se aplican una vez pagada su diferencia prorrateada, mientras que una rebaja de plan y un cambio de anual a mensual se aplican al final del período), cancelar un cambio programado, cancelar la suscripción (las ventajas duran hasta el final del período) y deshacer una cancelación, y abrir el portal de clientes para métodos de pago y facturas. Cuando falla el pago de un cambio, o la tarjeta pide una autenticación que el cambio no puede solicitar, el plan se mantiene y el usuario ve un error con la forma de actualizar la tarjeta. No inicia el período de gracia ni envía la notificación de pago fallido; una renovación fallida sí lo hace. - Solo pueden suscribirse los usuarios de este servidor que tengan una dirección de correo electrónico confirmada y una cuenta que no esté suspendida ni programada para su eliminación. Un usuario puede tener un plan a la vez.
/aboutmuestra una sección con los planes públicos. En la aplicación Tauri no aparecen la pantalla de suscripción, la sección de planes de/aboutni los enlaces a ellas. Las ventajas (insignia, emojis personalizados, finanzas) también funcionan en la aplicación.
Notificaciones a los suscriptores
Sección titulada «Notificaciones a los suscriptores»Se avisa a los suscriptores una sola vez de cada uno de los siguientes hechos, mediante notificación, Web Push y correo electrónico (a la dirección principal, en el idioma del usuario). A un suscriptor cuya cuenta está desactivada no se le avisa de nada, ni entonces ni al volver.
- Fallo de pago (
supporter_payment_failed): cuando la suscripción pasa a vencida (past_due). Indica el final del período de gracia (en UTC en el correo) y un enlace a la pantalla donde se puede corregir el método de pago (/settings/supporter). - Fin de la suscripción (
supporter_subscription_ended): cuando una suscripción sale de un estado con ventajas porque se agotó el período de gracia, expiró, o terminó con un reembolso o un contracargo. El mensaje indica el motivo. No se avisa de un fin causado por eliminar la cuenta. - Retirada del plan (
supporter_plan_retired): a los suscriptores de un plan retirado (salvo los pendientes). Indica que la suscripción no se renovará. - Anuncio del fin del servicio (
supporter_service_closure): a los suscriptores cuya suscripción estaba cancelada al final de su período cuando empezó el anuncio (salvo los pendientes). Indica que la suscripción no se renovará. Durante el anuncio no se aceptan nuevas suscripciones.
El texto de Web Push y de las notificaciones no lleva a la pantalla de pago. Solo el cliente web pone en una notificación un enlace a la pantalla de suscripción; la aplicación Tauri no. Los enlaces de los correos abren el cliente web en un navegador.
my admin supporters realiza parte de las operaciones de la administración (my admin supporters -help).
status: si el programa está activado, qué necesita antes de poder activarse (un proveedor, correo electrónico) y el número de suscripciones en curso.enable,disable: activan y desactivan el programa. La desactivación se rechaza mientras haya alguna suscripción en curso.plans: la lista de planes (incluidos los retirados), con el número de planes en preparación y retirados y de suscripciones.subscriptions: la lista de suscripciones (filtra con-plany-state).cancel <subscription ID>cancela una suscripción de inmediato (sin reembolso, salvo un pago de una suscripción pendiente, que no compró nada).
Activar, desactivar y cancelar se escriben en el registro de auditoría como operaciones de la CLI. Crear, cambiar y retirar planes se hace en la administración o mediante la API de administración.
La lista de miembros
Sección titulada «La lista de miembros»- El ajuste de la instancia
supporter_list_visibility(la sección «Lista de mecenas» de la primera página de «Mecenas», para un administrador conmanage_settings; consulta instance-settings.md) elige quién puede ver la lista de suscriptores actuales (/about/supporters). Con el valor predeterminadooff, no aparece ni la lista ni el enlace desde/about. - La lista muestra solo a los suscriptores que eligieron figurar en la página «Insignias y lista de mecenas» de su configuración (por defecto no figura nadie). Muestra el nombre del plan y el avatar, el nombre para mostrar y el identificador de cada persona, y nunca importes, si el pago es mensual o anual, fechas ni recuentos.
- La elección de figurar se conserva cuando el suscriptor cambia de plan, y desaparece cuando la suscripción termina (se quita el rol). Quien se suscribe de nuevo empieza sin figurar.
- La página de la lista y su API envían siempre
noindex, noarchive, diga lo que diga el ajuste de motores de búsqueda (search_indexing).
Cambiar precios, ocultar planes y retirar planes
Sección titulada «Cambiar precios, ocultar planes y retirar planes»- Cuando cambias el precio mensual o el descuento, el precio nuevo se aplica a las suscripciones nuevas y a los cambios de plan. Los suscriptores existentes renuevan a su precio original. No hay ninguna operación para pasar a los suscriptores existentes a un precio nuevo. Para pasarlos, crea un plan nuevo y retira el antiguo.
- Ocultar un plan detiene las suscripciones nuevas y los cambios a ese plan. Las suscripciones existentes continúan.
- Retirar un plan («Retirar el plan…» en su página, tras escribir su nombre) no se puede deshacer. Sus suscripciones se cancelan al final de su periodo (las pendientes se cierran de inmediato y su página de pago deja de aceptar pagos, con reembolso de todo pago que aún llegue; y aquellas cuyo pago se retrasa más allá del periodo de gracia se cancelan de inmediato). Cuando termina la última suscripción, el rol vuelve a ser un rol ordinario.
Cuentas y suscripciones
Sección titulada «Cuentas y suscripciones»- Eliminar una cuenta y vetarla (lo que programa su eliminación) cancelan sus suscripciones de inmediato, sin reembolso (un pago de una suscripción aún pendiente no compró nada, y se reembolsa). Revertir un veto no restablece las suscripciones.
- Suspender una cuenta programa la cancelación al final del periodo. Levantar la suspensión no la restablece automáticamente; el usuario cancela la cancelación antes del final del periodo o se suscribe de nuevo.
- En la página «Suscripciones» de «Mecenas» (
/admin/supporters/subscriptions, filtrada por plan y estado), un administrador puede abrir una suscripción y terminarla de inmediato con «Terminar ahora…», tras escribir el identificador del suscriptor (sin reembolso, salvo un pago de una suscripción pendiente, que no compró nada; se anota en el registro de auditoría).
Desactivar el programa y cambiar de proveedor
Sección titulada «Desactivar el programa y cambiar de proveedor»- El programa no se puede desactivar mientras haya alguna suscripción en curso (pendiente, activa, programada para cancelarse, vencida o pasado el período de gracia). Retira primero todos los planes y desactiva el programa cuando las suscripciones hayan terminado.
- Para cambiar de proveedor, desactiva el programa, cambia
paymentsy vuelve a activar el programa con el nuevo proveedor. Los suscriptores existentes se suscriben de nuevo. Mientras el proveedor configurado difiera de aquel con el que se activó el programa, el servidor rechaza nuevas suscripciones y cambios, y la administración muestra una advertencia.
Propinas
Sección titulada «Propinas»Una propina es un pago único de un usuario local para el funcionamiento del servidor, sin nada a cambio: no da ningún rol, insignia ni otra ventaja, y el usuario ve solo un agradecimiento una vez pagada. Las propinas están desactivadas por defecto, no necesitan ningún plan y van solo al operador: los usuarios no pueden darse propina entre sí, y no hay objetivos, campañas ni saldos.
- Qué necesitan: el programa de mecenas activado en el proveedor configurado, y un proveedor que acepte pagos únicos. La sección Propinas de la primera página de la pantalla Mecenas (permiso
manage_supporters) muestra si los usuarios pueden dar propina ahora y avisa cuando el proveedor no acepta pagos únicos;GET /api/v1/admin/supporter_tipsinforma de lo mismo: si tu proveedor los acepta (one_time_payments), el importe menor y mayor que permite en cada moneda (limits) y si los usuarios pueden dar propina ahora (accepting). Stripe los acepta (consulta Propinas en Stripe), PAY.JP los acepta en su página alojada de la API v2 (consulta Propinas en PAY.JP), y también el proveedor de prueba de las compilaciones de prueba. - Importes: eliges de 1 a 6 importes en una moneda, yenes o dólares estadounidenses, cada uno de 100 ¥ a 100 000 ¥ o de 1 US$ a 1000 US$ y al menos el cargo único mínimo del proveedor. Los usuarios eligen uno de ellos y nunca escriben un importe; el mínimo evita que una propina pequeña cueste más de lo que aporta cuando se disputa.
- Activar, cambiar y desactivar: en la sección Propinas, marca Aceptar propinas, elige la moneda, escribe los importes uno por línea y selecciona Guardar las propinas; desmarca la casilla y guarda para desactivarlas. La API es
PUT /api/v1/admin/supporter_tipscon{"enabled": true, "amounts": [{"amount": "500", "currency": "JPY"}, ...]}, o{"enabled": false}. Cada cambio se escribe en el registro de auditoría (supporter_tips_enabled,supporter_tips_revised,supporter_tips_disabled). Desactivar el programa de mecenas detiene también las propinas; un checkout ya abierto sigue siendo pagable hasta que termina, y un pago en él se registra igualmente. - Quién puede dar propina: los usuarios de este servidor con una dirección de correo confirmada cuya cuenta no está suspendida ni programada para eliminación. No hace falta una suscripción. Los inicios están limitados a 5 por hora y 20 por día para cada usuario, y a 100 por hora para todo el servidor, lo que detiene el card testing (probar tarjetas robadas con pagos pequeños);
server_limit_reacheddice que se alcanzó el límite del servidor en la última hora. - Pagar: los usuarios llegan a la página de propinas (
/settings/supporter/tip) desde la sección Propinas de la página «Acerca de», bajo el medidor de financiación en la columna lateral, y desde la página de planes de mecenas; a un visitante que no ha iniciado sesión se le ofrece iniciar sesión primero. La página confirma el importe, que se paga una sola vez de inmediato y que no se da nada a cambio, con un enlace a tu divulgación comercial, antes de la página del proveedor. La página alojada del proveedor acepta el pago único, solo con tarjeta, y sigue siendo pagable durante una hora. Un usuario tiene como máximo una propina abierta: iniciar otra hace antes impagable la página anterior, y cuando la anterior se pagó entretanto, el usuario es enviado a su agradecimiento en lugar de pagar dos veces. En la aplicación Tauri, las propinas no aparecen. - Ingresos: una propina pagada se contabiliza una vez en el mes en que se pagó, ya sea que la notifique primero el evento del proveedor, el regreso desde la página o la conciliación. Sus reembolsos y contracargos se contabilizan en su propio mes y se restan de los ingresos. Los totales de los administradores muestran por separado el neto de las suscripciones, las propinas y el resto del dinero de la cuenta del proveedor, y su lista de movimientos de dinero muestra quién pagó cada propina mientras la cuenta existe. Los totales públicos,
/financey/about/costsnunca muestran una propina individual, el importe de las propinas ni cuántas hubo; conincome_visibilitydefinido enplans, la lista de planes termina con una fila «Propinas» sin número. - Reembolsos y disputas: el servidor no tiene ninguna operación de reembolso para las propinas. Reembolsa en el panel del proveedor; un reembolso completo, una contracargo y una disputa ganada se registran con la propina, y un reembolso parcial solo en los ingresos. Cada disputa también cuesta la tarifa de disputa del proveedor (con Stripe en Japón, 1500 ¥ en el momento de escribir esto), sea cual sea el importe de la propina.
- Cuentas: eliminar una cuenta y vetarla hace impagable la página de su propina abierta. Borrar la cuenta elimina sus propinas; sus ingresos permanecen, sin el usuario. El proveedor conserva el pago y la dirección de correo que rellenó su página, que el servidor no puede eliminar: dilo en tu política de privacidad.
La métrica my.supporter.tip_checkouts cuenta los inicios (started), los inicios que rechazaron los límites (rate_limited) y las propinas que se pagaron (paid) o terminaron sin pagar (expired). Dos ejemplos de alertas:
- Un aumento brusco de inicios:
sum(rate(my_supporter_tip_checkouts_total{my_outcome=~"started|rate_limited"}[15m]))muy por encima de su nivel habitual durante 15 minutos. - Muchos inicios que nunca se pagan:
sum(increase(my_supporter_tip_checkouts_total{my_outcome="expired"}[1h])) / sum(increase(my_supporter_tip_checkouts_total{my_outcome="started"}[1h]))por encima de 0,8 con al menos 20 inicios.
Comprobar con el proveedor si acepta propinas, según su revisión y sus condiciones, te corresponde a ti. Redacta todos los textos de las propinas, tu divulgación comercial incluida, como una propina para el funcionamiento del servicio, nunca como una donación, una deducción ni una recaudación para una causa.
Qué deben comprobar los operadores (aún sin verificar)
Sección titulada «Qué deben comprobar los operadores (aún sin verificar)»mycroblog no juzga ninguno de estos puntos. Compruébalos conforme a las leyes de tu país y los términos de tu proveedor.
- Los elementos que debe contener la divulgación comercial (nombre, dirección y teléfono del vendedor, el precio, cuándo y cómo pagar, cuándo se presta el servicio, cómo cancelar, etc.) y cómo debe publicarse.
- Que la pantalla de confirmación final (artículo 12-6 de la Ley de Transacciones Comerciales Específicas) muestre la cantidad, el precio, el momento del pago, el momento de la entrega y la forma de cancelar y su efecto, tomando conjuntamente la página de pago del proveedor y la pantalla de confirmación de
my. - El tratamiento del impuesto sobre el consumo y si emites facturas cualificadas.
- Para las propinas: si tu proveedor acepta propinas por el funcionamiento de un servicio (PAY.JP cuenta las «propinas» entre los bienes que le cuesta aprobar, y Stripe en Japón puede no aceptarlas de un empresario individual; pregunta al proveedor), qué dice de ellas la divulgación comercial (qué es una propina, los importes, que se paga de una vez, que no se da nada a cambio y cómo se gestionan los reembolsos), y su impuesto sobre el consumo y su impuesto sobre la renta, que debe confirmar un asesor fiscal.
Para LLM y agentes de programación:llms.txt,llms-full.txt, llms-small.txt