---
type: SPEC
asset_id: SPEC-REB-RClub-ClearingHouse-v01
version: v01
status: Draft — concepto + economía para ratificar
owner: Victor Heredia
sherpa_owner: Jay
ratificador: —
dirigido_a: Victor (ratificación del modelo) + Jesús (arquitectura)
fecha_creacion: 2026-06-16
fecha_ultima_actualizacion: 2026-06-16
intellbank: IB-REB-Rebelocity
subbank: —
tipo_largo: Especificación de concepto y economía del Clearing House — la capa transaccional que convierte el programa de puntos en una red de lealtad financiada por el comercio (merchant-funded), con la tarjeta como riel.
audiencia: Victor + Jesús (dev) + producto + alianzas/sponsors
proposito: Formalizar el modelo económico y los componentes del Clearing House: el spread (MDR del comercio − puntos al socio), los canales de canje ordenados por costo, los flujos de liquidación, el portal de comercio afiliado y la tarjeta como instrumento transaccional. Es la referencia del módulo transaccional de la plataforma.
nota_scope: Modelo transversal de plataforma (aplica a cualquier comunidad con comercios afiliados). Se archiva en IB-REB por ser RClub el piloto. Candidato a copia/referencia en PB-EL-Plataforma.
referencias_canonicas:
  - DC-REB-RClub-SistemaPuntosMembresias-v01 (motor Points v2 base)
  - SPEC-REB-RClub-NumeracionTarjetas-v02 (la tarjeta/PAN como riel transaccional)
  - SPEC-REB-RClub-CatalogosAfiliacion-v01 (grupos = comercios/empresas afiliados)
  - OUT-REB-RClub-RespuestaValidacionPuntos-Jesus-v01 (criterios para dev)
  - RFI-EL-PlataformaComunidades-AfiliacionTarjetaPuntos-v01 (tracking de transacciones presenciales)
  - DC-IS-AnalisisCompetitivo-TDU-MarketplaceColaborativo-v02 (modelo monedero/cashback de referencia)
---

## Asset Header

- **Asset ID:** SPEC-REB-RClub-ClearingHouse-v01
- **Version:** v01 · **Status:** Draft — concepto + economía
- **Owner:** Victor Heredia · **Sherpa:** Jay · **Ratificador:** —
- **IntellBank:** IB-REB-Rebelocity
- **Tipo:** SPEC — Especificación de concepto + economía
- **Última actualización:** 2026-06-16

---

# SPEC · Clearing House — Red de lealtad financiada por el comercio

## La capa que convierte los puntos en margen, con la tarjeta como riel

---

## 0. Tesis

El programa de puntos **no es un costo de fidelización (pasivo); es un generador de ingreso.** En lugar de "regalar" valor, RClub opera una **red de lealtad financiada por el comercio**: el comercio afiliado paga por acceder a la base de socios y adquirir clientes, una parte de ese pago vuelve al socio como puntos, y RClub retiene el spread. El canje se dirige hacia canales que a RClub le cuestan poco o nada. La **tarjeta** (PAN de 16 díg.) es el instrumento que identifica al socio y ancla cada transacción.

---

## 1. El spread — la unidad económica

Parámetros ratificados (Victor, 2026-06-16):

| Parámetro | Valor |
|---|---|
| Valor del punto (ancla) | **1 punto = US$0.02** (100 pts = $2) |
| MDR (lo que paga el comercio) | **7%** del consumo |
| Cashback al socio (en puntos) | **2%** del consumo |
| Margen bruto RClub | **5%** del consumo |

**Ejemplo — compra de $100 en comercio afiliado:**

```
Comercio paga MDR 7%          → +$7.00  (ingreso RClub)
Socio recibe 2% en puntos     → −$2.00  (pasivo diferido = 100 pts)
                                ───────
Margen bruto RClub            →  +$5.00  (5% del GMV)
```

**Margen neto según breakage** (puntos que nunca se canjean — el comercio ya pagó, así que es margen):

| Breakage | Costo real de los puntos | Margen neto |
|---|---|---|
| 0% | $2.00 | **5.0%** del GMV |
| 25% | $1.50 | **5.5%** del GMV |
| 35% | $1.30 | **5.7%** del GMV |

**A escala** (margen neto mensual):

| GMV procesado/mes | @5% | @5.5% (25% breakage) |
|---|---|---|
| $250,000 | $12,500 | $13,750 |
| $1,000,000 | $50,000 | $55,000 |
| $5,000,000 | $250,000 | $275,000 |

> El mismo volumen que como "programa de lealtad" sería **−$73K/mes de pasivo**, como red financiada por el comercio es **+$50K/mes de ingreso**. Ese es el giro.

---

## 2. Los canales de canje, ordenados por costo para RClub

El valor para el socio se mantiene (~2¢/punto); lo que cambia es **cuánto le cuesta a RClub honrarlo**. Como RClub diseña el catálogo, **dirige el canje** hacia lo barato:

| # | Canal | Costo para RClub | Quién lo financia |
|---|---|---|---|
| 1 | **Breakage** (no se canjea) | $0 — margen puro | Nadie (el comercio ya pagó) |
| 2 | **Biblioteca / digital propio** | ~$0 marginal | RClub (bien digital que ya existe) |
| 3 | **Eventos propios** (boletos, slots) | Tu margen de un cupo | RClub, y **llena el evento** (core) |
| 4 | **Regalo de sponsor** (ej. remera UA en Sallutro) | ~$0 | El sponsor/comercio (su costo de adquisición) |
| 5 | Efectivo / comercio externo | Costo real en caja | RClub — **NO se ofrece** |

