अगर आप एक ऐसा एजेंट या बैकएंड बना रहे हैं जिसे पैसे खर्च करने हैं, तो आपको ऐसे कार्ड चाहिए जो आप कोड में बना और नियंत्रित कर सकें। यह गाइड 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
}क्रिप्टो से फंड करें
एक नया कार्ड शून्य बैलेंस से शुरू होता है। इसे अपने अकाउंट के क्रिप्टो बैलेंस से फंड करें — कार्ड तुरंत उस राशि तक खर्च योग्य हो जाता है।
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"] }'वेबहुक से मिलान करें
अधिकृतीकरण इवेंट की सदस्यता लें और हर डिलीवरी पर हस्ताक्षर सत्यापित करें। यह आपके लेजर और एजेंट को बिना पोलिंग के सिंक रखता है।
// POST to your webhook URL
{
"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 सर्वर गाइड देखें।
सब एक साथ
एक स्कोप्ड की से प्रमाणीकरण करें, एक कार्ड जारी करें, इसे क्रिप्टो से फंड करें, इसे बाँधें, और वेबहुक से मिलान करें। यही वह पूरा लूप है जो एजेंट को सुरक्षित रूप से पैसे खर्च करने के लिए चाहिए। एक अकाउंट खोलें और इसे आज़माने के लिए अपनी पहली की बनाएँ।
