Integración Banco

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

Módulos que necesitas

Módulo	¿Obligatorio?	Guía
Payout assess	Sí (dispersiones)	Assess de payout
Prevención — pay-in assess	Si hay API de tarjeta/rails	Assess en tiempo real
Claves API	Sí	Claves API
Blocklists (flow_scope)	Sí para payout	Blocklists
Webhooks salientes	Recomendado	Recibir webhooks
Resiliencia de assess	Sí (prod)	Resiliencia de assess
Expedientes y regulatorio	Sí (CLM-MOD-OPS)	Gestión de expedientes
Reportar fraude	Sí	Reportar fraude
Inteligencia Clausum	Si está contratado	Red de inteligencia
Ingest de eventos	Opcional	Ingest de eventos
SDK para navegador	Raro	Generalmente N/A para banca core

Fases de integración

Fase 1 — Core y claves

Confirma migraciones SQL para payout (079 blocklists flow_scope, 080 assess_flow) con tu equipo Clausum.
Conexiones → Claves API — claves Secret (clm_sk_*) solo desde middleware core — nunca en canales.
Documenta política fail-open — Resiliencia de assess.

Fase 2 — Prevención payout (principal)

Llama assess antes de autorizar SPEI, wire o transferencia interna:

{
  "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
  }
}

POST /api/v1/assess/payout con clm_sk_*.
Con decline → no liberes fondos; registra session_id en el registro de transferencia.
Carga blocklists CLABE/IBAN con flow_scope: payout — Blocklists.
Prueba vía POST /api/v1/simulation/payout en el Panel de Control.

Playbook completo: Assess de payout.

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

Fase 4 — Webhooks y conciliación core

URL saliente para transaction.created, transaction.blocked, case.created.
Mapea session_id a ids de transacción core.
Ingest opcional para eventos de switch — Ingest de eventos.

Fase 5 — Operaciones y red

Gestión de expedientes para expedientes y envío regulatorio.
Reportar fraude alimenta blocklists automáticamente.
Si CLM-MOD-INST / add-ons de inteligencia: sigue Red de inteligencia Clausum — habilita contribución en Inteligencia, solicita CLM-ADD-NET-C para consumo.
UAT en cert.clausum.ai cuando se proporcione para sign-off.

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

Primeros pasos

Integración por tipo de cliente

Soluciones y prevención

Capacidades — eventos y operaciones

Panel de control

Conceptos clave

Referencia

Integración Banco

Módulos que necesitas

Fases de integración

Campos obligatorios de assess

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

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

Señales payout a esperar

Checklist de go-live

Enlaces de capacidades

Assess payout

Blocklists

Expedientes

Red de inteligencia

Todas las capacidades

​Módulos que necesitas

​Fases de integración

​Campos obligatorios de assess

​Pay-in (POST /api/v1/assess)

​Payout (POST /api/v1/assess/payout)

​Señales payout a esperar

​Checklist de go-live

​Enlaces de capacidades

Assess payout

Blocklists

Expedientes

Red de inteligencia

Todas las capacidades

Módulos que necesitas

Fases de integración

Campos obligatorios de assess

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

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

Señales payout a esperar

Checklist de go-live

Enlaces de capacidades