إنتقل إلى المحتوى الرئيسي

توثيق OrcaRail API لبوابة الدفع بالعملات الرقمية

مرحبًا بك في توثيق OrcaRail API. يوفر OrcaRail واجهة برمجية (API) و SDK قياسية وسهلة للمطورين لقبول الدفع بالعملات الرقمية (العملات المشفرة أو الكريبتو) عبر العملات المستقرة مثل USDT (تيثر) و USDC.

البدء السريع​

  1. افتح لوحة التحكم وأنشئ حسابًا (أو سجّل الدخول)؛ راجع إنشاء حساب.
  2. أنشئ مؤسستك الأولى (organization) بعد تسجيل الدخول. يتطلب OrcaRail وجود مؤسسة قبل المتابعة في لوحة التحكم.
  3. أنشئ مفاتيح API من لوحة التحكم ← API Keys.
  4. استخدم Node.js SDK أو PHP SDK، أو جرّب التطبيق التجريبي.
  5. أنشئ Payment Intent لتبدأ في قبول المدفوعات.

ما هو OrcaRail؟​

OrcaRail هو بوابة دفع بالعملات الرقمية تتيح لك استلام المدفوعات من عملائك بالعملات المستقرة. باستخدام OrcaRail يمكنك:

  • ✅ قبول المدفوعات بالعملات المستقرة (USDC و USDT وغيرها)
  • ✅ إنشاء Payment Intent مع صفحة دفع مستضافة (hosted pay)
  • ✅ استلام إشعارات Webhook فورية
  • ✅ دعم عدة شبكات بلوكتشين (نظرة عامة على تعدد الشبكات)
  • ✅ تشغيل الفوترة المتكررة عبر الاشتراكات، بما في ذلك الخصم التلقائي (auto-charge) على EVM و Solana
  • ✅ إدارة المدفوعات عبر API و SDK قياسية وسهلة

الأسعار: تكلّف نسخة OrcaRail المستضافة 0.5% من كل معاملة مكتملة مع أول 1,000 معاملة مجانًا؛ أما الاستضافة الذاتية فلا نتقاضى عنها أي رسوم برمجية. حزم SDK و MCP والإضافات مرخّصة بـ MIT؛ أما حزمة api / app / pay المستضافة فليست مفتوحة المصدر. قد تتضمن عروض أسعار الدفع بنودًا اختيارية منفصلة (دعم، عمولة، جسر) — راجع الرسوم والحدود.

الميزات الرئيسية​

Payment Intents (نوايا الدفع)​

أنشئ Payment Intent لتحصيل المدفوعات من عملائك. التدفق بسيط:

  1. أنشئ Payment Intent
  2. أكّده (confirm) للحصول على رابط إعادة التوجيه
  3. وجّه العملاء إلى صفحة الدفع المستضافة
  4. استلم إشعارات Webhook

اعرف المزيد عن Payment Intents ←

الاشتراكات​

حصّل مدفوعات متكررة بالعملات الرقمية عبر API الاشتراكات في OrcaRail: فترات ثابتة، فترات تجريبية، رابط دفع لكل دورة، أو الخصم التلقائي (سحب دوري بعد موافقة الدافع على EVM أو Solana).

نظرة عامة على الاشتراكات ←

تعدد الشبكات (Multichain)​

اقبل المدفوعات على شبكات عديدة، واضبط عناوين السحب لكل نوع من السلاسل، وحافظ على تزامن الشبكات والرموز المدعومة مع Relay. تظهر القوائم المحدّثة في الشبكات والرموز.

نظرة عامة على تعدد الشبكات ←

Webhooks​

استلم إشعارات فورية بأحداث الدفع:

  • payment_intent.completed - اكتمل الدفع
  • payment_intent.processing - الدفع قيد المعالجة
  • payment_intent.canceled - أُلغي الدفع

اضبط Webhooks لكل مفتاح API وراقب التسليم عبر سجلات Webhook.

اعرف المزيد عن Webhooks ←

المصادقة​

يدعم OrcaRail طريقتين للمصادقة:

  • Bearer Token (JWT) - للطلبات المصادَق عليها من المستخدم
  • مفاتيح API (Basic Auth) - للطلبات من خادم إلى خادم

اعرف المزيد عن المصادقة ←

Node.js SDK​

ادمج المدفوعات باستخدام SDK الرسمية. ثبّتها من npm: @orcarail/node.

  • إنشاء Payment Intents وتأكيدها
  • الدفع عبر slug
  • التحقق من توقيعات Webhook وتحليل الأحداث

دليل Node.js SDK ←

PHP SDK​

ادمج المدفوعات من PHP 8.1 فما فوق عبر حزمة Composer الرسمية orcarail/orcarail-php.

  • عميل واحد OrcaRailClient بخدمات lazy
  • Payment Intents والاشتراكات والدفع عبر slug والكتالوج والأسعار
  • التحقق من توقيعات Webhook وتحليل الأحداث

دليل PHP SDK ←

خادم MCP​

اربط وكلاء البرمجة بالذكاء الاصطناعي — Claude Code و Cursor و Codex — بخادم Model Context Protocol الرسمي @orcarail/mcp.

  • إنشاء Payment Intents وتأكيدها من الوكيل
  • إدارة الاشتراكات والمنتجات والأسعار
  • الاطلاع على أسعار الصرف وتفاصيل صفحة الدفع (دون بيانات اعتماد لـ rates.* / pay.*)

دليل خادم MCP ←

التطبيق التجريبي​

شغّل التطبيق التجريبي مفتوح المصدر لترى التدفق كاملًا: إنشاء intent، والتوجيه إلى صفحة الدفع، وصفحة النجاح، و Webhooks.

دليل التطبيق التجريبي ←

البدء​

جديد على OrcaRail؟ ابدأ من هنا:

تتطلب جلستك الأولى في لوحة التحكم إنشاء مؤسسة قبل أن تتمكن من إنشاء مفاتيح API.

  1. البدء - أنشئ حسابًا ومؤسسة ومفاتيح API
  2. Node.js SDK - التكامل عبر @orcarail/node، أو PHP SDK عبر orcarail/orcarail-php
  3. التطبيق التجريبي - شغّل العرض التجريبي مفتوح المصدر (GitHub)
  4. دليل Payment Intents - تعلّم كيف تقبل المدفوعات
  5. دليل Webhooks - فعّل إشعارات الدفع
  6. إعداد Webhook - اضبط Webhooks لمفاتيح API
  7. الاشتراكات - المدفوعات المتكررة والخصم التلقائي
  8. تعدد الشبكات - الشبكات والسحب والتوافق مع Relay
  9. مرجع API - توثيق API الكامل

هل تحتاج إلى مساعدة؟​

الدعم​

للدعم، راسلنا على [email protected] أو زر مستودع GitHub.