ASG Card ist eine Agent-First Plattform für virtuelle Karten. KI-Agenten stellen programmatisch virtuelle MasterCards aus und verwalten diese, wobei die Bezahlung über Stellar x402 (USDC) oder das Stripe Machine Payments Protocol (Karte) erfolgt.

Schnellstart — Erste Karte

# One-step onboarding (creates wallet, configures MCP, installs skill)
npx @asgcard/cli onboard -y --client codex

# Fund your wallet with USDC on Stellar (address shown by onboard)
# Then:
npx @asgcard/cli card:create -a 10 -n "AI Agent" -e you@email.com

SDK-Nutzung

import { ASGCardClient } from "@asgcard/sdk";

const client = new ASGCardClient({
  privateKey: "S...",  // Stellar secret key
  rpcUrl: "https://mainnet.sorobanrpc.com"
});

// Automatically handles: 402 → USDC payment → card creation
const card = await client.createCard({
  amount: 10,        // $10 card load
  nameOnCard: "AI Agent",
  email: "agent@example.com"
});

// card.detailsEnvelope = { cardNumber, cvv, expiryMonth, expiryYear }

SDK-Methoden

Methode	Beschreibung
`createCard({amount, nameOnCard, email, phone?})`	Virtuelle Karte mit x402-Zahlung ausstellen
`fundCard({amount, cardId})`	Bestehende Karte aufladen
`listCards()`	Alle Karten für diese Wallet auflisten
`getTransactions(cardId, page?, limit?)`	Transaktionsverlauf der Karte abrufen
`getBalance(cardId)`	Live-Kartenguthaben abrufen
`getPricing()`	Aktuelle Preise abrufen
`health()`	API-Gesundheitsprüfung

MCP-Server (KI-Agenten-Integration)

@asgcard/mcp-server stellt 11 Tools für Codex, Claude Code und Cursor bereit:

Tool	Beschreibung
`get_wallet_status`	Zuerst verwenden — Wallet-Adresse, USDC-Guthaben, Bereitschaft
`create_card`	Virtuelle Karte erstellen (x402-Zahlung)
`fund_card`	Bestehende Karte aufladen (x402-Zahlung)
`list_cards`	Alle Wallet-Karten auflisten
`get_card`	Kartenübersicht abrufen
`get_card_details`	PAN, CVV, Ablaufdatum abrufen
`freeze_card`	Karte einfrieren
`unfreeze_card`	Karte auftauen
`get_pricing`	Preise anzeigen
`get_transactions`	Transaktionsverlauf der Karte (echte 4payments-Daten)
`get_balance`	Live-Kartenguthaben von 4payments

MCP-Einrichtung

npx @asgcard/cli install --client codex    # or claude, cursor

Architektur

graph TB
    subgraph Clients
        SDK["@asgcard/sdk<br>(npm, TypeScript)"]
        CLI["@asgcard/cli<br>onboard + card ops"]
        MCP["@asgcard/mcp-server<br>11 tools"]
        TG["Telegram Bot<br>@ASGCardbot"]
        WEB["asgcard.dev"]
        STRIPE_WEB["stripe.asgcard.dev"]
    end

    subgraph ASG Infrastructure
        API["ASG Card API<br>api.asgcard.dev"]
        FAC["x402 Facilitator"]
        DB["PostgreSQL"]
    end

    subgraph Payment Rails
        STELLAR["Stellar Pubnet<br>USDC"]
        STRIPE["Stripe<br>MPP"]
    end

    subgraph External
        ISSUER["Card Issuer<br>(MasterCard)"]
    end

    SDK -->|"x402 HTTP"| API
    CLI -->|"x402 HTTP"| API
    MCP -->|"x402 HTTP"| API
    TG -->|"Webhook"| API
    WEB -->|"Pricing"| API
    STRIPE_WEB -->|"MPP"| API
    API -->|"verify/settle"| FAC
    API -->|"SQL"| DB
    API -->|"REST"| ISSUER
    FAC -->|"Soroban RPC"| STELLAR
    API -->|"PaymentIntent"| STRIPE
    SDK -->|"Sign TX"| STELLAR

Zahlungswege

ASG Card unterstützt zwei Zahlungswege. Das Kartenprodukt ist identisch — nur die Zahlungsmethode unterscheidet sich.

Stellar Edition (x402)

Agent fordert eine Karte an → API gibt 402 Payment Required mit USDC-Betrag zurück
Agent signiert eine Stellar USDC-Überweisung über das SDK
x402 Facilitator verifiziert und begleicht die Zahlung on-chain
API stellt eine MasterCard über den Kartenaussteller aus
Kartendetails werden sofort in der Antwort zurückgegeben

