احصل على بطاقة
API & الوكلاء

واجهة برمجية تفكّر
مثل المحفظة.

REST v1 للبشر. Native MCP لـ Claude وChatGPT وCursor وأي وكيل ذكاء اصطناعي. سجّل، أودع، أصدر بطاقات، أنفق، تابع المعاملات، قدّم نزاعات — باستقلالية كاملة، دون تدخل بشري.

احصل على مفتاح API تصفح نقاط النهاية ↓
REST v1 · أكثر من 50 نقطة نهاية MCP v0.4 · أكثر من 40 أداة OAuth 2.1 + DCR HMAC webhooks
سطحان

برنامج واحد. طريقتان للتكامل.

REST للتكاملات التي تتحكم بها من البداية إلى النهاية. MCP للوكلاء الذين يقودون التكامل بأنفسهم.

REST API v1 لخوادمك وسكريبتاتك وحزم SDK
  • أكثر من 50 نقطة نهاية، كل إجراءات الحساب مغطاة
  • مكتوبة بـ JSON Schema · مواصفة OpenAPI 3.1
  • تعمل بعدم التكرار، ومقسَّمة، وتعتمد المؤشرات
  • مفاتيح تُنشأ في اللوحة ← إعدادات API
  • Webhooks موقَّعة بـ HMAC مع حماية من الإعادة
  • محدود المعدل لكل مفتاح · 60 طلب/ث اندفاعًا، 1000 طلب/د مستدامًا
  • متوافق للخلف، مُصدَر (v1 LTS إلى الأبد)
كتالوج نقاط النهاية
MCP Server لـ Claude وChatGPT وCursor وContinue وأي وكيل
  • خادم Model Context Protocol أصلي، مستضاف لدينا
  • أكثر من 40 أداة مُعيَّنة 1:1 من نقاط نهاية REST، بأسماء صديقة للوكلاء
  • نقل HTTP قابل للبث · عديم الحالة أو مع جلسة
  • OAuth 2.1 + DCR — يُسجِّل الوكلاء أنفسهم عند التشغيل
  • إضافة مباشرة لـ Claude Desktop وCursor وContinue وmcp-cli
  • منح صلاحيات محددة لكل أداة — تقييد الوكيل بالقراءة فقط، أو ببطاقة واحدة
  • نفس اتفاقية مستوى الخدمة، ونفس حدود المعدل، ونفس سجل التدقيق
تكامل MCP
البدء السريع

من الصفر إلى بطاقة نشطة في ثلاث استدعاءات.

سجِّل، اشحن الرصيد، أصدر البطاقة. يتسع التدفق بأكمله في جلسة shell واحدة — سواء للبشر أو للوكلاء.

تُولَّد مفاتيح API في اللوحة على /api-settings. رمز الحامل أدناه هو رمز حامل جلسة قصير الأمد مُستمَدّ من استجابة التسجيل — مناسب للاختبار، لكن في الإنتاج استبدله بمفتاح دائم ccm_live_….

1 · التسجيل والحصول على مفتاح API 
# Create an account — no KYC, no documents
curl https://api.cryptocardium.com/v1/accounts \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "password": "long-random-string"
  }'

# → 201 Created · session bearer in the response
{
  "id": "acc_8f3a91b7c4d2",
  "email": "[email protected]",
  "bearer": "sess_94d72b6c..."
}
2 · شحن الخزينة 
# Create a USDT-TRC20 deposit address
curl https://api.cryptocardium.com/v1/topups \
  -H "Authorization: Bearer $CCM_KEY" \
  -H "Idempotency-Key: top_3e5b9b1c9852f7f7" \
  -d '{
    "amount_usd": 500,
    "asset": "USDT",
    "chain": "tron"
  }'

{
  "id": "top_4e21a99c7b",
  "status": "pending",
  "amount_usd": 500,
  "deposit_address": "T9zFR...kQp",
  "qr_data_uri": "data:image/png;base64,...",
  "expires_at": "2026-05-19T08:00:00Z"
}
3 · إصدار بطاقة والإنفاق 
# Once your top-up confirms, issue a Visa Platinum
# loaded with $300, Apple/Google Pay-ready.
curl https://api.cryptocardium.com/v1/cards \
  -H "Authorization: Bearer $CCM_KEY" \
  -d '{
    "type": "virtual",
    "bin": "489517",
    "load_usd": 300,
    "wallet_provision": ["apple_pay", "google_pay"]
  }'

