OpenAPI 3.1.0 · 20 Endpoints · Base URL: https://xpayr.com/api/v1

المرجع التفاعلي لواجهة XPayr REST API v1.

افحص كل نقطة نهاية للإنتاج وTestnet مباشرةً من مواصفة /.well-known/openapi.json القياسية، أو حمّل مجموعة Postman v2.1 الجاهزة للتشغيل، أو ولّد كود تطبيق كامل بـ 8 لغات.

📥 تحميل مجموعة Postman v2.1 📄 مواصفة OpenAPI 3.1.0 ⚙️ مولّد الأكواد بـ 8 لغات 🌐 بوابة Scalar / Swagger

GET /api/v1/health سلامة النظام

xpayr_health_check

فحص سلامة بوابة API

تحقق من السلامة التشغيلية وإصدار وطابع وقت الخادم لواجهة XPayr Gateway API v1.

curl -X GET "https://xpayr.com/api/v1/health"

POST /api/v1/payments المدفوعات والدفع

xpayr_create_payment_session

إنشاء جلسة دفع بالعملات الرقمية (الدفع المزدوج)

أنشئ جلسة دفع غير وصائية بالعملات الرقمية تدعم دفع Web3 بنقرة واحدة، وتحويل رمز QR المباشر من المنصات، والروابط متعددة الشبكات، والروابط القابلة لإعادة الاستخدام لمدة عام، وإرسال الفواتير التلقائي بصيغة HTML عبر البريد الإلكتروني.

curl -X POST "https://xpayr.com/api/v1/payments" \
  -H "Authorization: Bearer sk_test_your_workspace_key" \
  -H "Content-Type: application/json" \
  -d '{"amount":49.9,"currency":"USDT","network":"tron-mainnet","order_id":"ORD-1001","description":"Pro SaaS Annual Plan","is_multi_chain":true,"is_reusable":false,"send_invoice_email":true,"customer_email":"buyer@example.com","ipn_callback_url":"https://example.com/webhooks/xpayr"}'

GET /api/v1/payments المدفوعات والدفع

xpayr_list_payment_sessions

عرض جلسات دفع التاجر

اعرض جلسات دفع العملات الرقمية للتاجر مع التصفية حسب الحالة والعملة والشبكة وتقسيم الصفحات.

curl -X GET "https://xpayr.com/api/v1/payments" \
  -H "Authorization: Bearer sk_test_your_workspace_key"

GET /api/v1/payments/{session_id} المدفوعات والدفع

xpayr_get_payment_session

جلب تفاصيل جلسة الدفع

استرجع التفاصيل الكاملة والبيانات الوصفية ومبالغ تقسيم التسوية ووضع الدفع ومُعرّف المعاملة على السلسلة لجلسة الدفع.

curl -X GET "https://xpayr.com/api/v1/payments/{session_id}" \
  -H "Authorization: Bearer sk_test_your_workspace_key"

GET /api/v1/payments/{session_id}/status المدفوعات والدفع

xpayr_get_public_payment_status

استعلام الحالة العامة للدفع على السلسلة

استعلم في الوقت الفعلي عن حالة الدفع العامة وقيمة tx_hash على السلسلة وعنوان محفظة المُرسِل وتأكيدات الكتل وطابع وقت paid_at دون الحاجة إلى مفتاح API.

curl -X GET "https://xpayr.com/api/v1/payments/{session_id}/status"

POST /api/v1/payments/{session_id}/coupon المدفوعات والدفع

xpayr_apply_payment_coupon

تطبيق قسيمة خصم عند الدفع

تحقق من رمز قسيمة الخصم الترويجية الخاصة بالتاجر وطبّقه على جلسة دفع معلّقة نشطة.

curl -X POST "https://xpayr.com/api/v1/payments/{session_id}/coupon" \
  -H "Authorization: Bearer sk_test_your_workspace_key" \
  -H "Content-Type: application/json" \
  -d '{"coupon_code":"XPAYR-DEMO"}'

GET /api/v1/me التاجر والملف الشخصي

xpayr_get_merchant_profile

جلب ملف التاجر ومحفظة التسوية

استرجع ملف التاجر المُصادق عليه وعنوان محفظة التسوية ومعدل العمولة بالنقاط الأساسية (50 bps = 0.5%) ومفاتيح API النشطة.

curl -X GET "https://xpayr.com/api/v1/me" \
  -H "Authorization: Bearer sk_test_your_workspace_key"

GET /api/v1/me/balance التاجر والملف الشخصي

