NOWPayments

ما تحتاجه

IPN (Instant Payment Notification) هو اسم NOWPayments للـ webhook الذي يرسلونه حين تتغير حالة دفعة.

لماذا نطلب كل حقل

API key

يفوّض إنشاء الدفعة، فتستقر الأموال في حسابك.

IPN secret

يثبت أن إشعاراً وارداً من NOWPayments فعلاً، فلا يستطيع أحد تزوير حدث "مدفوع". وهو قيمة منفصلة عن API key.

عنوان النجاح والإلغاء

إعدادات بسيطة: حيث يصل المشتري بعد الدفع أو التراجع. ليست سرية.

الإعداد

1. الاختبار: لا يوجد sandbox

   لا يملك NOWPayments sandbox أو بيئة اختبار. وللتحقق من البداية إلى النهاية، أرسل دفعة حقيقية صغيرة بعملة منخفضة الرسوم وأكّد أنها تظهر في لوحة تحكمك. اعتبر تلك الدفعة الصغيرة الأولى اختبارك. وحساب NOWPayments مجاني؛ تدفع فقط رسوم الشبكة والخدمة العادية على المدفوعات الحقيقية.

2. افتح Payments Settings في NOWPayments

   سجّل الدخول على account.nowpayments.io واذهب إلى Settings → Payments. تحتوي هذه الشاشة الواحدة على الأشياء الثلاثة التي تحتاجها: Payout wallets (حيث تستقر الأموال)، ومفاتيح API، وإشعارات الدفع الفورية. ستزور كل واحدة بالتسلسل.

   ⤢
3. أضف محفظة استلام

   يفتح NOWPayments واجهة البرمجية فقط بعد وجود محفظة استلام. في Payout wallets، انقر Add new wallet، اختر عملة، والصق عنوان محفظة تتحكم فيه، ثم انقر Add wallet. هذا هو العنوان الذي تستقر فيه عملتك الرقمية.

   ⤢
4. أنشئ مفتاح API

   افتح API keys وانقر Add new API key. تُدرَج مفاتيحك هنا، لكل منها أيقونة نسخ، فتستطيع العودة وإعادة نسخ أي مفتاح في أي وقت.

   ⤢
5. انسخ مفتاح الـ API

   يعرض NOWPayments المفتاح الجديد في مربع حوار "API key created". انقر أيقونة النسخ بجانب Your API key واحتفظ به. (المفتاح العام أسفله غير مطلوب من Coin Moebius.) يمكنك إضافة تسمية اختيارية، ثم انقر حفظ.

   ⤢

   هذا مفتاح API السري الخاص بك. تعامل معه ككلمة مرور.

6. أعدّ نداء IPN وانسخ سر IPN

   افتح Instant payment notifications. IPN (Instant Payment Notification) هو اسم NOWPayments للـ webhook الذي يرسله عند تغيّر حالة الدفعة.

   1. في حقل Webhook URL، الصق عنوان webhook NOWPayments الخاص بمشروعك (أدناه)، ثم انقر حفظ.
   2. انسخ مفتاح سر IPN المعروض في الأعلى (استخدم Regenerate إن لم تكن هناك قيمة بعد).
   3. تحت Choose webhook format، اختر Classic way حتى تبقى المبالغ والمعرّفات بتنسيقها الرقمي المعتاد.

   https://api.coinmoebius.com/webhook/nowpayments/<your project id>

   ⤢

   معرّف مشروعك موجود أسفل اسم المشروع في لوحة تحكم Coin Moebius؛ أدرجه في العنوان أعلاه. تُظهر بطاقة المزود المتصل (الخطوة الأخيرة) العنوان نفسه، فتستطيع إعادة نسخه في أي وقت.

7. في Coin Moebius: إضافة مزود → NOWPayments

   في مشروعك، افتح تبويب Providers، انقر إضافة مزود، اختر Connect a service، ثم اختر NOWPayments. الصق مفتاح الـ API وسر IPN، اضبط عنوان النجاح وعنوان الإلغاء (حيث يصل المشترون بعد الدفع أو التراجع)، ثم انقر حفظ.

   ⤢
8. أنت متصل الآن

   يظهر NOWPayments الآن في تبويب Providers الخاص بك مع تاريخ الاتصال. تُظهر البطاقة عنوان webhook نفسه الذي لصقته في NOWPayments، بالإضافة إلى تعديل وفصل. بما أن NOWPayments لا يمتلك sandbox، لا نستطيع التحقق التلقائي من سر IPN، لذا تقدّم البطاقة اختبار بدفعة صغيرة: أرسل دفعة حقيقية صغيرة لتأكيد أن كل شيء يعمل من البداية إلى النهاية.

   ⤢

بعد أن تربط

لا يوجد sandbox، فأول دفعة حقيقية صغيرة لك هي الاختبار:

1. أنشئ منتجاً وضع زر الشراء على صفحة (ملف HTML محلي يعمل) موجَّهاً إلى مشروعك.
2. ادفع مبلغاً صغيراً بعملة منخفضة الرسوم.
3. افتح تبويب المعاملات. حين تبلغ حالة الصف الجديد succeeded، يعمل مفتاح واجهتك البرمجية وسر الـ IPN من البداية إلى النهاية.

حل المشكلات

تكتمل الدفعة لكن الطلب يبقى معلّقاً.

الـ IPN لا يصل أو لا يتحقق. أكّد أن عنوان النداء يطابق وأن سر الـ IPN في لوحة التحكم يطابق IPN Secret Key في إعدادات NOWPayments الخاصة بك.

لا طريقة للاختبار دون دفع.

صحيح، لا يوجد sandbox. أرسل دفعة حقيقية صغيرة بعملة منخفضة الرسوم لإطلاق IPN أصيل، ثم راقب تحديث الطلب.

الحالة تتغير فقط مع نشاط حقيقي.

تعكس حالة NOWPayments تسليمات الـ IPN، فحساب هادئ لا يُظهر حالة حتى تتحرك دفعة حقيقية.

جيد أن تعرف

لا وضع اختبار. تحقق بدفعة حقيقية صغيرة، لا sandbox.

تدوير الأسرار. ولّد API key أو IPN secret جديداً في أي وقت، ثم الصق القيمة الجديدة.

أسئلة؟ Join our Discord