{
  "id": "card_8f3a91b7c4d2",
  "bin": "489517",
  "last4": "4218",
  "status": "active",
  "balance_usd": 300,
  "wallet": {"apple_pay": "ready", "google_pay": "ready"}
}
فهرس نقاط النهاية

كل إجراء، قابل للبرمجة.

الحساب، عمليات الشحن، البطاقات، المعاملات، السجلات، السحوبات، النزاعات، الـ webhooks — السطح الكامل للوحة، مكشوف كنقاط نهاية REST وأدوات MCP.

الحساب والملف الشخصي

7 نقطة نهاية
  • POST /v1/accounts إنشاء حساب جديد (بدون KYC، بدون مستندات). create_account
  • POST /v1/sessions تسجيل الدخول بالبريد الإلكتروني وكلمة المرور (يُعيد رمز الحامل). sign_in
  • DELETE /v1/sessions تسجيل الخروج من الجلسة الحالية. sign_out
  • GET /v1/accounts/me إرجاع الحساب الحالي والرصيد وحالة المصادقة الثنائية. get_account
  • PATCH /v1/accounts/me تحديث البريد الإلكتروني وكلمة المرور والإشعارات. update_account
  • POST /v1/accounts/me/totp تسجيل جهاز المصادقة (يُعيد السر والـ URI). enable_2fa
  • DELETE /v1/accounts/me/totp تعطيل المصادقة الثنائية (يتطلب كلمة المرور ورمزًا صالحًا). disable_2fa

مفاتيح API

3 نقطة نهاية
  • GET /v1/api_keys سرد مفاتيح API الخاصة بك (البادئة فقط، ليس السر). list_api_keys
  • POST /v1/api_keys إنشاء مفتاح جديد. يُعرض النص الصريح مرة واحدة فقط. create_api_key
  • DELETE /v1/api_keys/:id إلغاء مفتاح فورًا. revoke_api_key

الرصيد والخزينة

2 نقطة نهاية
  • GET /v1/balance رصيد USDT الحالي. get_balance
  • GET /v1/balance/history سلسلة زمنية لتغيرات الرصيد. get_balance_history

عمليات الشحن

4 نقطة نهاية
  • POST /v1/topups إنشاء عملية شحن: يُعيد عنوان الإيداع ورمز QR. create_topup
  • GET /v1/topups سرد عمليات الشحن (تصفية حسب الحالة والتاريخ). list_topups
  • GET /v1/topups/:id الحصول على عملية شحن (الحالة، التأكيدات، txid). get_topup
  • POST /v1/topups/:id/cancel إلغاء عملية شحن معلقة. cancel_topup

البطاقات · الإصدار

5 نقطة نهاية
  • GET /v1/cards سرد بطاقاتك (تصفية حسب الحالة والنوع والـ BIN). list_cards
  • POST /v1/cards إصدار بطاقة جديدة (افتراضية أو مادية). issue_card
  • GET /v1/cards/:id بيانات البطاقة الوصفية (الحالة، BIN، آخر 4 أرقام، الرصيد). get_card
  • GET /v1/cards/:id/pan رقم PAN الكامل + CVV (حساس، استخدام واحد، مُدقَّق). reveal_pan
  • POST /v1/cards/:id/replace استبدال بطاقة (رقم PAN جديد، إعادة إصدار افتراضية). replace_card

البطاقات · العمليات

8 نقطة نهاية
  • POST /v1/cards/:id/load تحميل USDT من الرصيد على البطاقة. load_card
  • POST /v1/cards/:id/unload إعادة الرصيد غير المنفق إلى خزينتك. unload_card
  • POST /v1/cards/:id/freeze تجميد البطاقة (ترفض طلبات التفويض). freeze_card
  • POST /v1/cards/:id/unfreeze إعادة تفعيل بطاقة مجمَّدة. unfreeze_card
  • POST /v1/cards/:id/cancel إلغاء البطاقة بشكل دائم. cancel_card
  • PATCH /v1/cards/:id/limits تعيين حدود للبطاقة: لكل معاملة / يومية / شهرية. set_card_limits
  • PATCH /v1/cards/:id/mcc السماح بفئات MCC أو رفضها (قوائم). set_mcc_rules
  • PATCH /v1/cards/:id/geo تقييد البطاقة جغرافيًا على دول بعينها. set_card_geo

المعاملات

