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

Payment API بني للمطورين

REST API واضح، مصادقة HMAC، Webhooks فورية، وأمثلة كود حقيقية. ابدأ قبول المدفوعات في تطبيقك.

توثيق APIمركز المطورين
payment.ts
// إنشاء دفع
const payment = await yallaSystems.createPayment({
  amount: 1500.00,
  currency: 'EGP',
  method: 'card',
  customer: {
    name: 'Ahmed Hassan',
    email: '[email protected]'
  },
  callbackUrl: 'https://yourapp.com/callback',
  webhookUrl: 'https://yourapp.com/webhook'
});

// تحقق من الحالة
const status = await yallaSystems.getPaymentStatus(
  payment.id
);
// → 'success' | 'pending' | 'failed'

ميزات API

REST API

واجهة RESTful واضحة وسهلة الاستخدام.

Webhooks

إشعارات فورية عند تغيّر حالة الدفع.

HMAC Auth

مصادقة آمنة بتوقيع HMAC لكل طلب.

استجابة سريعة

زمن استجابة منخفض للمعاملات.

خطوات التكامل

1

احصل على مفتاح API

تواصل معنا واحصل على مفتاح API من لوحة التحكم.

2

أنشئ دفع

استدعِ endpoint إنشاء الدفع مع تفاصيل المبلغ والعميل.

3

استقبل Webhook

استقبل إشعار Webhook عند اكتمال الدفع وتحقق من التوقيع.

4

تحقق من الحالة

استدعِ endpoint حالة الدفع للتأكيد النهائي.

الأسئلة الشائعة

ما هو Payment API؟

Payment API هو واجهة برمجية تتيح للمطورين دمج بوابة الدفع في مواقعهم وتطبيقاتهم برمجياً، مما يتيح إنشاء معاملات الدفع والتحقق من حالتها واستقبال إشعارات Webhook.

كيف أتكامل مع Yalla Systems API؟

احصل على مفتاح API من لوحة التحكم، استخدمه في ترويسة Authorization لكل طلب، ثم استدعِ نقطة إنشاء الدفع. استقبل نتيجة الدفع عبر Webhook أو إعادة التوجيه.

هل API آمن؟

نعم، جميع طلبات API مشفّرة وتستخدم مصادقة HMAC. لا تُخزّن تفاصيل البطاقات على خوادمك.

كيف أتحقق من حالة الدفع؟

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

ابدأ التكامل الآن

توثيق واضح، أمثلة كود، وبيئة اختبار جاهزة.

اقرأ التوثيق