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

# Inicio rápido

> Primer assess pay-in, payout opcional y webhooks en menos de 15 minutos

## Requisitos previos

* Cuenta Clausum con acceso al **Panel de Control**
* **Conexiones → Claves API** — crea una clave secreta (`clm_sk_*`) con permiso **Assess**
* Para **webhooks salientes**: **Conexiones → Empezar → Webhooks salientes** — configura la URL HTTPS donde Clausum entrega eventos. Para **ingest entrante** (eventos que envías a Clausum), usa **Entrada (webhooks)** y crea una clave de ingest (`clm_wh_*`)

## 1. Crear una clave API

1. **Panel de Control → Conexiones → Claves API**
2. **Crear clave** → tipo **Secret** → habilita **Assess**
3. Guarda la clave de forma segura (se muestra una sola vez)

## 2. Ejecutar tu primer assess pay-in

```bash theme={null}
curl -X POST "https://dashboard.clausum.ai/api/v1/assess" \
  -H "Authorization: Bearer clm_sk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-$(uuidgen)" \
  -d '{
    "amount": 45.00,
    "amount_unit": "major",
    "currency": "USD",
    "order_id": "ord_quickstart_001",
    "customer": {
      "email": "buyer@example.com",
      "ip_address": "203.0.113.10"
    },
    "device": { "fingerprint": "fp_demo_001" }
  }'
```

<ResponseExample>
  ```json Success theme={null}
  {
    "decision": "approve",
    "risk_score": 12,
    "signals": [],
    "session_id": "ps_abc123",
    "assess_flow": "payin"
  }
  ```
</ResponseExample>

| Campo | Regla |
| - | - |
| `amount` | **Unidades mayores** con decimal (`45.00` = \$45.00 USD). Legacy: enteros en centavos sin `amount_unit` aún funciona |
| `order_id` | Clave de idempotencia de nivel superior (obligatorio en producción) |
| `decision` | `approve` · `review` · `challenge` · `decline` |

## 3. (Opcional) Payout assess

Si dispersas fondos, usa [`POST /api/v1/assess/payout`](/es/guides/payout-assessment) con campos de beneficiario y cuenta de origen.

## 4. Recibir webhooks

1. **Conexiones → Entrada (webhooks)** → **Webhook URL**
2. Suscríbete a `transaction.created`, `transaction.blocked`, etc.
3. Verifica `X-Clausum-Signature` (consulta [Recibir webhooks](/es/guides/receiving-webhooks))

## 5. SDK para navegador (opcional)

Para páginas de checkout sin una llamada assess en backend primero:

```html theme={null}
<script src="https://dashboard.clausum.ai/clausum-sdk.js"></script>
<script>
  Clausum.init({
    publishableKey: "clm_pub_...",
    apiUrl: "https://dashboard.clausum.ai"
  });
</script>
```

Consulta [SDK para navegador](/es/guides/browser-sdk).

## Próximos pasos

Elige tu segmento para el plan de integración completo, o salta a una capacidad:

<CardGroup cols={2}>
  <Card title="Guía Comercio" icon="store" href="/es/segments/merchant">
    Comercio — integración de checkout
  </Card>

  <Card title="Guía PSP" icon="sitemap" href="/es/segments/psp">
    Enrutamiento por subcomercio
  </Card>

  <Card title="Guía Banco" icon="building-columns" href="/es/segments/bank">
    Payout + institucional
  </Card>

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


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