Puntos en la Tienda

Con puntos en la Tienda, los puntos que la persona gana participando pasan a valer algo concreto: una mentoría, una entrada, una camiseta, un curso. El equipo da a un producto un precio en puntos, además del precio en dinero o en su lugar, y la persona lo canjea con su saldo.

#Puntos y saldo

Cada persona pasa a tener dos cuentas:

Todo lo que quita puntos (quitar un me gusta, borrar una publicación, un ajuste negativo) quita saldo también, así que el saldo puede quedar negativo. Con saldo negativo, la persona no canjea nada hasta volver a positivo.

Ajuste del equipo a sí mismo. Un ajuste positivo de puntos que alguien del equipo se da a sí mismo cuenta en los puntos, pero no en el saldo: nadie del equipo se da puntos para vaciar la Tienda. El ajuste hecho por un workflow no cuenta como "a sí mismo".

#Activar

La función nace desactivada, y solo el propietario y el administrador la activan. Al activarla por primera vez, eliges:

• El nombre de la moneda: puntos (el predeterminado), monedas, PapoCoins…
• Cómo empieza el saldo: con los puntos que cada persona ya tiene hoy, o desde cero (a partir de entonces, solo lo que se gane). La elección vale una vez: desactivar y volver a activar no reabre el saldo, sigue donde estaba.

Antes de guardar, la vista previa muestra cuántos puntos hay en circulación. Con la gamificación desactivada, los puntos y el saldo se congelan, y un producto solo en puntos queda no disponible.

#El precio en puntos

Cada producto elige cómo se paga:

• Aceptan puntos los productos de pago único: digital (mentoría, hotseat, experiencia), físico, entrada de evento (el precio es por tipo de entrada), curso y descarga.
• No aceptan: suscripción, pago a plazos, reserva (que tiene los créditos), adicionales y opciones de plan.
• No hay pago mixto (parte en puntos y parte en dinero). El cupón no vale en el precio en puntos, y una empresa no compra con puntos: los puntos son de la persona.
• Stock, plazas, lote de entradas y "1 por persona" valen como en la compra en dinero.

#El canje

• La persona ve el precio en puntos y, cuando no tiene suficientes, cuánto le falta.
• Cada canje es una unidad. Un producto físico pide la dirección de entrega.
• El canje sigue las mismas reglas de acceso que la compra en dinero: un producto de una Tienda que la persona no abre, o un curso, evento o descarga de un espacio cerrado para ella, no se puede canjear.
• La compra queda completada al momento, con el acceso liberado como en una compra gratuita. No pasa por el procesador de pago, no tiene tarifa de la plataforma y no entra en los ingresos, en el saldo por cobrar ni en los retiros.
• La persona recibe el correo de compra, con "N puntos" en lugar del importe. En las ventas de la comunidad, la compra aparece como pagada con puntos.

#Devolución

Solo el equipo devuelve una compra con puntos, como una compra en dinero (ver Reembolsos y contracargos). La devolución es total: devuelve todos los puntos al saldo, quita el acceso y devuelve la unidad al stock. No hay devolución parcial.

#Lo que nunca pasa con los puntos

Los puntos no se compran con dinero, no se convierten en dinero y no se transfieren entre personas. Son un programa de participación de la comunidad, no un medio de pago.

Aviso fiscal. La compra con puntos tiene un valor en dinero de cero: Memberfy no emite documento fiscal por ella. Entregar un producto físico o un servicio a cambio de puntos es una obligación de la comunidad (como un albarán o un registro de obsequio, cuando corresponda). Consulta a tu asesor fiscal: Memberfy no orienta sobre normas fiscales.

#Ejemplos

Mentoría por puntos. La comunidad crea el producto Hotseat de 30 min (digital, 1 por persona, stock 10), solo en puntos: 2.000. Ana tiene 3.400 puntos y saldo 3.400; lo canjea. El saldo pasa a 1.400, y los puntos y el nivel siguen en 3.400.

Entrada con las dos formas. El Meetup SP cuesta R$ 40 o 800 puntos. Bruno, con saldo 300, ve que le faltan 500 puntos y paga con PIX.

#Quién puede

#En la API

• GET y PUT /api/points/settings (propietario y administrador): enabled, currencyName y el inicio del saldo (current, los puntos de hoy, o zero), con la circulación y la vista previa.
• GET /api/points/me y GET /api/points/members/{memberId} (la propia persona, o propietario y administrador): saldo, puntos, nivel y el extracto de ganancias, gastos, devoluciones, aperturas y ajustes excluidos.
• Producto: pricingMode (MONEY, el predeterminado, POINTS o POINTS_OR_MONEY) y pointsPrice; fuera de los tipos aceptados, 400 en pricingMode. Un producto solo en puntos queda con price 0.
• POST /api/storefront/products/{productId}/redeem (el miembro; Idempotency-Key opcional, la misma clave devuelve la misma compra): la compra COMPLETED con paymentMethod: "POINTS" y pointsPaid. Saldo insuficiente: 400 points.insufficient, con data.missing; función o gamificación desactivadas: 409. Fuera de las reglas de acceso, 403 monetization.purchase.notPurchasable.
• El checkout en dinero, la compra gratuita y el cupón rechazan un producto solo en puntos.
• El escaparate trae pricingMode, pointsPrice, free, pointsAvailable y pointsShortfall; las compras, paidWithPoints y pointsPaid. La devolución de una compra con puntos responde source: "POINTS" y pointsReturned.
• Webhooks: purchase.completed con pointsPaid y purchase.refunded con paymentMethod: "POINTS" y pointsReturned, solo en las compras con puntos. Consulta Webhooks.

#Con el asistente (MCP)

Pide que active los puntos como moneda ("activa los puntos como moneda, llamados monedas", update_points_settings), que dé precio en puntos a un producto (pricing_mode y points_price en create_product), ver el saldo de alguien (get_member_points) o el tuyo (get_my_points), y canjear un producto (redeem_product_with_points, con confirmación). El reembolso de una compra con puntos es refund_purchase.

#Relacionados

• Gamificación
• Productos
• Tienda
• Reembolsos y contracargos