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

# Card Management

> Connect and manage payment cards for AI agents in the Conto dashboard

# Card Management

This guide walks through connecting payment cards in the Conto dashboard, assigning them to agents, and enforcing spend policies.

<Info>
  Issuing new cards directly through Conto is not yet generally available. Today, you can connect any existing card manually and enforce the full policy engine on it.
</Info>

## Prerequisites

* A Conto organization with at least one agent

## Connecting a Card

<Steps>
  <Step title="Navigate to Cards">
    Go to **Cards** in the sidebar. Click **Create Card**.
  </Step>

  <Step title="Enter Card Details">
    The **Manual** provider is selected by default. Fill in:

    * **Card name** - A descriptive name (e.g., "Marketing Agent Card")
    * **Last 4 digits** - The last 4 digits of the card number
    * **Brand** - Visa, Mastercard, Amex, or Other
    * **Card type** - Virtual or Physical
    * **Daily limit** - Maximum daily spend (default: \$1,000)
    * **Per-transaction limit** - Maximum per charge (default: \$500)

    <Note>
      Additional providers shown in the list and marked as **Coming Soon** will allow you to issue new cards directly through Conto when generally available.
    </Note>
  </Step>

  <Step title="Card Created">
    The card appears in your cards grid. You can now assign it to an agent.
  </Step>
</Steps>

## Assigning Cards to Agents

Each card can be assigned to one or more agents with independent spend controls.

<Steps>
  <Step title="Open Card Actions">
    On the card tile, click the menu icon and select **Assign to Agent**.
  </Step>

  <Step title="Select Agent">
    Choose an active agent from the dropdown. Agents already linked to this card are filtered out.
  </Step>

  <Step title="Set Agent Limits">
    Configure per-agent spending controls:

    | Setting         | Default    | Description           |
    | --------------- | ---------- | --------------------- |
    | Per-transaction | \$250      | Max amount per charge |
    | Daily           | \$500      | Max daily spend       |
    | Weekly          | (optional) | Max weekly spend      |
    | Monthly         | (optional) | Max monthly spend     |

    Agent limits cannot exceed the card's own limits.
  </Step>

  <Step title="Assign">
    Click **Assign Card**. The agent can now use this card subject to the configured limits.
  </Step>
</Steps>

## Linking Policies

Beyond field-based limits, you can link named policies to cards for advanced rule enforcement.

<Steps>
  <Step title="Open Card Detail">
    Click on a card to open its detail page.
  </Step>

  <Step title="Go to Policies Section">
    In the **Policies** panel, you can see currently linked policies.
  </Step>

  <Step title="Add a Policy">
    Select a policy from the dropdown and click the add button. The policy's rules are immediately enforced on all card transactions.
  </Step>
</Steps>

### Example: Geographic + MCC Policy

Create a policy with these rules, then link it to a card:

```json theme={null}
{
  "name": "US Merchants Only - No Gambling",
  "policyType": "COMPOSITE",
  "priority": 50,
  "rules": [
    {
      "ruleType": "GEOGRAPHIC_RESTRICTION",
      "operator": "NOT_IN",
      "value": "[\"US\", \"CA\"]",
      "action": "DENY"
    },
    {
      "ruleType": "CARD_BLOCKED_MCCS",
      "operator": "IN",
      "value": "[\"7995\", \"7994\"]",
      "action": "DENY"
    }
  ]
}
```

This denies any transaction from outside the US/Canada and blocks gambling MCCs.

## Card Lifecycle

| Action     | Dashboard          | API                           |
| ---------- | ------------------ | ----------------------------- |
| **Pause**  | Menu > Pause Card  | `PATCH /api/cards/{id}/state` |
| **Resume** | Menu > Resume Card | `PATCH /api/cards/{id}/state` |
| **Cancel** | Menu > Cancel Card | `PATCH /api/cards/{id}/state` |

Cancelling a card deactivates all agent links.

## Monitoring

The card detail page shows:

* **Spend stats** - Spent today, per-tx limit, weekly/monthly limits
* **Linked agents** - Each agent's individual limits and status
* **Policies** - Linked policies with rule badges
* **Transactions** - Recent card transactions with merchant details and status

Spend tracking resets automatically at the configured intervals (daily, weekly, monthly).

## Next Steps

<CardGroup cols={2}>
  <Card title="Card Payments API" icon="code" href="/sdk/card-payments">
    Full API reference for card operations
  </Card>

  <Card title="Policy Overview" icon="shield" href="/policies/overview">
    Learn about the policy engine
  </Card>

  <Card title="Securing Agents" icon="lock" href="/guides/securing-agents">
    Security best practices
  </Card>

  <Card title="Policy Testing" icon="flask" href="/guides/policy-testing">
    Test policies before deployment
  </Card>
</CardGroup>