> ## 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.

# Integración Banco

> Integración para instituciones financieras — rails pay-in, payout assess, expedientes e inteligencia Clausum

Para **`organization_type = banco`**: operas banca core, switches o plataformas de tesorería. Típicamente integras **pay-in assess** (cuando aplique) y **payout assess** antes de dispersiones, más módulos institucionales (expedientes, [red de inteligencia Clausum](/es/guides/clausum-intelligence-network)).

## Módulos que necesitas

| Módulo | ¿Obligatorio? | Guía |
| - | - | - |
| **Payout assess** | Sí (dispersiones) | [Assess de payout](/es/guides/payout-assessment) |
| **Prevención — pay-in assess** | Si hay API de tarjeta/rails | [Assess en tiempo real](/es/guides/realtime-assessment) |
| **Claves API** | Sí | [Claves API](/es/guides/api-keys) |
| **Blocklists (flow\_scope)** | Sí para payout | [Blocklists](/es/concepts/blocklists) |
| **Webhooks salientes** | Recomendado | [Recibir webhooks](/es/guides/receiving-webhooks) |
| **Resiliencia de assess** | Sí (prod) | [Resiliencia de assess](/es/guides/assess-resilience) |
| **Expedientes y regulatorio** | Sí (CLM-MOD-OPS) | [Gestión de expedientes](/es/guides/case-management) |
| **Reportar fraude** | Sí | [Reportar fraude](/es/guides/report-fraud) |
| **Inteligencia Clausum** | Si está contratado | [Red de inteligencia](/es/guides/clausum-intelligence-network) |
| **Ingest de eventos** | Opcional | [Ingest de eventos](/es/guides/event-ingestion) |
| **SDK para navegador** | Raro | Generalmente N/A para banca core |

## Fases de integración

<Steps>
  <Step title="Fase 1 — Core y claves">
    1. Confirma migraciones SQL para payout (`079` blocklists `flow_scope`, `080` assess\_flow) con tu equipo Clausum.
    2. **Conexiones → Claves API** — claves **Secret** (`clm_sk_*`) solo desde middleware core — nunca en canales.
    3. Documenta política fail-open — [Resiliencia de assess](/es/guides/assess-resilience).
  </Step>

  <Step title="Fase 2 — Prevención payout (principal)">
    Llama assess **antes** de autorizar SPEI, wire o transferencia interna:

    ```json theme={null}
    {
      "amount": 25000.00,
      "amount_unit": "major",
      "currency": "MXN",
      "beneficiary": {
        "id": "ben_core_001",
        "name": "Beneficiary SA",
        "country": "MX",
        "clabe": "012180001234567890"
      },
      "origin": { "account_id": "acct_orig_01", "country": "MX" },
      "payout": {
        "channel": "spei",
        "initiated_by": "ops@bank.com",
        "first_to_beneficiary": false
      }
    }
    ```

    1. `POST /api/v1/assess/payout` con `clm_sk_*`.
    2. Con `decline` → **no** liberes fondos; registra `session_id` en el registro de transferencia.
    3. Carga blocklists CLABE/IBAN con `flow_scope: payout` — [Blocklists](/es/concepts/blocklists).
    4. Prueba vía `POST /api/v1/simulation/payout` en el Panel de Control.

    Playbook completo: [Assess de payout](/es/guides/payout-assessment).
  </Step>

  <Step title="Fase 3 — Pay-in (si aplica)">
    Cuando tu API expone aceptación de tarjeta o pago instantáneo:

    * `POST /api/v1/assess` con `payment_id`, `customer_id` como referencias core
    * `order_id` generalmente N/A fuera de e-commerce
    * Campos en vivo: `GET /api/v1/assess` → `field_requirements_by_segment.bank`
  </Step>

  <Step title="Fase 4 — Webhooks y conciliación core">
    1. URL saliente para `transaction.created`, `transaction.blocked`, `case.created`.
    2. Mapea `session_id` a ids de transacción core.
    3. Ingest opcional para eventos de switch — [Ingest de eventos](/es/guides/event-ingestion).
  </Step>

  <Step title="Fase 5 — Operaciones y red">
    1. [Gestión de expedientes](/es/guides/case-management) para expedientes y envío regulatorio.
    2. [Reportar fraude](/es/guides/report-fraud) alimenta blocklists automáticamente.
    3. Si **CLM-MOD-INST** / add-ons de inteligencia: sigue [Red de inteligencia Clausum](/es/guides/clausum-intelligence-network) — habilita contribución en **Inteligencia**, solicita **CLM-ADD-NET-C** para consumo.
    4. UAT en `cert.clausum.ai` cuando se proporcione para sign-off.
  </Step>
</Steps>

## Campos obligatorios de assess

### Pay-in (`POST /api/v1/assess`)

| Campo | Nivel |
| - | - |
| `amount`, `currency` | **Obligatorio** |
| `payment_id` | Recomendado — referencia core / switch |
| `customer_id` | Recomendado — id de cuenta o parte |
| `order_id` | Opcional |

### Payout (`POST /api/v1/assess/payout`)

| Campo | Nivel |
| - | - |
| `amount`, `currency` | **Obligatorio** |
| `beneficiary` | **Obligatorio** — country, name, clabe, iban o account\_hash |
| `origin.account_id`, `origin.country` | Recomendado |
| `payout.channel` | Recomendado — `spei`, `wire`, `api` |

Catálogo en vivo: `GET /api/v1/assess/payout`.

## Señales payout a esperar

| Señal | Disparador típico |
| - | - |
| `payout_first_beneficiary` | Primera transferencia al beneficiario |
| `payout_high_risk_country` | Jurisdicción del beneficiario |
| `payout_cross_border_high_amount` | Cross-border por encima del umbral |
| Acierto en blocklist | CLABE / IBAN / beneficiary\_id |

## Checklist de go-live

* [ ] Migraciones `079` + `080` aplicadas en Supabase de producción
* [ ] Blocklists payout cargadas con `flow_scope` correcto
* [ ] Core llama assess de forma síncrona antes de liberar transferencia
* [ ] Fallback `503` / `504` aprobado por comité de riesgo
* [ ] Flujo de expedientes y roles configurados
* [ ] UAT de certificación completado en el host de stage asignado

## Enlaces de capacidades

<CardGroup cols={2}>
  <Card title="Assess payout" icon="money-bill-transfer" href="/es/guides/payout-assessment">
    API de dispersión
  </Card>

  <Card title="Blocklists" icon="ban" href="/es/concepts/blocklists">
    flow\_scope y tipos payout
  </Card>

  <Card title="Expedientes" icon="folder-open" href="/es/guides/case-management">
    Expedientes
  </Card>

  <Card title="Red de inteligencia" icon="network-wired" href="/es/guides/clausum-intelligence-network">
    Contribuir y consumir señales
  </Card>

  <Card title="Todas las capacidades" icon="table-list" href="/es/concepts/capabilities">
    Catálogo de módulos
  </Card>
</CardGroup>


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