Zum Hauptinhalt springen

​
Was ist ein Agent?

Ein Agent ist eine eigenständige Entität mit einer eigenen virtuellen Visa-Karte, einem Wallet (für Einzahlung und Saldo) und einer Spending Policy. Wenn Sie einen Agent anlegen, führt Ovra Folgendes aus:
  1. Ovra provisioniert eine virtuelle Visa-Karte für diesen Agent (Übergang zu Visa Network Tokens)
  2. Ovra bindet eine Standard-Spending Policy an (pro Agent anpassbar)
  3. Ovra verknüpft Karte und Wallet mit Ihrem Kundenkonto für Finanzierung, Limits und Reporting
Dies entspricht direkt dem Konzept eines Agentic Profile in Visa Intelligent Commerce — einer Identität mit eigenen Zahlungsdaten, Ausgabenbeschränkungen und Audit Trail.

​
Agent anlegen

curl -X POST https://api.getovra.com/agents \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{"name": "Shopping Agent", "usage": "multi"}'

​
Parameter

FeldTypBeschreibung
namestringAnzeigename des Agents
usage"single" oder "multi"Einmalige Karte (eine Transaktion) oder Mehrfachnutzung

​
Lebenszyklus eines Agents

StatusBeschreibung
activeNormaler Betrieb; die Karte kann autorisieren.
frozenVorübergehend gesperrt; Karte blockiert.
closedDauerhaft geschlossen; nicht rückgängig zu machen.

​
Agent finanzieren

curl -X POST https://api.getovra.com/agents/ag_xxx/fund \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{"amount": 100}'
Im Ovra Sandbox ist die Finanzierung sofort und virtuell. Im Live-Modus kommen die Mittel aus Ihrem SEPA-finanzierten Ovra Wallet / dedizierten IBAN (siehe Funding).

​
Agent-Tokens

Für den autonomen Betrieb stellen Sie eingeschränkte Tokens aus: 
curl -X POST https://api.getovra.com/agents/ag_xxx/tokens \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{"label": "shopping-token", "scopes": ["intents.write", "checkout.write"]}'
Agent-Tokens nutzen das Präfix at_ und können auf bestimmte Operationen beschränkt werden. So gewähren Sie Agents autonomen Zugriff, ohne Ihren API-Key auf Kontoebene weiterzugeben.

​
MCP

Über MCP werden Agents mit dem konsolidierten Tool ovra_agent verwaltet; Aktionen: list, create, get, update, fund, token_list, token_create, token_revoke. Siehe MCP tools.