ASG Card es una plataforma de tarjetas virtuales centrada en agentes. Los agentes de IA emiten y gestionan tarjetas virtuales MasterCard de forma programática, pagando mediante Stellar x402 (USDC) o el Protocolo de Pagos de Máquina de Stripe (tarjeta).

Inicio rápido: Primera tarjeta

# 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

Uso del SDK

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 }

Métodos del SDK

Método	Descripción
`createCard({amount, nameOnCard, email, phone?})`	Emite una tarjeta virtual con pago x402
`fundCard({amount, cardId})`	Recarga una tarjeta existente
`listCards()`	Lista todas las tarjetas de esta billetera
`getTransactions(cardId, page?, limit?)`	Obtiene el historial de transacciones de la tarjeta
`getBalance(cardId)`	Obtiene el saldo actual de la tarjeta
`getPricing()`	Obtiene los precios actuales
`health()`	Comprobación de estado de la API

Servidor MCP (Integración con agentes de IA)

@asgcard/mcp-server expone 11 herramientas para Codex, Claude Code y Cursor:

Herramienta	Descripción
`get_wallet_status`	Usar PRIMERO: dirección de billetera, saldo en USDC, disponibilidad
`create_card`	Crea una tarjeta virtual (pago x402)
`fund_card`	Financia una tarjeta existente (pago x402)
`list_cards`	Lista todas las tarjetas de la billetera
`get_card`	Obtiene el resumen de la tarjeta
`get_card_details`	Obtiene PAN, CVV, fecha de caducidad
`freeze_card`	Congela una tarjeta
`unfreeze_card`	Descongela una tarjeta
`get_pricing`	Ver precios
`get_transactions`	Historial de transacciones de la tarjeta (datos reales de 4payments)
`get_balance`	Saldo actual de la tarjeta desde 4payments

Configuración de MCP

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

Arquitectura

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

Canales de pago

ASG Card admite dos canales de pago. El producto de tarjeta es idéntico; solo difiere el método de pago.

Edición Stellar (x402)

El agente solicita una tarjeta → La API devuelve 402 Payment Required con el importe en USDC
El agente firma una transferencia de USDC en Stellar a través del SDK
El facilitador x402 verifica y liquida el pago en la cadena (on-chain)
La API emite una MasterCard a través del emisor de tarjetas
Los detalles de la tarjeta se devuelven inmediatamente en la respuesta

Usos: SDK, CLI, servidor MCP. Sin intervención humana.

Edición Stripe (MPP)

El agente crea una solicitud de pago → La API devuelve approval_required + approvalUrl
El propietario abre la página de aprobación en stripe.asgcard.dev/approve
El propietario revisa y aprueba → Formulario de Stripe Elements con precios en tiempo real
El propietario paga mediante Stripe → tarjeta/Apple Pay/Google Pay
Tarjeta creada → el agente sondea hasta que se marque como completed

Usos: autenticación basada en sesión (X-STRIPE-SESSION). Aprobación con intervención humana.

Espacio de trabajo

Directorio	Descripción
`/api`	API de ASG Card (Express + x402 + Stripe MPP)
`/sdk`	Cliente TypeScript `@asgcard/sdk`
`/cli`	CLI `@asgcard/cli` con incorporación
`/mcp-server`	Servidor MCP `@asgcard/mcp-server` (11 herramientas)
`/web`	Sitio web de marketing (asgcard.dev)
`/web-stripe`	Sitio de la edición Stripe (stripe.asgcard.dev)
`/docs`	Documentación interna y ADRs

Endpoints de la API

Públicos

Ruta	Método	Descripción
`/health`	GET	Comprobación de estado
`/pricing`	GET	Información de precios
`/cards/tiers`	GET	Información de precios
`/supported`	GET	Capacidades x402

Stellar x402 (Pago requerido)

Ruta	Método	Descripción
`/cards/create/tier/:amount`	POST	Crea una tarjeta virtual
`/cards/fund/tier/:amount`	POST	Financia una tarjeta existente

Autenticados por billetera

Ruta	Método	Descripción
`/cards/`	GET	Lista las tarjetas de la billetera
`/cards/:id`	GET	Detalles de la tarjeta
`/cards/:id/details`	GET	Datos sensibles (se requiere nonce)
`/cards/:id/transactions`	GET	Historial de transacciones de la tarjeta
`/cards/:id/balance`	GET	Saldo actual de la tarjeta
`/cards/:id/freeze`	POST	Congelar tarjeta
`/cards/:id/unfreeze`	POST	Descongelar tarjeta

Stripe MPP (Beta)

Ruta	Método	Descripción
`/stripe-beta/session`	POST	Crea una sesión gestionada
`/stripe-beta/payment-requests`	POST	Crea una solicitud de pago
`/stripe-beta/payment-requests/:id`	GET	Sondea el estado de la solicitud
`/stripe-beta/approve/:id`	GET/POST	Datos de la página de aprobación / aprobar o rechazar
`/stripe-beta/approve/:id/complete`	POST	Completa el pago (credencial MPP)
`/stripe-beta/cards`	GET	Lista las tarjetas de la sesión
`/stripe-beta/cards/:id/details`	GET	Detalles de la tarjeta (se requiere nonce)

Precios

Simple, transparente, sin cargos ocultos.

$10 tarifa plana por creación de tarjeta (no se requiere carga inicial)
3.5% en cada recarga

Eso es todo. Carga cualquier cantidad desde $5 hasta $5,000.

Crear tarjeta sin carga → $10. Crear tarjeta cargada con $100 → $113.50. Recargar $200 después → solo $207. Mismos precios en los canales Stellar y Stripe.

Bot de Telegram (@ASGCardbot)

Vincula tu billetera a Telegram para gestionar tus tarjetas:

Comando	Descripción
`/start`	Bienvenida / Vincular cuenta
`/mycards`	Lista tus tarjetas
`/faq`	Preguntas frecuentes
`/support`	Soporte

Seguridad

Detalles de la tarjeta cifrados en reposo con AES-256-GCM
Protección anti-repetición basada en nonce para agentes (5 lecturas/hora)
Autenticación mediante firma de billetera (edición Stellar)
Autenticación basada en sesión con puertas beta (edición Stripe)
Claves de sesión de Stripe redactadas de los registros
Validación de secreto de webhook de Telegram
Endpoints de operaciones protegidos por clave API + lista blanca de IP

Contribución

¡Agradecemos las contribuciones! Consulta CONTRIBUTING.md para conocer las directrices y revisa los problemas etiquetados como good first issue para empezar.

Este proyecto sigue nuestro Código de conducta.

Licencia

MIT

ASG Card