ASG 카드는 에이전트 우선 가상 카드 플랫폼입니다. AI 에이전트는 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 서버 (AI 에이전트 통합)

@asgcard/mcp-server는 Codex, Claude Code 및 Cursor를 위한 11가지 도구를 제공합니다:

도구	설명
`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 카드는 두 가지 결제 레일을 지원합니다. 카드 상품은 동일하며 결제 방식만 다릅니다.

Stellar 에디션 (x402)

에이전트가 카드 요청 → API가 USDC 금액과 함께 402 Payment Required 반환
에이전트가 SDK를 통해 Stellar USDC 전송 서명
x402 촉진자가 온체인에서 결제 확인 및 정산
API가 카드 발급사를 통해 마스터카드 발급
응답으로 카드 세부 정보 즉시 반환

사용: SDK, CLI, MCP 서버. 사람의 개입 없음.

Stripe 에디션 (MPP)

에이전트가 결제 요청 생성 → API가 approval_required + approvalUrl 반환
소유자가 stripe.asgcard.dev/approve에서 승인 페이지를 엶
소유자가 검토 및 승인 → 실시간 가격이 포함된 Stripe Elements 양식
소유자가 Stripe를 통해 결제 → 카드/Apple Pay/Google Pay
카드 생성 → 에이전트가 completed 상태가 될 때까지 폴링

사용: 세션 기반 인증 (X-STRIPE-SESSION). 사람의 승인 필요.

워크스페이스

디렉토리	설명
`/api`	ASG 카드 API (Express + x402 + Stripe MPP)
`/sdk`	`@asgcard/sdk` TypeScript 클라이언트
`/cli`	`@asgcard/cli` 온보딩 포함 CLI
`/mcp-server`	`@asgcard/mcp-server` MCP 서버 (11개 도구)
`/web`	마케팅 웹사이트 (asgcard.dev)
`/web-stripe`	Stripe 에디션 사이트 (stripe.asgcard.dev)
`/docs`	내부 문서 및 ADR

API 엔드포인트

공개

경로	메서드	설명
`/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 레일 모두 동일한 가격이 적용됩니다.

텔레그램 봇 (@ASGCardbot)

지갑을 텔레그램에 연결하여 카드를 관리하세요:

명령어	설명
`/start`	시작 / 계정 연결
`/mycards`	카드 목록 확인
`/faq`	자주 묻는 질문
`/support`	고객 지원

보안

카드 세부 정보는 AES-256-GCM으로 암호화되어 저장됨
에이전트 nonce 기반 재전송 방지 보호 (시간당 5회 읽기)
지갑 서명 인증 (Stellar 에디션)
베타 게이트가 포함된 세션 기반 인증 (Stripe 에디션)
로그에서 Stripe 세션 키 삭제
텔레그램 웹훅 비밀 검증
API 키 + IP 허용 목록으로 보호되는 Ops 엔드포인트

기여

기여를 환영합니다! 가이드라인은 CONTRIBUTING.md를 참조하고, good first issue 라벨이 붙은 이슈를 확인하여 시작하세요.

이 프로젝트는 행동 강령을 따릅니다.

라이선스

MIT

ASG Card