في هذه الصفحة
البدء
جديد في Eppay؟ تغطي هذه الخطوات الثلاث كل ما يحتاجه التاجر قبل قبول أول دفعة مشفرة.
١. أنشئ حسابك وفعّل بريدك الإلكتروني
سجّل على eppay.io بالبريد الإلكتروني أو تسجيل الدخول الاجتماعي (Google، Facebook). أكّد البريد الذي يصل إلى صندوقك حتى نتمكن من إرسال إشعارات الدفع وتنبيهات الأمان.
٢. أضف عنوان محفظة المستلم
افتح الإعدادات والصق عنوان محفظة تتحكم فيه على كل بلوكتشين تخطط لقبول المدفوعات عليه. لا تحتفظ Eppay أبداً بالأموال — تسوى كل دفعة مباشرة إلى العنوان الذي تحدده.
٣. أنشئ مفتاح API أو أنشئ رابط دفع
للفواتير الفردية، أنشئ منتجاً وشارك رابط الدفع المُستضاف. لتكاملات الدفع، أنشئ مفتاح API من علامة التبويب API واستدعِ POST /api/v2/create-payment لإنشاء الروابط برمجياً.
المدفوعات والتأكيدات
تعالج Eppay مدفوعات العملات المستقرة USDT وUSDC عبر الشبكات أدناه. لكل سلسلة سرعات تأكيد ورسوم مختلفة.
الشبكات المدعومة
Ethereum وBinance Smart Chain (BSC) وPolygon وArbitrum وAvalanche وFantom وCronos وCelo وCosmos. نواصل إضافة سلاسل بناءً على طلب التجار — أخبرنا بالشبكة التي تحتاجها.
العملات المدعومة
USDT (Tether) وUSDC (USD Coin) على كل سلسلة مدعومة. كلاهما عملتان مستقرتان مرتبطتان بالدولار الأمريكي، لذا فإن المبلغ الذي يرسله العميل يطابق السعر المعروض عند الدفع.
كم تستغرق التأكيدات؟
يعتمد وقت التأكيد على السلسلة. على BSC وPolygon وArbitrum، تكتمل المدفوعات عادة في أقل من دقيقة بكثير. على شبكة Ethereum الرئيسية، توقّع نحو ١-٣ دقائق في الظروف الطبيعية، وأطول عند ارتفاع الرسوم. تضع Eppay علامة "مكتمل" على الدفعة بمجرد وصول المعاملة على السلسلة إلى عمق التأكيد المطلوب.
من يدفع رسوم الشبكة؟
يدفع العميل رسوم الـ gas على السلسلة التي يختارها. لا تتقاضى Eppay رسوماً من الدفعة نفسها بخلاف رسوم المنصة المُعلنة في لوحة حسابك.
ماذا يحدث إذا دفع العميل أقل؟
إذا أرسل العميل أقل من المبلغ المطلوب، يُسجَّل الدفع كدفعة جزئية ويظل الرابط مفتوحاً حتى يصل الرصيد المتبقي أو ينتهي صلاحية الرابط. تُدار استرداد المدفوعات الجزئية مباشرة بينك وبين العميل؛ Eppay لا تحتفظ بالأموال.
API والتكاملات
تقدّم Eppay واجهة REST API وتطبيق Shopify وحزمة JavaScript SDK لدمج الدفع في أي حزمة ويب.
من أين أحصل على مفتاح API؟
سجّل الدخول، افتح علامة التبويب API من لوحة التحكم، وانقر على إنشاء مفتاح API. كل مفتاح مرتبط بحسابك ويمكنك إلغاءه وتدويره في أي وقت. تعامل مع مفاتيح API كما تتعامل مع كلمات المرور وخزّنها في الجانب الخادم فقط.
هل أستخدم API v1 أم v2؟
استخدم v2 لجميع التكاملات الجديدة. نقاط نهاية v2 (POST /api/v2/create-payment، GET /api/v2/payments/{id}/status) هي المعيار المدعوم. لا تزال نقاط نهاية v1 تستجيب للمستدعين القدامى لكن لا ينبغي استخدامها للأعمال الجديدة.
هل تدعمون Webhooks؟
نعم. اضبط عنوان webhook في حسابك، وستقوم Eppay بإرسال POST لحمولة JSON موقعة عند تغير حالة دفعة. تحقّق من رأس التوقيع عندك قبل الوثوق بالحدث.
كيف يعمل تكامل Shopify؟
ثبّت تطبيق Eppay من متجر Shopify App Store، اربطه بحساب Eppay، وستصبح العملات المشفرة خياراً للدفع لعملائك. تُسوى المدفوعات إلى المحفظة المُهيأة في Eppay؛ تُوسم الطلبات تلقائياً كمدفوعة في Shopify بمجرد تأكيد المعاملة على السلسلة.
الحساب والأمان
بعض الأسئلة الشائعة عن الحساب:
نسيت كلمة المرور
استخدم رابط "نسيت كلمة المرور" في صفحة تسجيل الدخول. سنرسل بالبريد رابط إعادة تعيين صالحاً لـ ٦٠ دقيقة. إذا لم تصل الرسالة، تحقّق من الرسائل غير المرغوب فيها وأكّد العنوان الذي سجّلت به.
كيف أفعّل المصادقة الثنائية؟
افتح إعدادات ملفك الشخصي واتبع معالج إعداد 2FA. نوصي بتفعيل 2FA قبل إضافة عناوين المحافظ أو إنشاء مفاتيح API.
هل يمكنني تغيير عنوان محفظتي؟
نعم. حدّث العنوان من الإعدادات في أي وقت. ستوجه المدفوعات المستقبلية إلى العنوان الجديد. أما المدفوعات الجارية فعلاً فتُسوى إلى العنوان الذي كان نشطاً عند إنشاء رابط الدفع.
استكشاف الأخطاء
أكثر خمس مشكلات شيوعاً وكيفية حلها:
دفعتي عالقة في "قيد الانتظار"
"قيد الانتظار" تعني أن المعاملة بُثّت لكنها لم تصل إلى عمق التأكيد المطلوب على السلسلة. ابحث عن hash المعاملة في مستكشف بلوكات (etherscan.io لـ Ethereum، bscscan.com لـ BSC، polygonscan.com لـ Polygon، إلخ) للتأكد من تعدينها. إذا ظهرت مؤكدة على السلسلة لكنها لا تزال قيد الانتظار في Eppay بعد ١٠ دقائق، تواصل معنا مرفقاً hash المعاملة.
دفع العميل على السلسلة الخطأ
إذا تلقّيت دفعة على سلسلة تتحكم فيها بنفس عنوان المحفظة (تتشارك معظم سلاسل EVM نفس صيغة العنوان)، فإن الأموال قابلة للاسترجاع من تلك السلسلة. أما إذا أرسل العميل إلى سلسلة لا تملك مفاتيحها، فالأموال لا يمكن استعادتها عبر Eppay للأسف.
مفتاح API يعيد 401 Unauthorized
تحقّق من أنك تمرر المفتاح في رأس Authorization كرمز Bearer، وأنه لم يُلغَ في لوحة التحكم، وأنك تستدعي البيئة الصحيحة. كحل أخير أعد توليد المفتاح.
المبلغ المعروض لا يطابق المرسَل
تُسعّر Eppay المبالغ بالعملات المستقرة (USDT أو USDC)، إذن ١ USDT داخل = ١ USDT خارج — لا يوجد تحويل عملات. إذا أرسل العميل عملة مختلفة (مثل ETH بدلاً من USDT)، لن تتطابق الدفعة. تختلف دقة الكسور حسب السلسلة؛ نعرض افتراضياً ست خانات عشرية.
webhook لا يُطلق أبداً
تأكد أن العنوان متاح علناً (ليس localhost أو مضيفاً عبر VPN فقط)، يستجيب بـ HTTP 2xx خلال ٥ ثوانٍ، ولا يحجب جدار حماية عناويننا. نعيد محاولة التسليمات الفاشلة بتأخير أُسي حتى ٢٤ ساعة.
أوقات الاستجابة
نسعى للرد على كل بريد إلكتروني خلال يوم عمل واحد (الإثنين-الجمعة). تُعطى الأولوية للمشاكل العاجلة التي تعطّل المدفوعات. ساعات العمل بتوقيت أوروبا الوسطى، لكن الفريق موزّع وغالباً ما يردّ خارج هذه الساعات.
للحصول على رد أسرع، يرجى تضمين في رسالتك الأولى: بريد الحساب، ومعرّف الدفع أو hash المعاملة إن وُجد، والشبكة، ولقطة شاشة أو رسالة الخطأ.
الاستفسارات التجارية والشراكات
للشراكات والتكاملات على نطاق واسع وشروط التسوية المخصّصة أو الاستفسارات الإعلامية، راسل info@eppay.io مع كتابة "Partnership" في الموضوع ووصف موجز لما تبنيه. نرد على كل استفسار جدي خلال يومي عمل.
تبحث عن الوثائق التقنية؟
تغطي وثائق المطورين لدينا مرجع API الكامل، حمولات webhook، استخدام SDK، وأمثلة برمجية بعدة لغات.
افتح الوثائق ←