Troubleshooting

حل مشكلات بوابة الدفع (payment gateway): عندما لا يتأكد الدفع

دفع العميل وما زال الطلب معلقًا؟ راجع سجل المدفوعات وحالة بوابتك ومفاتيحها وإعداد webhook، ثم أكّد الدفعة بنفسك.

7 min read
Published 12 فبراير 2026
Last checked 1 نوفمبر 2026
troubleshooting
payments
gateways
webhooks

تذهب المدفوعات مباشرة من عميلك إلى حسابك لدى بوابة الدفع. بعدها تخبر البوابة متجرك بأن الدفع نجح، فيسلّم المتجر الطلب. عندما يقول عميل «دفعت ولم يصلني شيء» فالغالب أن إحدى هذه الحلقات مقطوعة. اتبع الخطوات بالترتيب.

1Step 1 of 8اعثر على الدفعة

انتقل إلى Invoices → Payment logs. تعرض صفحة Payment Logs كل دفعة مع مبلغها وبوابتها وعميلها. استخدم Paid و Pending و Failed للتصفية، أو ابحث عن العميل. اضغط على دفعة لترى تفاصيلها.

  • Paid: الدفعة مؤكدة. إذا لم يحصل العميل على شيء بعد، فالمشكلة في التسليم لا في الدفع. راجع طريقة حل مشكلة الطلبات العالقة على اللوحة.
  • Pending: بدأ العميل إتمام الشراء، لكن البوابة لم تؤكد أي دفعة. تابع إلى الخطوة 2.
  • Failed: لم ينجح الدفع، أو أغلقت عملية إتمام الشراء لأن الدفع لم يتأكد في الوقت المحدد.

2Step 2 of 8تحقق من حالة البوابة

انتقل إلى Payment gateways. تحت Configured Gateways تظهر كل بوابة بحالة Active أو Inactive أو Misconfigured.

  • Inactive: البوابة متوقفة ولا يستطيع العملاء الدفع بها. اضغط Configure، شغّل Gateway Status ثم اضغط Save Changes.
  • Misconfigured: تبيّن في فحصنا الدوري أن البوابة رفضت مفاتيحها. يظهر السبب تحت البوابة مع Last checked: والوقت. البوابة التي بهذه الحالة لا تظهر للعملاء عند إتمام الشراء حتى تصلح مفاتيحها (الخطوة 3).

3Step 3 of 8حدّث المفاتيح

اضغط Configure على البوابة. انسخ المفتاح أو الرمز السري الجديد من لوحة التحكم في حساب بوابتك والصقه في حقله. الحقول السرية المحفوظة من قبل تعرض Leave empty to keep existing value، فلا تملأ إلا ما تغيّر. اضغط Save Changes.

في بعض البوابات يجري التحقق من المفاتيح لدى البوابة عند الحفظ. إذا رفضتها البوابة ترى السبب ولا يحفظ أي شيء. وبعد حفظ المفاتيح الجديدة تعود البوابة إلى الظهور عند إتمام الشراء.

مع العملاء الحقيقيين استخدم المفاتيح الحية (live)، لا مفاتيح الاختبار (test أو sandbox).

4Step 4 of 8تحقق من webhook

بعض البوابات لا تخبر متجرك بالدفعة إلا عبر webhook. في هذه البوابات تعرض صفحة Configure مربعًا بعنوان Webhook setup — required for automatic confirmation وفيه العنوان الذي تستخدمه.

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

من دون webhook قد تبقى الطلبات المدفوعة معلقة.

5Step 5 of 8أكّد دفعة وصلت فعلًا

تحقق أولًا من لوحة التحكم في حساب بوابتك. لا تكمل إلا إذا كان المال في حسابك فعلًا.

انتقل إلى Customers → All customers، افتح العميل، ثم افتح تبويب Orders واضغط على الطلب. في Order Details يظهر الطلب المعلق بحالة Awaiting Payment (أو Order Abandoned إذا كان قديمًا). والطلب الذي أغلق لأن البوابة لم تؤكده قط يظهر بحالة Closed — no payment received in time.

اضغط Confirm payment. تحت Payment reference (optional) الصق رقم الطلب أو رقم العملية من بوابتك، حتى يمكن تتبع الدفعة لاحقًا. اضغط Mark paid & provision. يصبح الطلب مدفوعًا ويجري تسليمه كما لو أن البوابة أكدته.

ملاحظة: الطلب الذي رفضته البوابة نفسها أو استردت مبلغه لا يظهر فيه زر Confirm payment.

6Step 6 of 8أو أرسل رابط دفع جديدًا

إذا لم يكمل العميل الدفع وكانت لديك إضافة Pay-by-Link، اضغط Copy payment link على الطلب المعلق وأرسل الرابط إليه. يدفع به ذلك الطلب نفسه، وتتأكد الدفعة بالطريقة المعتادة.

7Step 7 of 8عندما يتعذر بدء إتمام الشراء

أحيانًا ترفض البوابة بدء الدفع أصلًا، فلا يصل العميل إلى صفحة الدفع. يرى عميلك حينها الرسالة "This payment method isn't available right now" (أي أن طريقة الدفع هذه غير متاحة حاليًا) ويستطيع اختيار طريقة أخرى. لا يخصم منه أي مبلغ.