**Regla de diseño permanente:** cargar el catálogo hacia 1–4, mantener el 5 fuera. Así el programa nunca es pasivo neto.

---

## 3. Componentes del sistema

```
        ┌──────────────┐   compra (tarjeta/QR)   ┌────────────────────┐
        │    Socio     │ ─────────────────────▶ │ Comercio afiliado  │
        │  (tarjeta)   │ ◀───── puntos 2% ────── │  (Portal Comercio) │
        └──────┬───────┘                          └─────────┬──────────┘
               │ canjea                                     │ registra consumo
               ▼                                            ▼  + paga MDR 7%
        ┌─────────────────────────────────────────────────────────────┐
        │                     CLEARING HOUSE (RClub)                    │
        │  · registra transacción (monto · comercio · tarjeta)          │
        │  · calcula MDR a cobrar + puntos a acreditar                  │
        │  · liquida y concilia con el comercio                         │
        │  · procesa canjes contra cada canal (§2)                      │
        └─────────────────────────────────────────────────────────────┘
```

**3.1 Clearing House** (núcleo) — motor de liquidación: registra cada transacción, calcula el MDR que cobra al comercio y los puntos que acredita al socio, concilia cuentas por cobrar (comercio) y por pagar (puntos), y liquida los canjes contra el canal correspondiente.

**3.2 Portal de comercio afiliado** — donde el comercio (a) registra el consumo del socio identificándolo por **número de tarjeta o QR**, (b) ve su estado de cuenta (MDR devengado, periodo de liquidación), y (c) opcionalmente publica recompensas/regalos como promoción (canal 4).

**3.3 La tarjeta como riel** — el PAN de 16 díg. (`…-NumeracionTarjetas-v02`) es la llave: el comercio teclea/escanea el número, el Clearing House valida (Luhn + existencia) y ancla la transacción al socio, su comunidad y —vía el segmento de grupo— al comercio mismo si aplica. La tarjeta deja de ser carnet y se vuelve **instrumento transaccional**.

**3.4 Extensión del motor Points v2** — nueva acción `affiliate_purchase` (2% del monto), que NO la dispara el cliente sino el Clearing House al conciliar la transacción del comercio. Requiere que la transacción de puntos lleve **monto y comercio** (no solo `action_key` fijo) — punto a confirmar con dev.

---

## 4. Flujos de liquidación (settlement)

**4.1 Earning (consumo):**

```
1. Socio compra en comercio afiliado, presenta tarjeta (PAN/QR).
2. Comercio registra en el Portal: monto + PAN.
3. Clearing House valida tarjeta (Luhn + activa) y registra la transacción.
4. Devenga: cuenta por cobrar al comercio = 7% · monto.
5. Acredita al socio: affiliate_purchase = 2% · monto (en puntos).
6. Periódicamente (semanal/mensual) el comercio liquida el MDR devengado.
```

**4.2 Redemption (canje):**

```
1. Socio canjea puntos por ítem del catálogo (§2).
2. Clearing House debita el balance (lifetime NO baja → tier intacto).
3. Liquida contra el canal:
   · Biblioteca → desbloqueo digital inmediato (~$0).
   · Evento → emite cupón/QR de inscripción o slot.
   · Sponsor → genera voucher; el sponsor surte/financia.
4. Registra la transacción de canje (idempotente).
```

**4.3 Conciliación** — cierre por periodo: total MDR cobrado vs. puntos emitidos vs. puntos canjeados vs. breakage acumulado. Reporte de margen por comercio y por comunidad.

---

## 5. Guardrails (no negociables)

- **Los puntos no se canjean por efectivo.** Solo por perks/valor en especie → evita operar cuasi-moneda y su carga regulatoria.
- **El earning fuerte se ata a transacciones que generan ingreso** (consumo afiliado, boletos, membresía, referido que convierte). El earning "gratis" (visita diaria) se mantiene chico.
- **El inventario de canje se financia, en lo posible, por terceros** (sponsors/comercios) o por bienes propios de costo marginal ~$0 (biblioteca, cupos de evento).
- **Lifetime nunca baja por canje** → el tier (estatus) es independiente del gasto de puntos.
- **MDR ≥ 2× el cashback** → spread mínimo garantizado (hoy 7% vs 2% = 3.5×).

---

## 6. Pendientes para v02

| # | Decisión / tarea | Quién |
|---|---|---|
| 1 | Confirmar si Points v2 registra transacción con **monto + comercio** o requiere extensión de esquema | Jesús |
| 2 | Modelo de datos del Clearing House (tablas: `merchant_transactions`, `settlements`, `redemptions`) | Jesús |
| 3 | Definir periodo de liquidación del MDR (semanal vs mensual) y método de cobro al comercio | Victor + finanzas |
| 4 | Onboarding de comercios: contrato MDR 7%, alta en Portal, asignación de grupo de tarjeta | Victor + alianzas |
| 5 | Primeros comercios piloto (¿Sallutro? ¿sponsors actuales Frutika/Powerade?) | Victor |
| 6 | Política de breakage y reglas contables del pasivo de puntos | Victor + finanzas |

---

> **Tripleta WORX** — Owner: Victor Heredia · Sherpa: Jay · Ratificador: pendiente. Modelo económico (§1) ratificado por Victor 2026-06-16; arquitectura y datos quedan Draft hasta cerrar §6.