Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://docs.getovra.com/llms.txt

Use this file to discover all available pages before exploring further.

Dieser Walkthrough führt von Null zu einer abgeschlossenen Sandbox-Transaktion. Du erstellst ein Konto, enthüllst deinen API-Key, registrierst den MCP-Server, erstellst Agent + Karte, deklarierst einen Intent und simulierst eine Belastung.
Alles in diesem Quickstart läuft in Sandbox. Kartennummern, IBANs und Webhooks sind live-shaped, aber kein echtes Geld bewegt sich.
1

Anmelden

Sandbox-Invite anfragen unter getovra.com/sign-up. Sobald angenommen, anmelden — deine Sandbox-Org, IBAN, Default-Policy und API-Key werden auto-provisioniert.
Das Reveal-Modal zeigt deinen sk_sandbox_* Key einmal. Jetzt kopieren. Du kannst ihn später über Dashboard → API Keys rotieren.
export OVRA_API_KEY="sk_sandbox_..."
2

MCP-Server verbinden (optional)

Der MCP-Server gibt jedem LLM-Client (Claude Desktop, Cursor, Kiro etc.) alle 19 Ovra-Tools.
{
  "mcpServers": {
    "ovra": {
      "command": "npx",
      "args": ["@ovra/mcp@latest"],
      "env": { "OVRA_API_KEY": "sk_sandbox_..." }
    }
  }
}
Client neu starten. Du solltest 19 ovra_* Tools sehen. Siehe MCP-Setup für erweiterte Konfiguration.
3

Agent erstellen

Ein Agent ist eine first-class Entity — er besitzt Karten, Tokens, Transaktionen und eine Policy. Das Minimal-Form-Feld-Set ist name + purpose + policyId.
curl -X POST https://api.getovra.com/agents \
  -H "Authorization: Bearer $OVRA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "name": "procurement-bot",
    "policyId": "po_default_...",
    "profile": { "purpose": "Bürobedarf unter EUR 100 kaufen" }
  }'
Returnt { id: "ag_...", status: "active", ... }.
4

Karte für den Agent ausstellen

Jede Karte ist an einen Agent gebunden und innerhalb dieses Agents eindeutig benannt. Mehrere Karten pro Agent sind möglich (subscriptions, travel, one-off).
curl -X POST https://api.getovra.com/cards \
  -H "Authorization: Bearer $OVRA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "agentId": "ag_...",
    "name": "default",
    "usage": "multi",
    "purpose": "Default-Karte für Procurement"
  }'
Returnt { id: "ca_...", last4: "4242", status: "active", ... }. PAN und CVV sind AES-256-GCM verschlüsselt at rest und werden auf diesem Endpoint nie im Klartext zurückgegeben.
5

Intent deklarieren

Kein Geld bewegt sich ohne genehmigten Intent. Policy-Engine und Risk-Engine laufen während dieses Calls.
curl -X POST https://api.getovra.com/intents \
  -H "Authorization: Bearer $OVRA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "agentId": "ag_...",
    "cardId": "ca_...",
    "purpose": "Pack USB-C Hubs",
    "expectedAmountEuros": 29.99,
    "expectedMerchant": "amazon.de"
  }'
Wenn Policy auto-approved, bekommst du { status: "approved" } zurück. Sonst pending_approval — vom Dashboard oder via POST /intents/:id/approve freigeben.
6

Belastung simulieren

In Sandbox kannst du den Merchant-Call abkürzen:
curl -X POST https://api.getovra.com/simulate/charge \
  -H "Authorization: Bearer $OVRA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "intentId": "int_...",
    "amountEuros": 29.99,
    "merchant": "amazon.de"
  }'
Returnt eine tx_*-Row mit status: "completed". Der passende transaction.completed Webhook feuert sofort, wenn du eine Subscription registriert hast.

​
Echte Merchant-Flows

Der simulate-Endpoint ist ein Stand-In. Für echte Merchant-Calls den passenden Modus wählen:

MPP

Merchant returnt 402 mit WWW-Authenticate: Payment. Mit POST /v1/mpp/pay eine JWE-wrapped Credential minten und in einem Call settlen.

CUA

Merchant hat nur ein Checkout-Formular. Autofill-Token via POST /v1/cua/autofill-tokens minten, der Harness füllt das Formular mit einem tokenisierten DPAN.

​
Weiter

Die sechs Säulen

Tour durch Bezahlung, Karten, Konten, Einzug, Steuerung und Intelligenz.

Policies

Festlegen, was dein Agent ausgeben darf, wo und wann.

Webhooks

Die ~50 Event-Typen in deine eigenen Systeme verdrahten.

MCP-Tools

Die vollständige action-multiplexed Referenz für alle 19 Tools.