إصدار البطاقات الافتراضية عبر API لوكلاء الذكاء الاصطناعي

إذا كنت تبني وكيلاً أو واجهة خلفية تحتاج إلى إنفاق أموال، فأنت بحاجة إلى بطاقات يمكنك إنشاؤها والتحكم بها في الكود. يتناول هذا الدليل واجهة API بطاقات Cryptocardium من الألف إلى الياء — نفس الواجهة متاحة كـ REST للخدمات التقليدية وكـ خادم MCP لوكلاء LLM.

المصادقة والصلاحيات

كل استدعاء مُصادَق بمفتاح API من نوع Bearer يُنشأ في لوحة التحكم. تحمل المفاتيح صلاحيات حتى تتمكن من منح الوكيل بالضبط القدرة التي يحتاجها ولا شيء أكثر.

• 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"] }'

المطابقة بالـ Webhooks

اشترك في أحداث التفويض وتحقق من التوقيع عند كل تسليم. يُبقي ذلك دفاتر حساباتك ووكيلك متزامنَين دون الحاجة للاستطلاع.

// 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 البطاقات بنفسه، وجّه عميل MCP نحو الخادم بدلاً من كتابة عميل REST. يرى الوكيل issue_card و fund_card و set_card_limits كأدوات أصيلة — راجع دليل خادم MCP للإعداد.

تجميع كل شيء معاً

صادِق بمفتاح محدود الصلاحيات، وأصدِر بطاقة، وموّلها بالعملات المشفرة، وقيّدها، وطابقها عبر webhooks. هذه هي الحلقة الكاملة التي يحتاجها الوكيل لإنفاق الأموال بأمان. افتح حساباً وأنشئ مفتاحك الأول لتجربتها.