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

# Quickstart

> First pay-in assess, optional payout, and webhooks in under 15 minutes

## Prerequisites

* Clausum account with **Dashboard** access
* **Conexiones → Claves API** — create a secret key (`clm_sk_*`) with **Assess** permission
* For **outbound webhooks**: **Conexiones → Entrada (webhooks)** — create an ingest key (`clm_wh_*`) only if you send events *to* Clausum; for *receiving* events from Clausum, configure **URL de webhook** in the same hub

## 1. Create an API key

1. **Dashboard → Conexiones → Claves API**
2. **Create key** → type **Secret** → enable **Assess**
3. Store the key securely (shown once)

## 2. Run your first pay-in assess

```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>

| Field      | Rule                                                                                                          |
| ---------- | ------------------------------------------------------------------------------------------------------------- |
| `amount`   | **Major units** with decimal (`45.00` = \$45.00 USD). Legacy: integer cents without `amount_unit` still works |
| `order_id` | Top-level idempotency key (required in production)                                                            |
| `decision` | `approve` · `review` · `challenge` · `decline`                                                                |

## 3. (Optional) Payout assess

If you disburse funds, use [`POST /api/v1/assess/payout`](/guides/payout-assessment) with beneficiary and origin account fields.

## 4. Receive webhooks

1. **Conexiones → Entrada (webhooks)** → **URL de webhook**
2. Subscribe to `transaction.created`, `transaction.blocked`, etc.
3. Verify `X-Clausum-Signature` (see [Receiving webhooks](/guides/receiving-webhooks))

## 5. Browser SDK (optional)

For checkout pages without a backend assess call first:

```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>
```

See [Browser SDK](/guides/browser-sdk).

## Next steps

Choose your segment for the full integration plan, or jump to a capability:

<CardGroup cols={2}>
  <Card title="Merchant guide" icon="store" href="/segments/merchant">
    Comercio — checkout integration
  </Card>

  <Card title="PSP guide" icon="sitemap" href="/segments/psp">
    Sub-merchant routing
  </Card>

  <Card title="Bank guide" icon="building-columns" href="/segments/bank">
    Payout + institutional
  </Card>

  <Card title="Capability catalog" icon="table-list" href="/concepts/capabilities">
    All modules by segment
  </Card>
</CardGroup>