ASG Card — это платформа виртуальных карт, ориентированная на автономных агентов. ИИ-агенты программно выпускают и управляют виртуальными картами MasterCard, оплачивая их через Stellar x402 (USDC) или Stripe Machine Payments Protocol (банковская карта).

Быстрый старт — Первая карта

# 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

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

Метод	Описание
`createCard({amount, nameOnCard, email, phone?})`	Выпуск виртуальной карты с оплатой x402
`fundCard({amount, cardId})`	Пополнение существующей карты
`listCards()`	Список всех карт для этого кошелька
`getTransactions(cardId, page?, limit?)`	Получение истории транзакций по карте
`getBalance(cardId)`	Получение текущего баланса карты
`getPricing()`	Получение актуальных тарифов
`health()`	Проверка работоспособности API

MCP Server (Интеграция с ИИ-агентами)

@asgcard/mcp-server предоставляет 11 инструментов для Codex, Claude Code и Cursor:

Инструмент	Описание
`get_wallet_status`	Использовать ПЕРВЫМ — адрес кошелька, баланс USDC, готовность
`create_card`	Создание виртуальной карты (оплата x402)
`fund_card`	Пополнение существующей карты (оплата x402)
`list_cards`	Список всех карт кошелька
`get_card`	Сводная информация о карте
`get_card_details`	Получение PAN, CVV, срока действия
`freeze_card`	Заморозка карты
`unfreeze_card`	Разморозка карты
`get_pricing`	Просмотр тарифов
`get_transactions`	История транзакций (реальные данные 4payments)
`get_balance`	Текущий баланс карты из 4payments

Настройка MCP

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

Архитектура

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

Платежные каналы

ASG Card поддерживает два платежных канала. Продукт (карта) идентичен — различаются только способы оплаты.

Stellar Edition (x402)

Агент запрашивает карту → API возвращает 402 Payment Required с суммой в USDC
Агент подписывает перевод Stellar USDC через SDK
x402 Facilitator проверяет и проводит платеж в блокчейне
API выпускает MasterCard через эмитента карт
Данные карты возвращаются немедленно в ответе

Использует: SDK, CLI, MCP server. Без участия человека.

Stripe Edition (MPP)

Агент создает запрос на оплату → API возвращает approval_required + approvalUrl
Владелец открывает страницу подтверждения по адресу stripe.asgcard.dev/approve
Владелец проверяет и подтверждает → форма Stripe Elements с ценами в реальном времени
Владелец оплачивает через Stripe → карта/Apple Pay/Google Pay
Карта создана → агент опрашивает статус до получения completed

Использует: сессионную авторизацию (X-STRIPE-SESSION). Подтверждение с участием человека.

Рабочее пространство

Директория	Описание
`/api`	API ASG Card (Express + x402 + Stripe MPP)
`/sdk`	TypeScript-клиент `@asgcard/sdk`
`/cli`	CLI `@asgcard/cli` с процессом онбординга
`/mcp-server`	MCP-сервер `@asgcard/mcp-server` (11 инструментов)
`/web`	Маркетинговый сайт (asgcard.dev)
`/web-stripe`	Сайт для Stripe-версии (stripe.asgcard.dev)
`/docs`	Внутренняя документация и ADR

API Endpoints

Публичные

Маршрут	Метод	Описание
`/health`	GET	Проверка работоспособности
`/pricing`	GET	Информация о тарифах
`/cards/tiers`	GET	Информация о тарифах
`/supported`	GET	Возможности x402

Stellar x402 (Требуется оплата)

Маршрут	Метод	Описание
`/cards/create/tier/:amount`	POST	Создание виртуальной карты
`/cards/fund/tier/:amount`	POST	Пополнение существующей карты

Авторизация кошелька

Маршрут	Метод	Описание
`/cards/`	GET	Список карт кошелька
`/cards/:id`	GET	Детали карты
`/cards/:id/details`	GET	Конфиденциальные данные (требуется nonce)
`/cards/:id/transactions`	GET	История транзакций по карте
`/cards/:id/balance`	GET	Текущий баланс карты
`/cards/:id/freeze`	POST	Заморозить карту
`/cards/:id/unfreeze`	POST	Разморозить карту

Stripe MPP (Бета)

Маршрут	Метод	Описание
`/stripe-beta/session`	POST	Создание управляемой сессии
`/stripe-beta/payment-requests`	POST	Создание запроса на оплату
`/stripe-beta/payment-requests/:id`	GET	Опрос статуса запроса
`/stripe-beta/approve/:id`	GET/POST	Данные страницы подтверждения / одобрение или отказ
`/stripe-beta/approve/:id/complete`	POST	Завершение оплаты (учетные данные MPP)
`/stripe-beta/cards`	GET	Список карт сессии
`/stripe-beta/cards/:id/details`	GET	Детали карты (требуется nonce)

Тарифы

Просто, прозрачно, без скрытых комиссий.

$10 фиксированно за создание карты (начальный депозит не требуется)
3.5% с каждого пополнения

Это всё. Пополняйте на любую сумму от $5 до $5,000.

Создание карты без пополнения → $10. Создание карты с пополнением на $100 → $113.50. Пополнение на $200 позже → всего $207. Одинаковые тарифы для каналов Stellar и Stripe.

Telegram-бот (@ASGCardbot)

Привяжите свой кошелек к Telegram для управления картами:

Команда	Описание
`/start`	Приветствие / Привязка аккаунта
`/mycards`	Список ваших карт
`/faq`	Часто задаваемые вопросы
`/support`	Поддержка

Безопасность

Данные карт зашифрованы в покое с помощью AES-256-GCM
Защита от повторного воспроизведения на основе nonce агента (5 чтений/час)
Аутентификация через подпись кошелька (версия Stellar)
Сессионная аутентификация с бета-доступом (версия Stripe)
Ключи сессий Stripe удаляются из логов
Валидация секретов вебхуков Telegram
Операционные эндпоинты защищены API-ключом + IP-белым списком

Участие в разработке

Мы приветствуем вклад в проект! Пожалуйста, ознакомьтесь с CONTRIBUTING.md для получения инструкций и посмотрите задачи с меткой good first issue, чтобы начать.

Этот проект следует нашему Кодексу поведения.

Лицензия

MIT

ASG Card