التعليمات

الأسئلة الحاسمة في اعتماد حلول الدفع

إجابات واضحة للفرق التي تقارن خيارات الدفع بالعملات الرقمية والتسوية والمدفوعات الجماعية ورعاية رسوم الغاز.

مُراجَع تحريرياً بالاستناد إلى مراجع المنتج وواجهات API والسياسات المعتمدة. عن XPayr · وثائق API · سياسة مكافحة غسل الأموال واعرف عميلك (AML/KYC) · llms.txt

ابدء

أنشئ حساب تاجر، وأضف محفظة دفع، واختر الشبكة والرمز المميز، ثم انشر رابط الدفع أو الأداة أو الزر.
When you create a payment session using a test API key (sk_test_...) on any testnet network, both the hosted checkout page (/test/{session_id}) and the REST API (POST /api/v1/payments/{id}/simulate) allow you to trigger instant simulated outcomes—Completed, Underpaid, Expired, or Failed—without needing testnet faucet tokens. Each simulation generates realistic ledger records and dispatches a signed webhook event to your callback URL.
نعم. استخدم تدفقات testnet للتحقق من صحة الدفع واتصال المحفظة وسلوك الفاتورة قبل الإنتاج.
لا، يمكنك التشغيل بدون أدوات التعليمات البرمجية من لوحة تحكم التاجر واستخدام واجهة برمجة التطبيقات (API) فقط عندما تحتاج إلى عمليات تكامل متقدمة.
ينشر معظم التجار أول عملية دفع للعملات المشفرة خلال دقائق.

المدفوعات والتبرعات

روابط الدفع هي تدفقات الخروج الثابتة. روابط التبرع هي دعم التدفقات المركزة لمساهمات المجتمع.
نعم. تتضمن كل جلسة دفع مكتملة مولّد إيصالات PDF-1.4 فوري (/public/receipt.php?session_id={id}&download=1) وعرض HTML قابل للطباعة. يعرض الإيصال معرّف الفاتورة ومعرّف الجلسة واسم التاجر والمبلغ الإجمالي ورسوم بوابة XPayr وصافي مبلغ التسوية والرمز الرقمي والشبكة وعناوين محفظتي المرسل والمستلم والطابع الزمني UTC ومُعرّف المعاملة على السلسلة.
نعم. يمكن للروابط القابلة لإعادة الاستخدام جمع مدفوعات متعددة بمرور الوقت بناءً على تدفق حملتك.
استخدم عنصر واجهة المستخدم للدفع المضمن، وزر الحث على اتخاذ إجراء ذي العلامة التجارية، والرابط المباشر للمشاركة السريعة في الدردشات أو وسائل التواصل الاجتماعي.
نعم. يمكنك السماح بمبالغ مخصصة أو الاحتفاظ بمبالغ ثابتة اعتمادًا على التدفق الذي تقوم بتكوينه.
نعم. يتميز XPayr بوضع الدفع المزدوج: الدفع بنقرة واحدة عبر Web3 لمعاملات محفظة المتصفح المباشرة، والتحويل المباشر / رمز الاستجابة السريعة (QR) للعملاء الذين يدفعون من منصات التداول المركزية (Binance وBybit وOKX وغيرها) أو محافظ الهاتف المحمول. يمكن للعملاء ببساطة مسح رمز QR أو نسخ عنوان المستلم وتحويل الأموال وإدخال تجزئة المعاملة (TxID) أو السماح لمستكشف البلوكشين باكتشاف الدفع تلقائيًا. كما تم دمج نسبة تسامح مع رسوم السحب بنسبة 1% (بحد أقصى 0.50 دولار).
عند إنشاء رابط دفع أو صفحة تبرع، يمكن للتجار اختيار "جميع الشبكات (يختار العميل عند الدفع)". بدلاً من تقييد الدافع بشبكة بلوكشين واحدة أو عملة معينة، توفر صفحة الدفع أداة تحديد شبكة واضحة. يمكن للعميل الدفع باستخدام شبكات EVM (Ethereum وBSC وPolygon وArbitrum وAvalanche) أو TRON USDT أو Solana، ويقوم النظام تلقائيًا بتحميل التوجيه الصحيح ومعلمات العقد ومحفظة المستلم.

