---
title: قنوات الدفع
description: كيف يقوم العملاء بشحن محافظهم في NexCMP — القنوات المتاحة، وكيفية تمكين كل منها، والرسوم والحدود وكيفية مراقبتها.
url: https://nexcmp.com/ar/docs/billing/payment-channels/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# قنوات الدفع {#payment-channels}

> **أين تجد ذلك في لوحة الإدارة:** Finance › Payment channels (`/payments`). المفاتيح والرسوم: Finance › Payment channels › Fees & limits (`/payments/fees`).

تستخدم NexCMP **محفظة USD مسبقة الدفع**. يقوم العملاء بإضافة الأموال إلى المحفظة من خلال قناة دفع؛ يتم بعد ذلك دفع ثمن كل خدمة من المحفظة. لا يتم إظهار القناة للعملاء إلا عندما تكون **ممكنة** و**مكوّنة**.

## الوظيفة {#what-it-does}

تربط قنوات الدفع حساباتك المالية (Stripe، PayPal، Binance، بنك فيتنامي) بمحفظة العميل. يتحول الدفع المؤكد بدقة إلى رصيد واحد في المحفظة — وكل رصيد مُعرّف بمعرف الدفع الخاص ببوابة الدفع، بحيث لا يمكن أبداً لعملية Webhook مكررة أن تضيف أموالاً مرتين. استخدم هذه الصفحة لمعرفة القنوات الجاهزة، وأدائها خلال آخر 30 يوماً، وتلك التي تحتاج إلى اهتمام.

## المتطلبات {#requirements}

