قنوات الدفع
أين تجد ذلك في لوحة الإدارة: Finance › Payment channels (
/payments). المفاتيح والرسوم: Finance › Payment channels › Fees & limits (/payments/fees).
تستخدم NexCMP محفظة USD مسبقة الدفع. يقوم العملاء بإضافة الأموال إلى المحفظة من خلال قناة دفع؛ يتم بعد ذلك دفع ثمن كل خدمة من المحفظة. لا يتم إظهار القناة للعملاء إلا عندما تكون ممكنة ومكوّنة.
الوظيفة
تربط قنوات الدفع حساباتك المالية (Stripe، PayPal، Binance، بنك فيتنامي) بمحفظة العميل. يتحول الدفع المؤكد بدقة إلى رصيد واحد في المحفظة — وكل رصيد مُعرّف بمعرف الدفع الخاص ببوابة الدفع، بحيث لا يمكن أبداً لعملية Webhook مكررة أن تضيف أموالاً مرتين. استخدم هذه الصفحة لمعرفة القنوات الجاهزة، وأدائها خلال آخر 30 يوماً، وتلك التي تحتاج إلى اهتمام.
المتطلبات
| العنصر | المتطلب |
|---|---|
| عنوان HTTPS العام | ترسل البوابات إشعارات الـ Webhook إلى https://<domain>/v1/billing/...، لذا يجب أن تكون لوحتك قابلة للوصول من الإنترنت عبر بروتوكول TLS صالح (انظر DNS and Cloudflare). |
| الحسابات | حسابك الخاص لدى كل مزود ترغب في استخدامه. تُدخل بيانات الاعتماد في لوحة الإدارة ولا تظهر مرة أخرى أبداً (يُعرض فقط آخر 4 أحرف). |
| دور المشرف | حساب مسؤول. |
| الاعتمادات | لا شيء. قناة البنك الفيتنامي تحتاج بشكل إضافي إلى سعر صرف. |
القنوات
| القناة | ما يراه العميل | الإعداد في | المقالة |
|---|---|---|---|
| البطاقة (Stripe) | نموذج البطاقة، البطاقة المحفوظة | Payment channels › Stripe | Stripe |
| Apple Pay, Google Pay, Link | أزرار المحفظة (Stripe Express Checkout) | Stripe، بالإضافة إلى تسجيل النطاق | Stripe |
| Alipay | إعادة التوجيه إلى Alipay (تتم المفوترة بالين الياباني بواسطة Stripe) | Stripe، بالإضافة إلى Fees & limits | Stripe |
| PayPal | أزرار PayPal، حساب PayPal المحفوظ | Payment channels › PayPal | PayPal |
| USDT | عنوان الإيداع والمبلغ المحدد | Payment channels › USDT | USDT |
| تحويل بنكي فيتنامي | رمز الاستجابة السريعة وتفاصيل التحويل (الواجهة الفيتنامية فقط) | في Payment channels › VN bank transfer | Bank transfer (Vietnam) |
تجهيز البنية التحتية
غير مطلوب. كل شيء مُعد في لوحة الإدارة؛ ولا يوجد شيء لتثبيته على الخادم.
الربط في NexCMP
- افتح Finance › Payment channels (
/payments). يوضح جدول النظرة العامة كل قناة مع حالتها. - افتح علامة التبويب الخاصة بالقناة (Stripe، PayPal، USDT، VN bank transfer) واتبع مقالتها. تنتهي كل علامة تبويب بزر Save، وحيثما يتوفر، بزر Test.
- افتح Fees & limits (
/payments/fees)، وابحث عن بطاقة Payment gateways & fees (wallet top-up)، وفعل القناة بمفتاحها وانقر على Save channels & fees.
المفاتيح والرسوم (Fees & limits)
| الإعداد | القيمة الافتراضية | المعنى |
|---|---|---|
| البطاقة (Stripe) | On | نموذج البطاقة على شاشة الإيداع. مخفي حتى تتوفر مفتاح سري لـ Stripe. |
| Apple Pay, Google Pay, Link | On | أزرار المحفظة. تظهر فقط عند التحقق من النطاق في Stripe. |
| Alipay | معطل | يتطلب تفعيل Alipay في لوحة تحكم Stripe. |
| PayPal | معطل | يُعرض فقط عند تكوين PayPal. |
| USDT (Binance) | معطل | هذا المفتاح مقفل حتى يتم التحقق من عنوان الإيداع مقارنة بـ Binance. |
| رسوم Stripe (نسبة % / مبلغ ثابت بالسنت) | 3.6 % و 0 | تُستخدم لعرض الرسوم للعميل وحساب المبلغ المضاف. قم تعيينها وفقاً لتعريفة Stripe الفعلية الخاصة بك. |
| رسوم PayPal (نسبة % / مبلغ ثابت) | 4.4 % و 30 سنت | الشيء نفسه، بالنسبة لـ PayPal. |
| رسوم USDT (%) | 1 % | الشيء نفسه، بالنسبة لـ USDT. |
| العميل يدفع رسوم شحن الرصيد | معطل | On: يدفع العميل المبلغ + الرسوم وتتلقى المحفظة المبلغ بالكامل. Off: يتم خصم الرسوم وتتلقى المحفظة المبلغ ناقصاً الرسوم. |
يرى العميل دائماً الرسوم ورصيد المحفظة النهائي قبل الدفع. يؤدي إيقاف تشغيل القناة إلى إخفاء الزر ورفض الخادم للمدفوعات الجديدة مع method_disabled (HTTP 403).
حدود شحن الرصيد
الحد الأدنى والحد الأقصى للمبلغ في كل عملية شحن موجودان في نفس الصفحة — راجع Minimum top-up.
التحقق
- في جدول النظرة العامة، تُظهر القناة Enabled وConfigured؛ ويتم ملء عمود Last test بعد النقر فوق Test في علامة تبويب القناة.
- قم بتسجيل الدخول إلى البوابة كعميل تجريبي وافتح Billing › Deposit. زر القناة موجود.
- قم بإجراء دفعة صغيرة (راجع مقالة القناة للاطلاع على البطاقات التجريبية أو حسابات الـ sandbox). يرتفع الرصيد، وتظهر إشعار Top-up received، وتُدرج الدفعة في Finance › Billing › Top-ups (
/billing/deposits).
الحدود والملاحظات
- أعمدة النظرة العامة: 30 days (عدد المدفوعات، والعمليات الناجحة، والفاشلة، والحجم)، وStuck 24h (المدفوعات التي لا تزال معلقة بعد يوم)، وUnmatched (عمليات تحويل USDT أو التحويلات المصرفية التي وصلت ولكنها لا تطابق أي طلب). يضيف صف مؤشرات الأداء الرئيسية (KPI) حجم ال30 يوماً، وعدد القنوات المعيبة (الممكّنة ولكن غير المُكوّنة، أو المدفوعات العالقة)، وإجمالي العمليات غير المطابقة.
- أحداث Webhook مدرجة ضمن Payment channels › Gateway events (
/payments/events). تمتلك Stripe علامة تبويب خاصة بها؛ بينما تتشارك كل من PayPal وUSDT في علامة تبويب واحدة. يمكن إعادة تشغيل الحدث الفاشل — دفتر حسابات المحفظة غير متأثر بالتكرار، لذا فإن إعادة التشغيل لا تُضيف رصيداً مرتين أبداً. - يمكن لـ Resellers امتلاك قنوات Stripe وPayPal وUSDT والتحويلات البنكية الخاصة بهم. تظهر صفوفهم هنا أيضاً، ويقوم محدد الموقع في رأس الصفحة بتفقدها. راجع Resellers.
- المبالغ المستردة: يمكن استرداد مدفوعات Stripe وPayPal من قائمة المدفوعات؛ أما مدفوعات USDT فلا يمكن استردادها إلى المصدر (يجيب الخادم بـ
usdt_no_refund). - وضع الصيانة لا يزال يقبل طلبات Webhook الخاصة بـ Gateway، لذلك لافقدان لأي دفعة تمت قبل الصيانة مباشرة.
استكشاف الأخطاء وإصلاحها
| العَرَض | السبب | الحل |
|---|---|---|
| القناة مفقودة على شاشة إيداع العميل | متوقفة، أو غير مُكوّنة، أو (بالنسبة للبنوك الفيتنامية VN) الواجهة ليست باللغة الفيتنامية | تحقق من Fees & limits وعلامة تبويب القناة؛ راجع Bank transfer (Vietnam). |
| مؤشر الأداء الرئيسي Faulty channels أكبر من 0 | تم تمكين القناة بدون بيانات اعتماد، أو أن المدفوعات معلقة لأكثر من 24 ساعة | افتح الصف وانقر فوق Configure؛ بالنسبة للمدفوعات العالقة، افتح Gateway events وأعد تشغيلها. |
| دفع العميل ولكن الرصيد لم يتغير | لم يصل طلب Webhook | تحقق من عنوان URL لـ Webhook في علامة تبويب القناة، ثم أعد تشغيل الحدث في Gateway events. |
يجيب الخادم بـ method_disabled | المفتاح متوقف | قم بتشغيله في Fees & limits واحفظ التغييرات. |
| مفتاح USDT باهت وغير نشط | عنوان الإيداع غير مُتحقَّق منه | انقر على Test & verify address في تبويب USDT. |