المحفظة والشبكات

يدعم XPayr محافظ المتصفح المتوافقة مع EIP وتدفقات اتصال المحفظة الحديثة.
المحفظة المحددة غير مسجلة لهذه السلسلة في إعدادات التاجر الخاصة بك. قم بإضافته وتسجيله للشبكة المحددة.
نعم. افصل المحفظة الحالية وأعد الاتصال بالعنوان الذي تريد استخدامه قبل إنشاء الدفع أو تأكيده.
افتح محافظ الدفع في لوحة التاجر، وحدد الشبكة، وألصق عنوان المحفظة، ثم احفظها بعد التحقق من الصحة.

الرسوم والتسوية

يطبق XPayr رسوم بوابة شفافة بنسبة 0.5 بالمائة. رسوم غاز الشبكة هي تكاليف blockchain وتختلف حسب ولاية السلسلة.
تبدأ XPayr برسوم بوابة شفافة قدرها 0.50% (50 bps) على خطة Starter المجانية ($0/شهرياً). ويمكن للتجار الترقية إلى خطة Growth Pro ($49/شهرياً مقابل رسوم أساسية 0.30% / 30 bps) أو خطة Enterprise Scale ($199/شهرياً مقابل رسوم أساسية 0.15% / 15 bps). علاوة على ذلك، تحتسب XPayr تلقائياً حجم معاملاتك المكتملة بالدولار على الشبكة الرئيسية خلال آخر 30 يوماً وتطبّق خصم مرتبة الحجم: Bronze ($0+ = 0 bps)، وSilver ($10,000+ = -5 bps)، وGold ($50,000+ = -10 bps)، وDiamond ($250,000+ = -15 bps)، مما يخفض رسوم البوابة الفعلية إلى حد أدنى يبلغ 0.05% (5 bps).
يتم دفع تكاليف الغاز على السلسلة من قبل مرسل المعاملة وفقًا لظروف الشبكة وتدفق الرمز المميز المحدد.
بعد تأكيد السلسلة، تنتقل الأموال مباشرة إلى تدفق محفظتك التي تم تكوينها.
لا توجد رسوم بوابة مخفية. ترى رسوم النظام الأساسي وتكاليف الشبكة بوضوح في التدفق.

الأمن والامتثال

استخدم المصادقة الثنائية (2FA) وعناصر تحكم القائمة البيضاء والتحقق من صحة توقيع webhook لتأمين الحساب وعمليات الدفع.
لا. تظل العلامة التجارية الأساسية للثقة مرئية بينما تظهر عناصر علامتك التجارية في رأس صفحة الدفع.
إنه يقيد الإجراءات الحساسة لعناوين IP المعتمدة ويقلل من إجراءات المسؤول غير المصرح بها.
نعم. تمكين فرض القائمة البيضاء للسماح بالمدفوعات فقط للمحفظة وأزواج العملات المعتمدة.

واجهة برمجة التطبيقات وخطافات الويب

تحقق من صحة رأس التوقيع باستخدام سر خطاف الويب الخاص بك قبل معالجة بيانات الحمولة النافعة.
Yes. Merchants can generate a dedicated HMAC secret in the API Keys dashboard and send X-Signature and X-Timestamp headers (with a 300-second anti-replay window) on API requests. When creating a payment session via POST /api/v1/payments, you can also pass ipn_url (or ipn_callback_url) to route webhooks dynamically per store/order, and allow_payment_methods (["web3", "direct", "gasless"]) to control which checkout tabs are shown to the buyer.
يحدد مفتاح API سياق التكامل. يسمح المفتاح السري بطلبات API المحمية من جانب الخادم.
تتضمن الحالات الشائعة "معلق" و"مؤكد" و"فشل" و"منتهية الصلاحية" مع أحداث التحديث ذات الصلة.
استخدم الكفاءة في الواجهة الخلفية لديك وقم بتخزين معرفات الأحداث التي تمت معالجتها قبل تطبيق تحديثات الأعمال.
نعم. عند إنشاء جلسة عبر نقطة نهاية POST /payments أو لوحة تحكم التاجر، قم بتعيين send_invoice_email إلى true وقدم customer_email. يرسل XPayr على الفور فاتورة بريد إلكتروني بتنسيق HTML متجاوبة ومميزة بالرمز التجاري مع تفاصيل الدفع وزر الدفع بنقرة واحدة. يتم إرسال إشعارات Webhook عند إتمام الدفع.