xpayr_get_merchant_balance

جلب حجم ورصيد التسوية متعدد الشبكات

استعلم عن حجم التسوية غير الوصائية المؤكدة وعدد المعاملات ورسوم المنصة مجمّعةً حسب العملة وشبكة البلوكتشين.

curl -X GET "https://xpayr.com/api/v1/me/balance" \
  -H "Authorization: Bearer sk_test_your_workspace_key"

GET /api/v1/me/networks التاجر والملف الشخصي

xpayr_get_supported_networks

عرض الشبكات والسلاسل والرموز المدعومة

اعرض جميع شبكات البلوكتشين النشطة على EVM وTRON وSolana وArc Mainnet/Testnet ومعرّفات السلاسل ونقاط نهاية RPC وعقود التقسيم والرموز المدعومة.

curl -X GET "https://xpayr.com/api/v1/me/networks" \
  -H "Authorization: Bearer sk_test_your_workspace_key"

GET /api/v1/webhooks خطافات الويب

xpayr_get_webhook_config

جلب إعدادات وأحداث الويب هوك

افحص عنوان URL لاستدعاء الويب هوك الخاص بالتاجر وسر التوقيع المقنّع HMAC-SHA256 وأحداث دورة حياة الدفع المشترك بها.

curl -X GET "https://xpayr.com/api/v1/webhooks" \
  -H "Authorization: Bearer sk_test_your_workspace_key"

POST /api/v1/webhooks خطافات الويب

xpayr_set_webhook_endpoint

تهيئة نقطة نهاية الويب هوك عبر HTTPS

قم بتهيئة أو تحديث عنوان URL لمستقبِل الويب هوك عبر HTTPS للتاجر وتوليد سر توقيع HMAC-SHA256 جديد بحجم 32 بايت.

curl -X POST "https://xpayr.com/api/v1/webhooks" \
  -H "Authorization: Bearer sk_test_your_workspace_key" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/webhooks/xpayr"}'

POST /api/v1/webhooks/test خطافات الويب

xpayr_send_test_webhook

إرسال حدث ويب هوك تجريبي موقّع

أرسل حمولة test.webhook موقّعة مع ترويسات HMAC-SHA256 للتحقق من صحة فحص توقيع الويب هوك لدى التاجر.

curl -X POST "https://xpayr.com/api/v1/webhooks/test" \
  -H "Authorization: Bearer sk_test_your_workspace_key"

POST /api/v1/agents تجارة وكلاء الذكاء الاصطناعي

xpayr_create_ai_agent

إنشاء وكيل تجارة بالذكاء الاصطناعي خاضع للسياسات

أنشئ هوية وكيل تجارة ذكاء اصطناعي جديدة يديرها التاجر مع بيانات اعتماد محددة النطاق وضوابط إنفاق قابلة للبرمجة.

curl -X POST "https://xpayr.com/api/v1/agents" \
  -H "Authorization: Bearer sk_test_your_workspace_key" \
  -H "Content-Type: application/json" \
  -d '{"name":"Autonomous Cloud Buyer","description":"Pays API and compute invoices under $50 automatically.","wallet_address":"0x71C...89A"}'

GET /api/v1/agents تجارة وكلاء الذكاء الاصطناعي

xpayr_list_ai_agents

عرض وكلاء التجارة بالذكاء الاصطناعي للتاجر

اعرض جميع وكلاء التجارة بالذكاء الاصطناعي الذين يديرهم التاجر إلى جانب حالتهم والمحافظ المعيّنة لهم وسياسات الإنفاق الخاصة بهم.

curl -X GET "https://xpayr.com/api/v1/agents" \
  -H "Authorization: Bearer sk_test_your_workspace_key"

PUT /api/v1/agents/{agent_id}/policy تجارة وكلاء الذكاء الاصطناعي

xpayr_update_ai_agent_policy

تحديث ضوابط إنفاق وكيل الذكاء الاصطناعي

قم بتهيئة ضوابط سياسة الإنفاق لوكيل الذكاء الاصطناعي (الحد الأقصى بالدولار USD لكل معاملة، السقف اليومي، عتبة الموافقة التلقائية، الشبكات/الرموز المسموح بها).

curl -X PUT "https://xpayr.com/api/v1/agents/{agent_id}/policy" \
  -H "Authorization: Bearer sk_test_your_workspace_key" \
  -H "Content-Type: application/json" \
  -d '{"max_tx_amount":100,"daily_limit_amount":500,"auto_approve_under":25}'

