دليل Sandbox

استخدم مفاتيح الاختبار للدمج دون الانتقال للإنتاج. نفس مسارات الـ API.

بداية سريعة

افتح لوحة التحكم → المطوّرون وأنشئ مفتاح اختبار (pp_test_…). انسخه مرة واحدة.
استدعِ /api/v1/account مع Authorization: Bearer pp_test_… للتحقق — الإحصاءات للاختبار فقط.
أنشئ فاتورة عبر POST /api/v1/invoices (تُوسم كـ test). لوحة التاجر ومفاتيح live لن تراها.
محاكاة الدفع: POST /api/v1/invoices/{publicId}/simulate-pay بنفس مفتاح الاختبار — بلا PSP حقيقي وبلا إضافة للمحفظة.

عزل Sandbox (هذه الشريحة)

مفاتيح الاختبار تنشئ وتقرأ فقط فواتير/عملاء موسومين بـ test. مفاتيح live ولوحة التاجر ترى بيانات live فقط. محفظة الاختبار ترجع أرصدة فارغة. لا قاعدة بيانات منفصلة — العزل بوسم البيئة على نفس قاعدة البيانات.

أمثلة curl

# Health + test-scoped stats
curl -s "https://paypola.com/api/v1/account" \
  -H "Authorization: Bearer pp_test_YOUR_KEY"

# Create a test invoice
curl -s -X POST "https://paypola.com/api/v1/invoices" \
  -H "Authorization: Bearer pp_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"Sandbox invoice","amountEgp":10,"customerName":"Test Buyer"}'

محاكاة فاتورة مدفوعة

curl -s -X POST "https://paypola.com/api/v1/invoices/PUBLIC_ID/simulate-pay" \
  -H "Authorization: Bearer pp_test_YOUR_KEY"

مستكشف API فتح بوابة المطوّرين