> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clausum.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Protección por comercio PSP

> Establece una plantilla de protección para todos los comercios, propaga defaults y personaliza comercios individuales cuando haga falta.

Los PSP gestionan muchos comercios hijos bajo **una organización**. Clausum usa un modelo simple:

1. **Plantilla** — defaults para cada comercio (umbrales, alertas, ajuste de score).
2. **Propagar** — empuja la plantilla a todos los hijos no personalizados con un clic.
3. **Personalizar** — override de reglas y alertas para un comercio específico cuando haga falta.

Las reglas a nivel org en **Protección** siguen aplicando a todos. La configuración por comercio **suma** encima — no reemplaza tu política base.

## Dónde configurar

| Tarea | Ruta en panel |
| - | - |
| Plantilla + propagación | **Comercios → Plantilla y propagación** (`/dashboard/submerchants/protection`) |
| Portafolio | **Comercios** (`/dashboard/submerchants`) |
| Detalle por comercio | **Comercios → \[comercio] → Protección** |
| Reglas y blocklists org-wide | **Protección** (`/dashboard/protection`) |

<Note>
  Las APIs de plantilla de protección requieren **sesión del panel** (admin/owner). Las claves Partner API pueden establecer **overrides por comercio** vía `PATCH /api/v1/partner/submerchants/{id}` — consulta [Comercios PSP](/es/guides/psp-submerchants).
</Note>

### Panel

| Superficie | Path | Qué obtienes |
| - | - | - |
| Inicio (PSP) | `/dashboard` | Tarjeta compacta de resumen de portafolio |
| Portafolio | `/dashboard/submerchants` | Tabla de stats, tiers de riesgo, drill-down |
| Plantilla | `/dashboard/submerchants/protection` | Defaults + propagar |
| Detalle hijo | `/dashboard/submerchants/[id]` | Protección enterprise + alertas |

APIs (sesión del panel): `GET /api/v1/submerchants/portfolio`, `GET /api/v1/submerchants/[id]/stats`, rutas de defaults de protección.

## Paso 1 — Establecer la plantilla

Abre **Comercios → Plantilla y propagación** y configura:

| Campo | Qué hace |
| - | - |
| Ajuste de score | Suma al score de riesgo para cada comercio heredado |
| Monto máximo | Tope por pago (unidades mayores de moneda) |
| Umbrales approve / decline | Bandas de score para approve vs decline |
| Alertas habilitadas | Crea reglas de alerta default por comercio (pico de volumen, score alto) |

Haz clic en **Guardar plantilla** para almacenar sin tocar hijos existentes.

## Paso 2 — Propagar

Haz clic en **Guardar y propagar a no personalizados** para:

* Actualizar cada comercio con `customized = false`
* Sincronizar reglas de alerta desde la plantilla
* **Omitir** comercios que ya marcaste como personalizados

Verás un resumen: cuántos se actualizaron vs omitieron.

<Tip>
  Registra comercios primero ([Comercios PSP](/es/guides/psp-submerchants)). Cada hijo nuevo obtiene automáticamente un perfil que hereda la plantilla.
</Tip>

## Paso 3 — Personalizar un comercio

Abre un comercio → **Protección**:

| Switch | Efecto |
| - | - |
| **Heredar plantilla org** (on) | Usa plantilla + reglas org en **Protección** |
| **Marcar como personalizado** (on) | Detiene propagación; habilita reglas con scope y overrides de alerta solo para este hijo |

Cuando está personalizado, assess fusiona:

* Reglas org (`psp_submerchant_id` null)
* Reglas y blocklists con scope de comercio
* Overrides de plantilla/perfil (umbrales, ajuste de score, monto máximo)

Las entradas con scope de comercio **ganan** sobre defaults org cuando ambas coinciden en la misma señal.

## Cómo lo usa assess

Cada `POST /api/v1/assess` con `submerchant_id` resuelve el perfil efectivo antes del scoring:

```mermaid theme={null}
flowchart TD
  A[Assess request + submerchant_id] --> B{Registered submerchant?}
  B -->|No| C[Org rules only]
  B -->|Yes| D[Load protection profile]
  D --> E{Inherits template?}
  E -->|Yes| F[Merge org template + org rules]
  E -->|No / customized| G[Merge profile overrides + scoped rules]
  F --> H[Decision + alerts]
  G --> H
```

## Alertas

Alertas default de plantilla (cuando están habilitadas):

| Alerta | Trigger |
| - | - |
| Pico de volumen | Volumen de transacciones vs baseline (ratio ≥ 2.5) |
| Score de riesgo alto | Score ≥ 0.75 |

Las alertas se almacenan por comercio en `behavior_alert_rules`. Personaliza roles de notificación en la plantilla o por comercio.

## Partner API (solo overrides)

Ajustes programáticos por comercio (org-level `clm_sk_*` con `submerchants:write`):

```bash theme={null}
curl -X PATCH "$CLAUSUM_API_BASE/api/v1/partner/submerchants/{id}" \
  -H "Authorization: Bearer $CLAUSUM_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "inherits_defaults": false,
    "customized": true,
    "protection": { "score_adjustment": 10, "max_amount_major": 5000 },
    "thresholds": { "decline": 70 }
  }'
```

Guardar plantilla y propagar siguen siendo **solo panel** hoy.

## Guías relacionadas

<CardGroup cols={2}>
  <Card title="Comercios PSP" icon="sitemap" href="/es/guides/psp-submerchants">
    Registro, claves y assess
  </Card>

  <Card title="Espacio de protección" icon="shield" href="/es/guides/protection-workspace">
    Reglas y blocklists org-wide
  </Card>

  <Card title="Integración PSP" icon="building-columns" href="/es/segments/psp">
    Ruta completa de onboarding PSP
  </Card>

  <Card title="Monitor de transacciones" icon="chart-line" href="/es/guides/transaction-monitor">
    Alertas y reglas de comportamiento
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.