تخطى إلى المحتوى الرئيسي

توثيق API المدفوعات

نظرة عامة

يوفر Yalla System API واجهة برمجية كاملة لإدارة المدفوعات. يدعم الدفع عبر فوري، المحفظة، والفيزا.

المصادقة (Authentication)

جميع الطلبات تتطلب مفتاح API في ترويسة Authorization. استخدم التنسيق: Bearer YOUR_API_KEY

Authorization: Bearer YOUR_API_KEY

4. النقاط الخارجية

POST
/api/v1/payments
1. إنشاء معاملة
إنشاء معاملة دفع جديدة
GET
/api/v1/payments/:id/status
2. حالة المعاملة
التحقق من حالة معاملة
GET
/api/v1/payments
3. استعلام المعاملات
قائمة المعاملات مع تصفية

4. النقاط الخارجية

بيانات الاشتراك
جلب نطاق الدفع
POST
/api/v1/payments/fawry

5.1 الدفع عبر فوري

إنشاء دفع فوري

POST
/api/v1/payments/wallet

5.2 الدفع عبر المحفظة

إنشاء دفع محفظة

POST
/api/v1/payments/visa

5.3 الدفع بالفيزا

إنشاء جلسة دفع بالفيزا

// Create a Fawry payment
const payment = await yallaSystem.createPayment({
  amount: 1500.00,
  currency: 'EGP',
  method: 'fawry',
  customer: {
    name: 'Ahmed Hassan',
    email: '[email protected]'
  }
});

// Process the payment
const result = await payment.process();
console.log(result.status);        // 'success'
console.log(result.transactionId); // 'TXN_123456'

Ready to Get Started?

ابدأ الآن