Skip to main content

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

This guide walks through connecting payment cards in the Conto dashboard, assigning them to agents, and enforcing spend policies.
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.

​
Prerequisites

  • A Conto organization with at least one agent

​
Connecting a Card

1

Navigate to Cards

Go to Cards in the sidebar. Click Create Card.
2

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)
Additional providers shown in the list and marked as Coming Soon will allow you to issue new cards directly through Conto when generally available.
3

Card Created

The card appears in your cards grid. You can now assign it to an agent.

​
Assigning Cards to Agents

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

Open Card Actions

On the card tile, click the menu icon and select Assign to Agent.
2

Select Agent

Choose an active agent from the dropdown. Agents already linked to this card are filtered out.
3

Set Agent Limits

Configure per-agent spending controls:
SettingDefaultDescription
Per-transaction$250Max amount per charge
Daily$500Max daily spend
Weekly(optional)Max weekly spend
Monthly(optional)Max monthly spend
Agent limits cannot exceed the card’s own limits.
4

Assign

Click Assign Card. The agent can now use this card subject to the configured limits.

​
Linking Policies

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

Open Card Detail

Click on a card to open its detail page.
2

Go to Policies Section

In the Policies panel, you can see currently linked policies.
3

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.

​
Example: Geographic + MCC Policy

Create a policy with these rules, then link it to a card: 
{
  "name": "US Merchants Only - No Gambling",
  "policyType": "CUSTOM",
  "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

ActionDashboardAPI
PauseMenu > Pause CardPATCH /api/cards/{id}/state
ResumeMenu > Resume CardPATCH /api/cards/{id}/state
CancelMenu > Cancel CardPATCH /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

Card Payments API

Full API reference for card operations

Policy Overview

Learn about the policy engine

Securing Agents

Security best practices

Policy Testing

Test policies before deployment