4 نقطة نهاية
  • GET /v1/transactions سرد جميع معاملات البطاقة (مُصفَّحة). list_transactions
  • GET /v1/transactions/:id حدث تفويض/التقاط/استرداد منفرد. get_transaction
  • GET /v1/cards/:id/transactions سجل المعاملات لكل بطاقة. list_card_transactions
  • GET /v1/transactions/:id/auth رسالة التفويض الخام (حقول ISO 8583). get_auth_details

سجلات النشاط والتدقيق

3 نقطة نهاية
  • GET /v1/activity تدفق موحد للأحداث (الشحن + البطاقات + الإنفاق). get_activity
  • GET /v1/activity?type=error تصفية حسب نوع الحدث (topup/card/spend/error). filter_activity
  • GET /v1/audit_log سجل التدقيق على مستوى الحساب (عمليات تسجيل الدخول، استخدامات المفاتيح). get_audit_log

السحوبات

3 نقطة نهاية
  • POST /v1/withdrawals سحب USDT إلى محفظة خارجية. withdraw
  • GET /v1/withdrawals سرد طلبات السحب الخاصة بك. list_withdrawals
  • GET /v1/withdrawals/:id الحصول على سحب (الحالة، txid على السلسلة). get_withdrawal

النزاعات واسترداد المبالغ

4 نقطة نهاية
  • POST /v1/disputes فتح استرداد مبلغ على معاملة. file_dispute
  • GET /v1/disputes سرد نزاعاتك (مفتوحة / تمت الاستجابة / مغلقة). list_disputes
  • GET /v1/disputes/:id نزاع منفرد (الحالة، الاستجابة، الأدلة). get_dispute
  • POST /v1/disputes/:id/evidence إرفاق أدلة (إيصالات، لقطات شاشة، ملاحظات). add_dispute_evidence

Webhooks

5 نقطة نهاية
  • GET /v1/webhooks سرد اشتراكات الـ webhook الخاصة بك. list_webhooks
  • POST /v1/webhooks الاشتراك في الأحداث (URL + أنواع الأحداث). create_webhook
  • PATCH /v1/webhooks/:id تحديث الـ URL والأحداث أو تدوير مفتاح التوقيع. update_webhook
  • DELETE /v1/webhooks/:id إلغاء الاشتراك. delete_webhook
  • POST /v1/webhooks/:id/replay/:eid إعادة تشغيل حدث إلى نقطة نهايتك. replay_webhook

الدعم والنظام

4 نقطة نهاية
  • POST /v1/tickets فتح تذكرة دعم (تتطلب بطاقة نشطة). open_ticket
  • GET /v1/tickets سرد تذاكرك. list_tickets
  • GET /v1/system/health فحص الصحة (المُصدِر، القضبان، حالة الشبكة). get_system_health
  • GET /v1/system/limits حدود معدلك الحالي + سقوف الإنفاق. get_limits
استقلالية الوكيل

ما يفعله وكيل Claude أو ChatGPT باستقلالية تامة.

بتكليف من نوع "اشترِ 100 رصيد سحابي بالعملة المشفرة"، يسلسل الوكيل الاستدعاءات أدناه — دون تدخل بشري. كل خطوة استدعاء أداة واحد.

  1. 01

    POST /v1/accounts · create_account

    يُنشئ الوكيل بريدًا إلكترونيًا وكلمة مرور جديدَين ويرسلهما. بدون KYC، بدون مستندات. يتلقى رمز الحامل في ~200ms.

  2. 02

    POST /v1/topups · create_topup

    يطلب الوكيل شحن رصيد بأي عملة مشفرة مدعومة (USDT-TRC20 هي الأرخص). يتلقى عنوان إيداع. يُرسل العملة من محفظته. يُطلق الـ webhook عند تأكيد الأموال.

  3. 03

    POST /v1/cards · issue_card

    يختار الوكيل الـ BIN المناسب للتاجر (Visa Business للإعلانات، Visa Platinum للمحافظ الرقمية، Visa Corporate لتطبيقات SaaS)، ويشحن $X ليحصل على بطاقة نشطة.

  4. 04

    GET /v1/cards/:id/pan · reveal_pan

    يكشف الوكيل رقم PAN + CVV + تاريخ الانتهاء (استخدام واحد، مُدقَّق). يستخدمها عند صفحة الدفع لدى التاجر. تُوافَق تحديات 3-D Secure عبر ردّ الـ webhook.

  5. 05

    GET /v1/activity · get_activity

    يستطلع الوكيل (أو يشترك عبر webhook) أحداث التفويض. يؤكد نجاح الإنفاق. يقرأ اسم التاجر وMCC والمبلغ والعملة.

  6. 06

    POST /v1/cards/:id/freeze · freeze_card

    انتهت المهمة. يجمّد الوكيل البطاقة (أو يلغيها). يمكن إعادة الرصيد غير المنفق إلى الخزينة. استغرق التدفق بأكمله أقل من دقيقة.

