كيف تختبر مدفوعات العملات المشفرة بدون أموال حقيقية

قبل أن تنقل متجرًا أو لوحة فوترة أو بوتًا إلى الدفع بالعملات المشفرة، ستريد أن ترى المسار كله يعمل: تُنشأ الفاتورة، ويختار العميل عملة، وتُؤكَّد الدفعة، ويُعلِّم نظامك الطلب مدفوعًا. مع SnapEX Pay يمكنك فعل ذلك كله دون إرسال عملة واحدة.

ما الفاتورة التجريبية

الفاتورة التجريبية فاتورة عادية في SnapEX Pay قيمة الحقل environment فيها test. تمرّ بالحالات نفسها وتُرسل إشعارات Webhook نفسها التي ترسلها الفاتورة الفعلية، مع القيمة "test" في الحقل data.environment في كل حدث. ولا تغيّر رصيدك الحقيقي أبدًا.

لا توجد مفاتيح API تجريبية منفصلة: تستخدم المفتاح نفسه وتغيّر حقلًا واحدًا فقط في الطلب.

أنشئ فاتورة تجريبية عبر API

أضف "environment": "test" إلى طلب إنشاء الفاتورة:

curl -sS -X POST https://pay.snapex.pro/api/v1/merchant/invoices \
  -H "Authorization: Bearer <your API key>" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Idempotency-Key: order-15-test" \
  -d '{
    "amount_usd": "15.00",
    "environment": "test",
    "external_id": "order-15"
  }'

يحتاج المفتاح إلى الصلاحية invoices.write. وتحتوي الاستجابة على رابط الدفع، تمامًا كما في الفاتورة الفعلية.

أو أنشئها في لوحة تحكم التاجر

افتح في لوحة التحكم قسم «الفواتير» وبدّل الوضع إلى «تجريبي». الفواتير التي تُنشئها هناك تجريبية، والقائمة لا تعرض إلا الفواتير التجريبية، فلا تختلط أبدًا بالمدفوعات الحقيقية.

ادفعها

افتح رابط الدفع. تعرض الصفحة شارة تجريبي. اختر أي عملة وأي شبكة: تعرض الصفحة عنوانًا تجريبيًا (لا عنوانًا حقيقيًا)، وبعد نحو 10 ثوانٍ تُؤكَّد الدفعة تلقائيًا. لا حاجة إلى إرسال أي شيء.

ما الذي تتحقق منه من جهتك

• تسليم Webhook. تستقبل نقطة النهاية لديك الحدث invoice.paid مع data.environment = "test". تأكد من أن التوقيع يجتاز التحقق، ومن أن تكرار تسليم الحدث نفسه بقيمة Webhook-Id ذاتها لا يُعلِّم الطلب مدفوعًا مرتين.
• حالة الطلب. لا يصبح الطلب في نظامك مدفوعًا إلا عند وصول invoice.paid.
• الفصل بين الفعلي والتجريبي. تأكد من أن الكود لديك يتجاهل الأحداث التجريبية بعد الانتقال إلى الوضع الفعلي، أو يُبقي الطلبات التجريبية منفصلة.

وضع الاختبار في الوحدات الجاهزة

تحتوي وحدات WHMCS وBILLmanager وWooCommerce وCS-Cart وFOSSBilling وPaymenter وRemnawave على وضع اختبار يُنشئ فواتير تجريبية. في WHMCS لا يرى زر الدفع أثناء تفعيل هذا الوضع إلا المشرفون الذين سجّلوا الدخول، وفي WooCommerce لا يرى طريقة الدفع إلا مديرو المتجر؛ أما في BILLmanager وCS-Cart فتقصر طريقة الدفع التجريبية على عميل تجريبي أو مجموعة مستخدمين. أنشئ طلبًا، وادفعه على صفحة SnapEX Pay، وتأكد من أن الطلب أصبح مدفوعًا، ثم أوقف وضع الاختبار. أدلة الإعداد على pay.snapex.pro تشرح هذه الخطوة لكل وحدة.

ثم انتقل إلى الوضع الفعلي

احذف "environment": "test" (أو أوقف وضع الاختبار في الوحدة)، فتصبح الفواتير التالية فعلية. ولا تُحتسب المدفوعات التجريبية أبدًا للطلبات الفعلية.

المرجع الكامل لـ API: توثيق API لـ SnapEX Pay.