يصلك السبب في ثلاثة أماكن:

  • جرس الإشعارات عندك: إشعار واحد في اليوم لكل بوابة ولكل سبب. اضغط عليه لفتح Payment gateways.
  • Payment gateways: تحت البوابة يظهر مربع Checkout problem يذكر ما حدث، وما ردّت به البوابة، و What to do (ما عليك فعله). يختفي المربع وحده بعد أول عملية شراء تبدأ بلا مشكلة.
  • تجربة الشراء التي تجريها بنفسك: عندما تختبر متجرك وأنت مسجل الدخول بحساب عميل على صندوق البريد نفسه الذي تسجل به الدخول إلى متجرك (مثل you+test@…)، يعرض إتمام الشراء المربع نفسه. عملاؤك لا يرونه أبدًا.

أكثر الردود التي نراها:

  • WolvPay: "No enabled wallets found": ليس في حسابك لدى WolvPay محفظة مفعّلة لاستقبال العملات. في WolvPay أضف محفظة بعنوان الاستقبال الخاص بك وفعّلها.
  • Rampex: "Merchant custom wallet not configured": ليس في حسابك لدى Rampex محفظة لاستلام أموالك (payout wallet). في Rampex أعدّ محفظة الاستلام.
  • Unauthorized أو مفتاح غير صالح: المفتاح خاطئ، أو تغيّر، أو هو مفتاح اختبار. انسخ مفتاحك الحي (live) من جديد، ثم في Payment gateways اضغط Configure، الصقه واضغط Save Changes. وإذا لم يعرض Configure حقلًا للمفتاح (Rampex و Mollie و SumUp وبوابات قليلة أخرى)، فاضغط Add Gateway وأضف البوابة من جديد بالمفتاح الجديد، ثم أوقف القديمة من Gateway Status.
  • حسابك لا يستطيع استقبال مدفوعات حقيقية: حسابك لدى البوابة لم يفعّل بعد، أو عليه قيود. أكمل ما تطلبه لوحة التحكم في حساب بوابتك.
  • العملة غير مدعومة: حسابك لدى البوابة لا يقبل هذه العملة. فعّلها في حساب بوابتك، أو اجعل البيع بعملة يقبلها.
  • المبلغ صغير جدًا: الإجمالي أقل من الحد الأدنى للبوابة، ويحدث هذا كثيرًا مع أسعار الاختبار مثل €1. اختبر بسعر أعلى من الحد الأدنى.
  • Square: Location ID: قيمة Location ID ليست من حساب Square نفسه الذي أخذت منه Access Token. انسخ Location ID من تطبيق Square نفسه، الصقه في Configure واضغط Save Changes.
  • البوابة لا تستجيب أو انتهت المهلة: مشكلة مؤقتة عند البوابة. لا شيء تصلحه؛ حاول مرة أخرى بعد دقائق.

بعد الإصلاح، نفّذ عملية شراء تجريبية في متجرك للتأكد (Fixed it? Run a test checkout).

عندما تضيف بوابة فترفض البيانات، يعرض النموذج Not saved — the gateway refused these details مع الشرح نفسه. أصلح ما يذكره واضغط Add Gateway من جديد.

8Step 8 of 8عندما ترفض تأكيدات الدفع (webhook secret)

يوقّع WolvPay و Rampex و Square كل تحديث دفع يرسلونه إلى متجرك بالرمز السري (webhook secret) الموجود في حسابك لدى البوابة. إذا لم يطابقه الرمز المحفوظ في متجرك نضطر إلى رفض تلك التحديثات، فلا تتأكد المدفوعات لحظة وصولها. لكنها لا تضيع: نسأل البوابة أيضًا عن المدفوعات المفتوحة في مواعيد منتظمة (WolvPay و Rampex كل 10 دقائق، و Square كل ساعة)، فتتأكد الطلبات المدفوعة على أي حال، لكن بعد تأخير.

عندما يتكرر ذلك تراه في ثلاثة أماكن:

  • لوحة التحكم عندك: إشعار يسمي البوابة ومعه See how to fix it.
  • Payment gateways: تحت البوابة مربع Payment confirmations فيه عدد التحديثات المرفوضة و What to do.
  • جرس الإشعارات عندك: إشعار واحد يبقى حتى تحل المشكلة. اضغط عليه لفتح Payment gateways.

للإصلاح:

  • WolvPay: في لوحة التحكم لدى WolvPay افتح إعدادات webhook وانسخ الرمز السري (webhook secret). في Payment gateways اضغط Configure على بوابة WolvPay، احذف ما في حقل Webhook Secret، الصق الرمز واضغط Save Changes.
  • Square: في Square Developer Console افتح اشتراك webhook الخاص بتطبيقك وانسخ Signature Key منه. تأكد أن notification URL فيه هو بالضبط https://iptvbp.com/api/webhooks/square. في Payment gateways اضغط Configure على بوابة Square، احذف ما في حقل Webhook Signature Key، الصق المفتاح واضغط Save Changes.
  • Rampex و Cash App Pay: لا يوجد في Configure حقل للرمز السري لهاتين البوابتين. اضغط Add Gateway وأضف البوابة من جديد مع وضع الرمز في حقل Webhook Secret (Rampex) أو Webhook Signature Key (Cash App Pay)، ثم أوقف القديمة من Gateway Status.

يختفي الإشعار وحده فور نجاح تحديث الدفع التالي من البوابة في الفحص. ونحن لا نعرض الرمز السري نفسه ولا نرسله أبدًا.

Ready to try it yourself?

Spin up your own IPTVbp store and connect a panel. It's مجاني حتى يبلغ عدد عملائك الدافعين 25, no card needed.

Start free trial