ادمج بوابة الدفع SkyPay في تطبيقك خلال دقائق
REST API حديث وسريع، دعم 9 لغات برمجة، Webhooks موقعة بـ HMAC-SHA256، وبيئة Sandbox معزولة بالكامل.
مركز بيانات واعتمادات المطور (Developer Credentials)API v1 Active
بياناتك المباشرة للاختبار والربط مع التوليد الفوري لأكواد الاستدعاء بـ 9 لغات برمجية.
Create Invoice (إنشاء وتوليد فاتورة دفع)
ينشئ فاتورة جديدة في حسابك (يدعم الفواتير السريعة بمبلغ إجمالي، أو الفواتير التفصيلية متعددة البنود Line Items مع الضرائب وكود العميل) ويعيد كائن الفاتورة متضمناً رابط الدفع المباشر (paymentUrl).
سيناريوهات وأمثلة جاهزة للتطبيق الفوري (Quick Presets)
حقول جسم الطلب (Request Body Schema)APPLICATION/JSON
3 إلزامي · 13 حقلamountإجمالي مبلغ الفاتورة بالوحدة الأساسية (مثال: 3500.00 يمثل 3,500 ج.م). يجب أن يكون أكبر من 0.
3500currencyEGPرمز العملة المعتمد دولياً (ISO-4217). الافتراضي: EGP.
EGPSARAEDUSDserviceNameاسم الخدمة أو موضوع الفاتورة، ويظهر بوضوح في رأس صفحة الدفع والإيصال.
تطوير موقع إلكتروني احترافي وحملة تسويقيةreferenceالرقم المرجعي المميز للفاتورة في نظامك (مثلاً رقم الطلب في متجرك). فريد داخل منظمتك.
INV-2026-001customerNameاسم العميل أو اسم الشركة المستلمة.
شركة النور للحلول التقنيةcustomerEmailالبريد الإلكتروني للعميل لإرسال الإشعار والإيصال الرقمي له.
client@example.comcustomerPhoneرقم هاتف العميل للتواصل ومطابقة تحويلات فودافون كاش وانستاباي.
01012345678clientCodeكود العميل المرجعي في نظام المحاسبة الخاص بك.
CUST-2026-042taxIdالرقم الضريبي أو السجل التجاري للعميل (Tax / VAT ID).
450-981-223paymentTermsشروط وفترة السداد المحددة للعميل (immediate, net7, net14, net30, net60).
net14costCenterمركز التكلفة أو الفرع المحاسبي للعملية.
تطوير برمجي وحلول تقنيةlineItemsقائمة بنود الخدمات والمنتجات التفصيلية (description, quantity, unitPrice, amount, sku).
expirationDays24عدد أيام صلاحية رابط الدفع (بين 1 إلى 365 يوماً). الافتراضي: 24 يوماً.
14مرجع استجابات وأخطاء هذا المسار (Error Handling Guide)
| HTTP Status | الرسالة التوضيحية | سبب الحدوث وكيفية المعالجة |
|---|---|---|
| 200 / 201 | Success / Created | تم تنفيذ الطلب بنجاح وإعادة كائن البيانات المطلوب. |
| 400 | Validation Error | حقول ناقصة أو غير مطابقة للـ Schema (مثلاً مبلغ غير صالح أو بريد خاطئ). |
| 401 | Unauthorized | مفتاح API غير صحيح، منتهي الصلاحية، أو مفقود في الترويسة. |
| 409 | Duplicate Reference | تم استخدام نفس الرقم المرجعي (reference) مسبقاً في حسابك. |
| 429 | Rate Limit Exceeded | تجاوزت الحد المسموح من الطلبات بالدقيقة (راقب ترويسة Retry-After). |
ملاحظات الاستجابة وسلوك الـ API
- يعيد كود الحالة 201 عند الإنشاء بنجاح، أو 200 مع ترويسة X-Idempotent: true عند إعادة إرسال نفس الطلب.
- الرابط paymentUrl هو رابط صفحة الدفع المستضافة لمشاركته مع العميل.
- يدعم تمرير البنود التفصيلية lineItems وبيانات العميل المالية بشكل اختياري.
Interactive API Console (Try It)
curl -X POST "https://payment.skywaveads.com/api/invoices" \ -H "Authorization: Bearer sk_test_demo_9f8a7b6c5d4e3f2a" \ -H "Content-Type: application/json"
