المطورون

عرض ويب، ثلاث دوال JS، اثنان webhooks. هذا هو التكامل بأكمله.

مصمَّم ليكون أصغر تكامل لتطبيق جوال يُطلِقه فريق منصتك. لا SDK يحتاج تحديثًا، لا وحدة أصلية، لا مراجعة جديدة في متجر التطبيقات حين يتغير كتالوجنا.

٠١

١. ادمج الـ WebView

أضف WebView إلى مسار الخدمات في تطبيقك. مرّر هوية موقَّعة كـ JWT في رأس Authorization.

SWIFT · ANDROID · FLUTTER

// iOS · Swift
let url = "https://app.alpha-store.online/v1/embed"
let req = URLRequest(url: URL(string: url)!)
req.setValue("Bearer "+jwt, forHTTPHeaderField: "Authorization")
webView.load(req)

٠٢

٢. عرّف الجسر

ثلاث دوال على الجسر: customerToken لجلب رمز الجلسة، balance للرصيد، payAuthorize للدفع.

JS BRIDGE

window.AlphaBridge = {
  customerToken: () => await bank.issueToken(),
  balance:       () => bank.balance("IQD"),
  payAuthorize:  (req) => bank.authorize(req),
};

٠٣

٣. استمع للتسوية

نقطتا webhooks: settlement.captured عند نجاح الدفع، settlement.refunded عند الاسترداد.

WEBHOOK PAYLOAD

{
  "event": "settlement.captured",
  "id":    "stl_01HX8K…",
  "gross": 10000, "cost": 9700, "margin": 300,
  "customer": "cust_a31f…",
  "sig": "v1=4f81…"
}

مفاتيح بيئة الاختبار تصلك خلال ٢٤ ساعة. مفاتيح الإنتاج بعد جلسة اختبار اختراق مشتركة لمدة ٣٠ دقيقة.