Zum Hauptinhalt springen

​
1. Konto erstellen

Registrieren Sie sich unter getovra.com/sign-up. Sie starten im Sandbox-Modus: simuliertes Geld und Karten.

​
2. API Key erstellen

Öffnen Sie im Dashboard Secrets und wählen Sie New Key. Exportieren Sie den Key in Ihrer Shell: 
export OVRA_API_KEY="sk_test_..."
Committen Sie niemals Keys und fügen Sie sie nicht in öffentliche Prompts ein.

​
3. Agent erstellen

curl -X POST https://api.getovra.com/agents \
  -H "Authorization: Bearer $OVRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "My First Agent"}'
Beispielantwort (IDs zum Kopieren): 
{
  "id": "ag_xxx",
  "cardId": "ca_xxx",
  "policyId": "po_xxx",
  "cardPanMasked": "****4242",
  "status": "active",
  "cardBalanceEuros": 0
}

​
4. Guthaben aufladen

curl -X POST "https://api.getovra.com/agents/ag_xxx/fund" \
  -H "Authorization: Bearer $OVRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"amount": 100}'
Ersetzen Sie ag_xxx durch die id aus Schritt 3. Im Sandbox erhöht dies das simulierte Ausgabeguthaben, sodass Sie den Checkout sofort testen können.

​
5. Intent deklarieren

curl -X POST https://api.getovra.com/intents \
  -H "Authorization: Bearer $OVRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agentId": "ag_xxx",
    "purpose": "USB-C hub",
    "expectedAmountEuros": 29.99,
    "expectedMerchant": "amazon.de"
  }'
Notieren Sie sich die Intent-id (z.B. in_xxx) und den status. Der Checkout erfordert einen approved Intent. Falls pending_approval angezeigt wird, genehmigen Sie ihn über das Dashboard oder rufen Sie POST /intents/in_xxx/approve mit demselben API Key auf.

​
6. Checkout mit dem SDK abschließen

Installieren Sie das Browser-SDK: 
npm install @ovra/pay

import * as OvraPay from "@ovra/pay";

OvraPay.configure({ apiKey: process.env.OVRA_API_KEY! });

// After your automation navigates to the merchant checkout page:
const result = await OvraPay.checkout(page, { intentId: "in_xxx" });
console.log(result.success);
Das SDK erstellt einen kurzlebigen Fill Token und füllt das Formular innerhalb der Seite aus: Ihr Agent erhält weder PAN noch CVV.

​
Nächste Schritte

  • Intents — Lebenszyklus, Genehmigung und Ablauf
  • Agents — Karten und Policies pro Agent
  • Funding — Wallet-Aufladung (Karte und Bank) in Produktion
  • SDK — @ovra/pay Optionen und Runtimes
  • MCP — Ovra-Tools für Claude, Cursor und andere MCP-Clients