تكامل MCP

إضافة مباشرة لـ Claude وChatGPT وCursor.

أضف خادم MCP المستضاف إلى إعدادات وكيلك. يلتقط الوكيل أكثر من 40 أداة تلقائيًا — كل نقطة نهاية REST مُعيَّنة إلى اسم أداة مناسب للوكيل.

Claude Desktop / Claude Code بيئة تشغيل الوكيل المرجعية من Anthropic 
~/.config/claude/claude_desktop_config.json
{
  "mcpServers": {
    "cryptocardium": {
      "url": "https://mcp.cryptocardium.com/v1",
      "transport": "http"
    }
  }
}
Cursor / Continue / mcp-cli أي عميل متوافق مع MCP 
# Streamable HTTP transport, OAuth 2.1 DCR
mcp-cli add cryptocardium \
  --url https://mcp.cryptocardium.com/v1 \
  --auth oauth

# The agent enrols itself on first connection,
# no API key needs to be pasted.
40+ أداة

لكل نقطة نهاية REST أداة MCP مقابلة، مسمّاة لتسهيل فهم الوكيل. عينة صغيرة:

create_account sign_in create_topup get_topup issue_card load_card reveal_pan freeze_card unfreeze_card set_card_limits set_mcc_rules list_transactions get_activity withdraw file_dispute create_webhook get_audit_log get_balance get_system_health … 21 إضافية
المصادقة والأمان

ثلاث طرق للمصادقة.

رموز الحامل للسكريبتات البسيطة. مفاتيح API لخوادم الإنتاج. OAuth 2.1 مع DCR للوكلاء الذين يسجلون أنفسهم.

جلسة الحامل

من POST /v1/sessions. قصيرة الأمد (30 يومًا). مناسبة للاختبار والسكريبتات التفاعلية.

Authorization: Bearer sess_94d72b6c…

مفتاح API

من إعدادات API. دائم (حتى الإلغاء). يحمل صلاحيات على مستوى الحساب. الأفضل لتكاملات الواجهة الخلفية.

Authorization: Bearer ccm_live_a1b2c3d4…

OAuth 2.1 + DCR

تُسجّل الوكلاء أنفسها في وقت التشغيل عبر Dynamic Client Registration. منح صلاحيات محددة لكل أداة — تقييد الوكيل بالقراءة فقط، أو ببطاقة واحدة بعينها.

POST /oauth/register
  → client_id, client_secret
POST /oauth/token
  → access_token (scoped)
Webhooks

اشترك في كل حدث.

حمولات مُوقَّعة بـ HMAC-SHA256. تسليم مرة واحدة على الأقل مع إعادة المحاولة. أعد تشغيل أي حدث من لوحة التحكم أو API.

أنواع الأحداث

  • account.created · تسجيل جديد
  • account.signed_in · بدء الجلسة
  • topup.created · عنوان إيداع صدر
  • topup.confirmed · اكتملت النهائية على السلسلة
  • topup.expired · نافذة العنوان أُغلقت
  • topup.error · فشل التسوية (قاطع الطوارئ، استرداد)
  • card.issued · بطاقة جديدة نشطة
  • card.loaded · أموال أُضيفت إلى بطاقة
  • card.frozen · جمّدها الوكيل أو المسؤول
  • card.cancelled · تقاعدت نهائيًا
  • transaction.authorized · ما قبل الإنفاق
  • transaction.captured · سوّاها التاجر
  • transaction.refunded · استرداد مُستلَم
  • transaction.declined · مع رمز السبب
  • dispute.opened · استرداد مبلغ مُقدَّم
  • dispute.resolved · مكسوب / مخسور
  • withdrawal.broadcasted · معاملة على السلسلة أُرسلت
  • system.maintenance · توقف مجدول
التحقق من webhook 
# Headers we set on every webhook
Cryptocardium-Signature: t=1718999999,
  v1=4a8b2f...
Cryptocardium-Event-Id: evt_a1b2c3d4

