قائمة فحص تشغيلية لمدفوعات العملات الرقمية

قبل الإطلاق

نفّذها مرة واحدة وكرّرها بعد أي تغيير في خادمك.

• مفتاح API على الخادم فقط، في متغير بيئة أو مدير أسرار، وليس في كود الواجهة الأمامية أو في مستودع.
• عنوان callback محفوظ وعام ويعمل عبر HTTPS، ويمكن الوصول إليه من خارج شبكتك.
• معالج webhook يردّ بـ HTTP 200 بالضبط، بسرعة، ومن الآمن تشغيله مرتين. أي حالة أخرى أو انتهاء مهلة أو إعادة توجيه تُعدّ تسليمًا فاشلًا. راجع كيف تؤمّن webhooks مدفوعات العملات الرقمية.
• دفعة تجريبية تعمل من البداية إلى النهاية. ادفع مبلغًا حقيقيًا صغيرًا، وشاهد وصول webhook وتحوّل الطلب إلى مدفوع. لا توجد بيئة sandbox بعد، لذا استخدم مبالغ حقيقية صغيرة.
• إعادة المحاولة تعمل. اجعل نقطة النهاية تفشل مرة وتأكد أن Qvard تعيد المحاولة (خمس محاولات خلال نحو ست دقائق) دون تنفيذ الطلب مرتين.
• السحب يعمل. اسحب مبلغًا صغيرًا إلى محفظتك. يكلّف رسوم الشبكة فقط.
• القواعد مكتوبة: ماذا تفعل مع دفعة ناقصة، وكيف تردّ الأموال، ومن يجيب العملاء.

كل يوم

بضع دقائق، ويفضّل في الوقت نفسه.

• طلبات غير مدفوعة تجاوزت نافذة السعر. السعر في صفحة الدفع ثابت لمدة ساعة. راجع الطلبات التي ما زالت تنتظر بعد ذلك: إما تُركت أو فاتَ إشعار.
• دفعات ناقصة. الدفعة بحالة partial لا ترسل webhook الاكتمال. افحصها في لوحة التحكم، وأبقِ الطلب معلّقًا وتواصل مع العميل. راجع كيف تتعامل مع نقص مدفوعات USDT.
• أخطاء في نقطة webhook. سلسلة من الطلبات الفاشلة أو ردود 401 تعني نقطة معطلة أو عدم تطابق المفتاح. اضبط تنبيهًا بدل اكتشافه في نهاية اليوم.
• الإجمالي اليومي. قارن الطلبات التي وسمتها مدفوعة بالدفعات في لوحة التحكم. واجهة API العامة ليس فيها مسار لسرد الدفعات، لذا هي مقارنة مع سجل webhook الخاص بك. راجع مطابقة المدفوعات لتجّار العملات الرقمية.

كل أسبوع

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

كل شهر

• مطابقة كاملة. طابق طلبات الشهر وسجل webhook ودفعات لوحة التحكم، واشرح كل فرق. سجّل الإيراد بالدولار بقيمة الطلب، وسجّل العمولة ورسوم السحب في بنود منفصلة.
• راجع عمليات السحب. لا توجد رسوم اشتراك؛ العمولة فردية لمشروعك، وبحسب صفحة الأسعار تبدأ من 1% ويمكن أن تنخفض إلى 0.1%. السحب يكلّف رسوم الشبكة فقط، وهي عادة مبلغ ثابت لكل تحويل، لذا اسحب بأحجام معقولة بدل سحوبات صغيرة كثيرة. راجع رسوم الشبكة في عمليات الدفع بالعملات الرقمية.
• دوّر الصلاحيات وراجعها. تحقق من يرى مفتاح API ولوحة التحكم، وبدّل المفتاح إن غادر شخص كان يملكه أو إن شككت بتسريب.
• أعد قراءة نص العملاء. هل ما زالت صفحة الدفع تذكر الأصول والشبكات المقبولة وملاحظة الرسوم وقاعدة الاسترداد؟ وهل ما زال صحيحًا؟
• استشر محاسبك. المعالجة الضريبية والمحاسبية لمتحصلات العملات الرقمية تعتمد على بلدك؛ راجع الممارسة بانتظام.

عندما يبدو أن شيئًا خاطئ

سيناريو قصير للحالات الشائعة.

• عميل يقول إنه دفع والطلب غير مدفوع. انظر إلى الدفعة في لوحة التحكم. إن كانت مكتملة فأعد إرسال الإشعار. إن كانت partial فاطلب الفرق. إن لم تكن موجودة فاطلب تفاصيل المعاملة والشبكة التي استخدمها.
• شبكة خاطئة. لا تصل الأموال كما هو متوقع وتتطلب معالجة يدوية. أبقِ جهة اتصال الدعم ظاهرة في مسار الدفع.
• طلب مدفوع نُفّذ مرتين. المعالج ليس idempotent. اجعل التحديث مشروطًا («مدفوع فقط إن لم يكن مدفوعًا») في عبارة قاعدة بيانات واحدة.
• توقف webhook عن الوصول. اختبر نقطة النهاية من خارج شبكتك، وانظر إلى رمز الرد في سجل الوصول، وابحث عن جدار ناري أو إعادة توجيه أو معالج بطيء. راجع استراتيجية إعادة محاولة webhook لأنظمة الدفع.
• لست متأكدًا مما تفعله API. المرجع هو واجهة API لمدفوعات العملات الرقمية للمطورين.

احتفظ بهذه القائمة حيث يراها فريقك كله، ودوّن من المسؤول عن كل سطر.

FAQ