POST /api/v1/agent-intents تجارة وكلاء الذكاء الاصطناعي

xpayr_submit_agent_payment_intent

إرسال نية دفع ذاتية لوكيل الذكاء الاصطناعي

أرسل نية دفع ذاتية لوكيل الذكاء الاصطناعي يتم تقييمها لحظيًا وفق قواعد سياسة التاجر (approved أو pending_approval أو rejected).

curl -X POST "https://xpayr.com/api/v1/agent-intents" \
  -H "Authorization: Bearer sk_test_your_workspace_key" \
  -H "Content-Type: application/json" \
  -d '{"amount":19.99,"currency":"USDC","network":"arc-testnet","recipient_address":"0xb0bD2f3A86db752dA693D8a686C406E269E57c99","reason":"Monthly GPU cluster invoice #402"}'

GET /api/v1/agent-intents تجارة وكلاء الذكاء الاصطناعي

xpayr_list_agent_payment_intents

عرض نوايا دفع وكلاء الذكاء الاصطناعي وسجلات التدقيق

اعرض نوايا دفع وكلاء الذكاء الاصطناعي وقرارات تقييم السياسات وسجلات مسار التدقيق الخاصة بالتاجر.

curl -X GET "https://xpayr.com/api/v1/agent-intents" \
  -H "Authorization: Bearer sk_test_your_workspace_key"

POST /api/v1/agent-intents/{intent_id}/bridge تجارة وكلاء الذكاء الاصطناعي

xpayr_bridge_agent_intent_to_checkout

ربط نية الوكيل المعتمدة بجلسة دفع

حوّل نية دفع معتمدة لوكيل الذكاء الاصطناعي إلى جلسة دفع XPayr حية قابلة للتنفيذ مع رابط دفع مستضاف وتحقق على السلسلة.

curl -X POST "https://xpayr.com/api/v1/agent-intents/{intent_id}/bridge" \
  -H "Authorization: Bearer sk_test_your_workspace_key"

POST /api/v1/agent-approvals/{intent_id}/approve تجارة وكلاء الذكاء الاصطناعي

xpayr_approve_agent_intent

الموافقة على نية وكيل الذكاء الاصطناعي المعلّقة (بإشراف بشري)

وافق على نية دفع معلّقة لوكيل الذكاء الاصطناعي من قائمة انتظار موافقات التاجر واربطها بجلسة الدفع.

curl -X POST "https://xpayr.com/api/v1/agent-approvals/{intent_id}/approve" \
  -H "Authorization: Bearer sk_test_your_workspace_key" \
  -H "Content-Type: application/json" \
  -d '{"note":"Approved by Treasury Manager"}'

POST /api/v1/agent-approvals/{intent_id}/reject تجارة وكلاء الذكاء الاصطناعي

xpayr_reject_agent_intent

رفض نية وكيل الذكاء الاصطناعي المعلّقة

ارفض نية دفع معلّقة لوكيل الذكاء الاصطناعي في قائمة انتظار موافقات التاجر مع تسجيل سبب للتدقيق.

curl -X POST "https://xpayr.com/api/v1/agent-approvals/{intent_id}/reject" \
  -H "Authorization: Bearer sk_test_your_workspace_key" \
  -H "Content-Type: application/json" \
  -d '{"reason":"Exceeds vendor budget allocation"}'

الأسئلة الشائعة حول تكامل API v1

ما عنوان URL الأساسي ومخطط المصادقة الذي تستخدمه XPayr API v1؟

All REST API v1 endpoints are served from https://xpayr.com/api/v1 using standard Bearer token authentication (Authorization: Bearer sk_test_... for Testnet or sk_live_... for Mainnet). Public endpoints like GET /api/v1/health and GET /api/v1/payments/{session_id}/status require no secret key.

هل يمكنني استيراد XPayr API v1 مباشرةً إلى Postman أو Insomnia أو Bruno أو Cursor؟

نعم! استورد https://xpayr.com/postman.json (مجموعة Postman v2.1) أو https://xpayr.com/.well-known/openapi.json (مواصفة OpenAPI 3.1.0) بنقرة واحدة.

هل استجابات واجهة API على Testnet مطابقة هيكليًا لبيئة Mainnet؟

نعم. الانتقال من sk_test_ إلى sk_live_ يحافظ تمامًا على نفس عناوين URL لنقاط النهاية وأسماء حقول JSON ومخططات أحداث الويب هوك HMAC-SHA256.