# Verify (Node example)
const sig = req.headers['cryptocardium-signature'];
const [t, v1] = parseSig(sig);
const expected = hmac(
  'sha256',
  SIGNING_SECRET,
  `${t}.${rawBody}`
);
if (!timingSafeEqual(v1, expected)) reject();
60 req/s الانفجار

لكل مفتاح API. تُتحمَّل الانفجارات القصيرة فوق المعدل الثابت لنوافذ أقل من ثانية.

1k req/min المستدام

لكل مفتاح API. تتلقى الطلبات الزائدة 429 Too Many Requests مع ترويسة Retry-After.

25 MB الحمولة القصوى

أجسام الطلب والاستجابة. يدعم إثبات النزاع تحميلات متدفقة حتى 100 MB.

99.99% وقت التشغيل · 90 يومًا

نشط في مناطق متعددة. صفحة الحالة على status.cryptocardium.com.

افتح الـ API

ابنِ، أتمتِ، أوكِل.
كل ما تستطيع البطاقات فعله، يستطيع كودك.

سجّل، انتقل إلى اللوحة، أنشئ مفتاحًا، وأدخله في وكيلك. ستين ثانية من الصفر إلى الإنفاق المستقل.

احصل على مفتاح API عرض البطاقات
FAQ

API وخادم MCP، الإجابات هنا.

Everything people actually ask. Last updated .

أين توجد مواصفة OpenAPI؟

مواصفة OpenAPI 3.1 القابلة للقراءة آليًا لسطح REST v1 منشورة على https://cryptocardium.com/openapi.json (والنسخة YAML على /openapi.yaml). استوردها في Postman أو Insomnia أو Stoplight أو أي أدوات ذكاء اصطناعي تستهلك OpenAPI.

كيف يعمل اكتشاف خادم MCP؟

بطاقة الخادم منشورة على https://cryptocardium.com/.well-known/mcp/server-card.json (بتنسيق MCP SEP-1649). بيانات التفويض على /.well-known/oauth-authorization-server (RFC 8414) و/.well-known/oauth-protected-resource (RFC 9728). يلتقط عملاء MCP الخادم بالكامل دون أي إعداد يدوي.

ما بروتوكولات النقل المدعومة في MCP؟

HTTP القابل للبث فقط (مواصفة MCP 2025-06-18)، مع ترقية SSE اختيارية للعمليات الطويلة. بروتوكول النقل HTTP+SSE القديم غير مدعوم.

هل يمكن لوكيل ذكاء اصطناعي تسجيل نفسه دون إعداد يدوي؟

نعم. تسجيل العميل الديناميكي (RFC 7591) مدعوم على خادم تفويض OAuth 2.1. يُرسل الوكيل بياناته الوصفية عبر POST إلى /oauth/register ويتلقى client_id وclient_secret فورًا. النطاقات الأولية مقيَّدة؛ يمكن للوكيل طلب نطاقات موسَّعة من خلال تدفق موافقة OAuth القياسي.

هل يدعم API مدفوعات x402 المصغرة؟

نعم. يمكن لنقاط النهاية المدفوعة إرجاع HTTP 402 مع رأس PAYMENT-REQUIRED منظَّم (scheme=exact، network=base، asset=USDC). يُعيد الوكيل المحاولة مع PAYMENT-SIGNATURE. توافق أصلي مع كل من Visa TAP وMastercard Agent Pay.

كيف يتم مصادقة Webhooks؟

كل حدث Webhook موقَّع بـ HMAC-SHA256. يُنشأ مفتاح التوقيع مرة واحدة عند الاشتراك، وقابل للتدوير عند الطلب. تسمح مفاتيح Idempotency بالإعادة الآمنة. أحداث دورة الحياة المغطاة: انتقالات حالة الإيداع، وإصدار البطاقة، والتفويض، والتحصيل، والاسترداد، والنزاع، والتسوية.

هل النطاقات لكل أداة أم لكل استدعاء؟

النطاقات لكل أداة. يمكنك منح وكيل صلاحية القراءة فقط على البطاقات (card:read)، أو الإصدار فقط دون الكشف (card:issue بدون card:reveal_pan)، أو تحديد نطاقه ببطاقة واحدة عبر سياسات وصول دقيقة. منح النطاقات قابل للإلغاء في أي وقت.

ما هو حد معدل الطلبات؟

600 طلب في الدقيقة لكل مفتاح API، مع سعة اندفاع 100 طلب. حدود أعلى متاحة عند الطلب عبر /contact. الحدود معروضة على /v1/system/limits.