Nutzung: SDK, CLI, MCP-Server. Kein Mensch im Prozess erforderlich.

Stripe Edition (MPP)

Agent erstellt eine Zahlungsanforderung → API gibt approval_required + approvalUrl zurück
Besitzer öffnet die Genehmigungsseite unter stripe.asgcard.dev/approve
Besitzer prüft und genehmigt → Stripe Elements-Formular mit Echtzeit-Preisen
Besitzer zahlt über Stripe → Karte/Apple Pay/Google Pay
Karte erstellt → Agent fragt den Status ab, bis completed erreicht ist

Nutzung: Sitzungsbasierte Authentifizierung (X-STRIPE-SESSION). Genehmigung durch Menschen erforderlich.

Arbeitsbereich

Verzeichnis	Beschreibung
`/api`	ASG Card API (Express + x402 + Stripe MPP)
`/sdk`	`@asgcard/sdk` TypeScript-Client
`/cli`	`@asgcard/cli` CLI mit Onboarding
`/mcp-server`	`@asgcard/mcp-server` MCP-Server (11 Tools)
`/web`	Marketing-Website (asgcard.dev)
`/web-stripe`	Stripe Edition-Website (stripe.asgcard.dev)
`/docs`	Interne Dokumentation und ADRs

API-Endpunkte

Öffentlich

Route	Methode	Beschreibung
`/health`	GET	Gesundheitsprüfung
`/pricing`	GET	Preisinformationen
`/cards/tiers`	GET	Preisinformationen
`/supported`	GET	x402-Funktionen

Stellar x402 (Zahlung erforderlich)

Route	Methode	Beschreibung
`/cards/create/tier/:amount`	POST	Virtuelle Karte erstellen
`/cards/fund/tier/:amount`	POST	Bestehende Karte aufladen

Wallet-Authentifiziert

Route	Methode	Beschreibung
`/cards/`	GET	Karten der Wallet auflisten
`/cards/:id`	GET	Kartendetails
`/cards/:id/details`	GET	Sensible Daten (Nonce erforderlich)
`/cards/:id/transactions`	GET	Transaktionsverlauf der Karte
`/cards/:id/balance`	GET	Live-Kartenguthaben
`/cards/:id/freeze`	POST	Karte einfrieren
`/cards/:id/unfreeze`	POST	Karte auftauen

Stripe MPP (Beta)

Route	Methode	Beschreibung
`/stripe-beta/session`	POST	Verwaltete Sitzung erstellen
`/stripe-beta/payment-requests`	POST	Zahlungsanforderung erstellen
`/stripe-beta/payment-requests/:id`	GET	Anforderungsstatus abfragen
`/stripe-beta/approve/:id`	GET/POST	Daten der Genehmigungsseite / genehmigen oder ablehnen
`/stripe-beta/approve/:id/complete`	POST	Zahlung abschließen (MPP-Berechtigungsnachweis)
`/stripe-beta/cards`	GET	Karten der Sitzung auflisten
`/stripe-beta/cards/:id/details`	GET	Kartendetails (Nonce erforderlich)

Preise

Einfach, transparent, keine versteckten Gebühren.

$10 Pauschale für die Kartenerstellung (keine anfängliche Aufladung erforderlich)
3,5 % auf jede Aufladung

Das ist alles. Lade einen beliebigen Betrag von $5 bis $5.000 auf.

Karte ohne Guthaben erstellen → $10. Karte mit $100 Guthaben erstellen → $113,50. Später $200 aufladen → nur $207. Gleiche Preise für Stellar- und Stripe-Wege.

Telegram-Bot (@ASGCardbot)

Verknüpfe deine Wallet mit Telegram für die Kartenverwaltung:

Befehl	Beschreibung
`/start`	Willkommen / Konto verknüpfen
`/mycards`	Deine Karten auflisten
`/faq`	FAQ
`/support`	Support

Sicherheit

Kartendetails im Ruhezustand mit AES-256-GCM verschlüsselt
Agent-Nonce-basierter Anti-Replay-Schutz (5 Lesezugriffe/Stunde)
Wallet-Signatur-Authentifizierung (Stellar Edition)
Sitzungsbasierte Authentifizierung mit Beta-Gates (Stripe Edition)
Stripe-Sitzungsschlüssel aus Protokollen entfernt
Validierung des Telegram-Webhook-Geheimnisses
Ops-Endpunkte durch API-Schlüssel + IP-Allowlist geschützt

Mitwirken

Wir freuen uns über Beiträge! Bitte lies CONTRIBUTING.md für Richtlinien und schau dir Issues mit dem Label good first issue an, um loszulegen.

Dieses Projekt folgt unserem Code of Conduct.

Lizenz

MIT

ASG Card