استكشاف الأخطاء وإصلاحها

ويعني هذا عادةً عدم تطابق الشبكة، أو عدم تطابق الرمز المميز، أو فقدان تسجيل المحفظة، أو رفض التحقق من صحة العقد.
تحقق من أن الفاتورة تخص حساب التاجر الخاص بك وأن بيانات الجلسة موجودة في البيئة الحالية.
وصلت الجلسة إلى الحد الزمني المحدد لها أو تم الانتهاء منها بالفعل من خلال التدفق المكتمل.
تحقق من تثبيت ملحق المحفظة، وإلغاء قفله، على السلسلة الصحيحة، وعدم حظر النوافذ المنبثقة بواسطة إعدادات المتصفح.

الحساب والفريق

نعم. يمكن للفرق مشاركة سير العمل التشغيلي بينما تظل ضوابط الدفع مركزية.
استخدم خطوات تدفق واسترداد كلمة المرور المنسية، ثم قم بتحديث إعدادات الأمان بعد استعادة الوصول.
افتح مفاتيح API في لوحة التاجر لإنشاء بيانات الاعتماد وتدويرها وإبطالها.
نعم. يمكن للمستخدمين الإداريين تجاوز صفحة الصيانة بينما لا يزال الزوار العموميون يرون شاشة الصيانة.

برنامج الشركاء والإحالة

تقدم XPayr بنية تحتية هجينة للشراكة تدعم كلاً من التتبع المؤسسي عبر Impact.com S2S والتسوية المباشرة عبر العقود الذكية لـ Web3.

عند إحالة تاجر أو مطور، تكسب حصة أرباح متكررة بنسبة 30% من رسوم البوابة أو مكافأة CPA بقيمة 50 دولاراً لكل تاجر نشط.
عندما ينقر الزائر على رابط الإحالة الخاص بك، تحفظ XPayr معرف النقر لمدة 30 يوماً في ملف تعريف ارتباط آمن.

عند إتمام التسجيل أو الشراء، ترسل XPayr إشعاراً مباشراً من الخادم إلى الخادم (S2S) إلى Impact.com لضمان تتبع دقيق بنسبة 100%.
يمكنك الاختيار من بين نموذجين:

1. 30% مشاركة أرباح متكررة: احصل على 30% من رسوم XPayr البالغة 0.5% مدى الحياة على كل معاملة.
2. 50 دولاراً CPA لكل تفعيل: احصل على 50 دولاراً بمجرد معالجة التاجر لأول 100 دولار من المعاملات.
قم بربط محفظتك في لوحة تحكم التاجر (/merchant/affiliate).

يخصص العقد الذكي عمولتك البالغة 30% تلقائياً. انقر على زر 'Claim' لسحب رصيدك من USDT أو USDC أو SOL مباشرة وبدون أي تأخير.
قم بزيارة استوديو موارد العلامة التجارية على /brand-assets.

يمكنك إنشاء شارات SVG ديناميكية ونسخ رموز التضمين للرايات الإعلانية القياسية (728x90 و 300x250 و 1200x630) بنقرة واحدة.
لا. يتم استبعاد الإحالات الذاتية والمعاملات الوهمية وشبكات الاختبار تلقائياً بواسطة أنظمة الأمان ومكافحة الاحتيال.

كيف تتحقّق XPayr من ادعاءات الدفع والمحتوى المنشور؟

تربط XPayr البيانات العامة بمصادر المنتج والسياسات والحوكمة بحيث يتمكّن التجار وأنظمة الذكاء الاصطناعي من التحقق من المعلومات بسرعة.