| العنصر | المتطلب |
|---|---|
| عنوان HTTPS العام | ترسل البوابات إشعارات الـ Webhook إلى `https://<domain>/v1/billing/...`، لذا يجب أن تكون لوحتك قابلة للوصول من الإنترنت عبر بروتوكول TLS صالح (انظر [DNS and Cloudflare](https://nexcmp.com/ar/docs/getting-started/dns-and-cloudflare/)). |
| الحسابات | حسابك الخاص لدى كل مزود ترغب في استخدامه. تُدخل بيانات الاعتماد في لوحة الإدارة ولا تظهر مرة أخرى أبداً (يُعرض فقط آخر 4 أحرف). |
| دور المشرف | حساب مسؤول. |
| الاعتمادات | لا شيء. قناة البنك الفيتنامي تحتاج بشكل إضافي إلى [سعر صرف](https://nexcmp.com/ar/docs/catalog/currency-and-exchange-rates/). |

## القنوات {#the-channels}

| القناة | ما يراه العميل | الإعداد في | المقالة |
|---|---|---|---|
| البطاقة (Stripe) | نموذج البطاقة، البطاقة المحفوظة | Payment channels › Stripe | [Stripe](https://nexcmp.com/ar/docs/billing/stripe/) |
| Apple Pay, Google Pay, Link | أزرار المحفظة (Stripe Express Checkout) | Stripe، بالإضافة إلى تسجيل النطاق | [Stripe](https://nexcmp.com/ar/docs/billing/stripe/#apple-pay-google-pay-and-link) |
| Alipay | إعادة التوجيه إلى Alipay (تتم المفوترة بالين الياباني بواسطة Stripe) | Stripe، بالإضافة إلى Fees & limits | [Stripe](https://nexcmp.com/ar/docs/billing/stripe/#alipay) |
| PayPal | أزرار PayPal، حساب PayPal المحفوظ | Payment channels › PayPal | [PayPal](https://nexcmp.com/ar/docs/billing/paypal/) |
| USDT | عنوان الإيداع والمبلغ المحدد | Payment channels › USDT | [USDT](https://nexcmp.com/ar/docs/billing/usdt/) |
| تحويل بنكي فيتنامي | رمز الاستجابة السريعة وتفاصيل التحويل (الواجهة الفيتنامية فقط) | في Payment channels › VN bank transfer | [Bank transfer (Vietnam)](https://nexcmp.com/ar/docs/billing/bank-transfer-vn/) |

## تجهيز البنية التحتية {#prepare-the-infrastructure}

غير مطلوب. كل شيء مُعد في لوحة الإدارة؛ ولا يوجد شيء لتثبيته على الخادم.

## الربط في NexCMP {#connect-in-nexcmp}

1. افتح **Finance › Payment channels** (`/payments`). يوضح جدول النظرة العامة كل قناة مع حالتها.
2. افتح علامة التبويب الخاصة بالقناة (**Stripe**، **PayPal**، **USDT**، **VN bank transfer**) واتبع مقالتها. تنتهي كل علامة تبويب بزر **Save**، وحيثما يتوفر، بزر **Test**.
3. افتح **Fees & limits** (`/payments/fees`)، وابحث عن بطاقة **Payment gateways & fees (wallet top-up)**، وفعل القناة بمفتاحها وانقر على **Save channels & fees**.

![نظرة عامة على قنوات الدفع توضح البوابات مع حالات تفعيلها وإعدادها وإحصاءات 30 يوماً](https://nexcmp.com/ar/docs/images/billing/payment-channels-01-overview.webp)

![صفحة الرسوم والحدود مع مفاتيح القنوات وحقول الرسوم](https://nexcmp.com/ar/docs/images/billing/payment-channels-02-fees.webp)

### المفاتيح والرسوم (Fees & limits) {#switches-and-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).

::: tip حدود شحن الرصيد
الحد الأدنى والحد الأقصى للمبلغ في كل عملية شحن موجودان في نفس الصفحة — راجع [Minimum top-up](https://nexcmp.com/ar/docs/billing/minimum-top-up/).
:::

## التحقق {#verify}

1. في جدول النظرة العامة، تُظهر القناة **Enabled** و**Configured**؛ ويتم ملء عمود **Last test** بعد النقر فوق **Test** في علامة تبويب القناة.
2. قم بتسجيل الدخول إلى البوابة كعميل تجريبي وافتح **Billing › Deposit**. زر القناة موجود.
3. قم بإجراء دفعة صغيرة (راجع مقالة القناة للاطلاع على البطاقات التجريبية أو حسابات الـ sandbox). يرتفع الرصيد، وتظهر إشعار **Top-up received**، وتُدرج الدفعة في **Finance › Billing › Top-ups** (`/billing/deposits`).

## الحدود والملاحظات {#limits-notes}

- **أعمدة النظرة العامة:** *30 days* (عدد المدفوعات، والعمليات الناجحة، والفاشلة، والحجم)، و*Stuck 24h* (المدفوعات التي لا تزال معلقة بعد يوم)، و*Unmatched* (عمليات تحويل USDT أو التحويلات المصرفية التي وصلت ولكنها لا تطابق أي طلب). يضيف صف مؤشرات الأداء الرئيسية (KPI) حجم ال30 يوماً، وعدد القنوات المعيبة (الممكّنة ولكن غير المُكوّنة، أو المدفوعات العالقة)، وإجمالي العمليات غير المطابقة.
- **أحداث Webhook** مدرجة ضمن **Payment channels › Gateway events** (`/payments/events`). تمتلك Stripe علامة تبويب خاصة بها؛ بينما تتشارك كل من PayPal وUSDT في علامة تبويب واحدة. يمكن إعادة تشغيل الحدث الفاشل — دفتر حسابات المحفظة غير متأثر بالتكرار، لذا فإن إعادة التشغيل لا تُضيف رصيداً مرتين أبداً.
- يمكن لـ **Resellers** امتلاك قنوات Stripe وPayPal وUSDT والتحويلات البنكية الخاصة بهم. تظهر صفوفهم هنا أيضاً، ويقوم محدد الموقع في رأس الصفحة بتفقدها. راجع [Resellers](https://nexcmp.com/ar/docs/customers/resellers/).
- **المبالغ المستردة:** يمكن استرداد مدفوعات Stripe وPayPal من قائمة المدفوعات؛ أما مدفوعات USDT فلا يمكن استردادها إلى المصدر (يجيب الخادم بـ `usdt_no_refund`).
- **وضع الصيانة** لا يزال يقبل طلبات Webhook الخاصة بـ Gateway، لذلك لافقدان لأي دفعة تمت قبل الصيانة مباشرة.

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

| العَرَض | السبب | الحل |
|---|---|---|
| القناة مفقودة على شاشة إيداع العميل | متوقفة، أو غير مُكوّنة، أو (بالنسبة للبنوك الفيتنامية VN) الواجهة ليست باللغة الفيتنامية | تحقق من **Fees & limits** وعلامة تبويب القناة؛ راجع [Bank transfer (Vietnam)](https://nexcmp.com/ar/docs/billing/bank-transfer-vn/). |
| مؤشر الأداء الرئيسي **Faulty channels** أكبر من 0 | تم تمكين القناة بدون بيانات اعتماد، أو أن المدفوعات معلقة لأكثر من 24 ساعة | افتح الصف وانقر فوق **Configure**؛ بالنسبة للمدفوعات العالقة، افتح **Gateway events** وأعد تشغيلها. |
| دفع العميل ولكن الرصيد لم يتغير | لم يصل طلب Webhook | تحقق من عنوان URL لـ Webhook في علامة تبويب القناة، ثم أعد تشغيل الحدث في **Gateway events**. |
| يجيب الخادم بـ `method_disabled` | المفتاح متوقف | قم بتشغيله في **Fees & limits** واحفظ التغييرات. |
| مفتاح USDT باهت وغير نشط | عنوان الإيداع غير مُتحقَّق منه | انقر على **Test & verify address** في تبويب USDT. |
