돈을 지출해야 하는 에이전트나 백엔드를 구축 중이라면 코드로 생성하고 제어할 수 있는 카드가 필요합니다. 이 가이드는 Cryptocardium 카드 API를 처음부터 끝까지 안내합니다 — 기존 서비스를 위한 REST와 LLM 에이전트를 위한 MCP 서버로 동일한 기능이 제공됩니다.
인증 및 범위
모든 호출은 대시보드에서 생성한 Bearer API 키로 인증됩니다. 키는 범위를 지니므로 에이전트에게 필요한 권한만 정확히 제공할 수 있습니다.
cards:issue— 새 카드 생성.cards:fund— 카드에 잔액 이동.cards:read— 카드 세부 정보 및 거래 조회.cards:control— 한도 설정, 동결, 해지.
카드 발급
단 하나의 요청으로 가상 카드를 생성하세요. 사용 사례에 맞게 조정된 BIN을 선택하고(광고, SaaS, 지갑, 프리미엄 지출) 나중에 찾을 수 있도록 레이블을 지정하세요.
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
}암호화폐로 충전
새 카드는 잔액 0으로 시작합니다. 계정의 암호화폐 잔액에서 충전하세요 — 카드는 즉시 해당 금액까지 사용 가능합니다.
curl -X POST https://cryptocardium.com/api/v1/cards/card_9f2a1c/fund \
-H "Authorization: Bearer ck_live_…" \
-d '{ "amount_usd": 200, "asset": "USDT" }'지출 제어 설정
에이전트에게 카드를 넘기기 전에 각 카드를 제한하세요. 한도와 가맹점 규칙은 승인 시점에 서버 측에서 강제됩니다.
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"] }'웹훅으로 정산
승인 이벤트를 구독하고 각 전달에서 서명을 검증하세요. 폴링 없이 장부와 에이전트를 동기화 상태로 유지합니다.
// 웹훅 URL로 POST
{
"event": "authorization",
"card_id": "card_9f2a1c",
"amount_usd": 19.99,
"merchant": "Cloud API Inc",
"mcc": "5818",
"result": "approved"
}
// header: X-Signature: sha256=…MCP를 통한 동일한 흐름
LLM 에이전트가 카드를 직접 구동해야 하는 경우, REST 클라이언트를 작성하는 대신 MCP 클라이언트를 서버에 연결하세요. 에이전트는 issue_card, fund_card, set_card_limits를 네이티브 도구로 보게 됩니다 — 설정에 대해서는 MCP 서버 가이드를 참조하세요.
종합하기
범위가 제한된 키로 인증하고, 카드를 발급하고, 암호화폐로 충전하고, 제한을 설정하고, 웹훅으로 정산하세요. 에이전트가 안전하게 돈을 지출하는 데 필요한 전체 루프입니다. 계정을 개설하고 첫 번째 키를 생성하여 사용해 보세요.
