Skip to main content

​
Card Management

This guide walks through connecting payment cards in the Conto dashboard, assigning them to agents, and enforcing spend policies.
Stripe Issuing and Lithic card provisioning is coming soon. Currently, 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)
Stripe Issuing and Lithic are shown in the provider list but marked as Coming Soon. When available, they will allow you to issue new cards directly through Conto.
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).

​
Roadmap

FeatureStatus
Manual card connectionAvailable
Spend policies + MCC controlsAvailable
Card policy linkingAvailable
Stripe Issuing provisioningComing soon
Lithic provisioningComing soon
Provider card importComing soon
Provider state syncComing soon

​
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