Wenn Sie einen Agenten oder ein Backend bauen, das Geld ausgeben muss, brauchen Sie Karten, die Sie per Code erstellen und verwalten können. Dieser Leitfaden führt vollständig durch die Cryptocardium Karten-API – dieselbe Oberfläche ist als REST für klassische Dienste und als MCP Server für LLM-Agenten verfügbar.
Authentifizierung und Berechtigungen
Jeder Aufruf wird mit einem Bearer-API-Schlüssel authentifiziert, der in Ihrem Dashboard erstellt wurde. Schlüssel tragen Berechtigungen, damit Sie einem Agenten genau die Rechte geben können, die er benötigt – und nicht mehr.
cards:issue— neue Karten erstellen.cards:fund— Guthaben auf eine Karte übertragen.cards:read— Kartendetails und Transaktionen abrufen.cards:control— Limits setzen, einfrieren, schließen.
Eine Karte ausgeben
Erstellen Sie eine virtuelle Karte mit einer einzigen Anfrage. Wählen Sie einen BIN, der auf den Anwendungsfall abgestimmt ist – Werbung, SaaS, Wallets oder Premium-Ausgaben – und geben Sie ihr ein Label, damit Sie sie später finden können.
curl -X POST https://cryptocardium.com/api/v1/cards \
-H "Authorization: Bearer ck_live_…" \
-H "Content-Type: application/json" \
-d '{ "type": "virtual", "brand": "visa", "label": "ads-agent" }'{
"id": "card_9f2a1c",
"brand": "visa",
"last4": "4417",
"status": "active",
"balance_usd": 0.00
}Mit Krypto aufladen
Eine neue Karte startet mit einem Nullsaldo. Laden Sie sie aus dem Krypto-Guthaben Ihres Kontos auf – die Karte ist sofort bis zu diesem Betrag einsetzbar.
curl -X POST https://cryptocardium.com/api/v1/cards/card_9f2a1c/fund \
-H "Authorization: Bearer ck_live_…" \
-d '{ "amount_usd": 200, "asset": "USDT" }'Ausgabekontrollen setzen
Begrenzen Sie jede Karte, bevor Sie sie einem Agenten übergeben. Limits und Händlerregeln werden zum Autorisierungszeitpunkt serverseitig durchgesetzt.
curl -X POST https://cryptocardium.com/api/v1/cards/card_9f2a1c/limits \
-H "Authorization: Bearer ck_live_…" \
-d '{ "monthly_usd": 200, "daily_usd": 50, "mcc_allow": ["5818"] }'Mit Webhooks abrechnen
Abonnieren Sie Autorisierungs-Events und verifizieren Sie die Signatur jeder Zustellung. So bleiben Ihr Hauptbuch und Ihr Agent ohne Polling synchron.
// POST an Ihre Webhook-URL
{
"event": "authorization",
"card_id": "card_9f2a1c",
"amount_usd": 19.99,
"merchant": "Cloud API Inc",
"mcc": "5818",
"result": "approved"
}
// header: X-Signature: sha256=…Derselbe Ablauf über MCP
Wenn ein LLM-Agent die Karten selbst steuern soll, zeigen Sie einen MCP-Client auf den Server, anstatt einen REST-Client zu schreiben. Der Agent sieht issue_card, fund_card und set_card_limits als native Tools – den Einrichtungsleitfaden finden Sie unter MCP Server Guide.
Alles zusammen
Mit einem eingeschränkten Schlüssel authentifizieren, eine Karte ausgeben, sie aus Krypto aufladen, begrenzen und über Webhooks abrechnen. Das ist der vollständige Kreislauf, den ein Agent braucht, um sicher Geld auszugeben. Eröffnen Sie ein Konto und erstellen Sie Ihren ersten Schlüssel, um es auszuprobieren.
