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

نظرة عامة على Payment Intents

Payment Intents هي الطريقة الأساسية لقبول مدفوعات الكريبتو مع OrcaRail. توفر طريقة آمنة ومرنة لتحصيل المدفوعات من عملائك.

ما هي Payment Intents؟​

يمثل Payment Intent نيتك في تحصيل دفعة من عميل. ويتتبع دورة حياة الدفعة من الإنشاء حتى الاكتمال.

يستخدم تدفق Payment Intent نمطًا مألوفًا من الإنشاء ثم التأكيد ثم التوجيه لمدفوعات العملات المستقرة:

  1. أنشئ PaymentIntent للحصول على client_secret
  2. أكّد الـ intent للحصول على next_action.redirect_to_url.url
  3. وجّه المستخدم إلى تطبيق الدفع المستضاف
  4. بعد تأكيد الدفع، يُعاد المستخدم إلى return_url الخاص بك مع معاملات الاستعلام

حالات Payment Intent​

تمر Payment Intents بعدة حالات خلال دورة حياتها:

  • requires_payment_method — أُنشئ الـ PaymentIntent لكن لم تُرفق به طريقة دفع بعد
  • requires_confirmation — للـ PaymentIntent طريقة دفع مرفقة لكنه يحتاج إلى تأكيد
  • processing — الـ PaymentIntent قيد المعالجة
  • succeeded — نجح الـ PaymentIntent وعولجت الدفعة
  • canceled — أُلغي الـ PaymentIntent

طرق الدفع المدعومة​

تدعم OrcaRail حاليًا:

  • الكريبتو — مدفوعات العملات المستقرة (USDC وUSDT وغيرها)

الشبكات المدعومة​

تدعم OrcaRail المدفوعات على عدة شبكات بلوكتشين. يجب أن تحدد كلًا من tokenId وnetworkId عند إنشاء Payment Intent.

من الشبكات الشائعة:

  • Ethereum
  • Polygon
  • Base
  • Arbitrum

للصورة الكاملة عن الشبكات والعملات المدعومة (بتقنية Relay وتُحدَّث تلقائيًا)، راجع مدونتنا: الشبكات والعملات المدعومة.

تدفق الدفع​

مفاهيم أساسية​

Client Secret​

client_secret معرّف فريد للـ Payment Intent. يُستخدم لتأكيد الـ Payment Intent ويجب حفظه بأمان. ولا يُعرض إلا مرة واحدة عند إنشاء الـ Payment Intent.

رابط العودة​

return_url هو المكان الذي يُوجَّه إليه العملاء بعد إكمال الدفع أو إلغائه. يجب أن تعالج في هذه الصفحة حالتي النجاح والفشل.

البيانات الوصفية​

يمكنك إرفاق metadata مخصصة بالـ Payment Intents. وهذا مفيد لتخزين معلومات إضافية عن الدفعة، مثل معرّفات الطلبات أو بيانات العميل.

عنوان السحب​

عند إنشاء Payment Intent أو تحديثه، يمكنك اختياريًا تعيين withdrawal_addresses (كائن مفتاح-قيمة: نوع الشبكة إلى العنوان، مثل { "evm": "0x...", "solana": "..." }). إذا عُيّن لنوع شبكة، تُسحب الأموال إلى ذلك العنوان عند تشغيل السحب التلقائي. وإذا حُذف أو كان فارغًا لشبكة ما، يُستخدم الافتراضي في حسابك من إعدادات السحب لذلك النوع من الشبكات.

الرسوم والحدود الدنيا​

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

لكل دفعة (عرض السعر): قد تتضمن المدفوعات رسوم دعم، وعمولة (من مفتاح API الخاص بك)، ورسوم جسر عندما يستخدم الدافع رمزًا أو شبكة مختلفة. وتخضع المبالغ أيضًا لـ الحدود الدنيا للدفع والحدود الدنيا للسحب الاختيارية. للتفاصيل الكاملة، راجع الرسوم والحدود.

الخطوات التالية​