منظومة API بسيطة و قوية تتيح لك تقديم خاصية التقسيط بدون فوائد لعملائك مباشرة في صفحة الدفع. 5 endpoints فقط — توثيق واضح، أمثلة جاهزة، و دعم تقني مباشر.
نظام API مصمم للتجار العراقيين — سهل التركيب، آمن بالكامل، و متوافق مع كل منصات التجارة الإلكترونية.
5 endpoints فقط — تقدر تربط متجرك خلال يوم عمل واحد. توثيق واضح بالعربية مع أمثلة جاهزة.
JWT tokens، HTTPS إلزامي، OTP لتأكيد كل عملية. كل المعاملات مشفّرة و موثّقة على عدة طبقات.
تستلم قيمة الطلب كاملةً من جيدوم فور إتمام الدفع. العميل يقسّط لجيدوم — التاجر يقبض كاش.
منظومة حماية متكاملة ضد الاحتيال و حالات السرقة و التلف. تعويض عادل و معالجة سريعة للنزاعات.
JSON بسيط، HTTP methods متعارف عليها. تشتغل مع أي لغة برمجة أو إطار عمل — Node.js، PHP، Python، Java.
فريق مطورين جاهز للرد بكل الاستفسارات. مساعدة بربط متجرك، تجربة sandbox، و حل أي مشكلة بسرعة.
من لحظة طلب التقسيط لإكمال الدفع — كل خطوة بـ endpoint واحد فقط. الـ flow بسيط ومتسلسل.
المتجر يطلب JWT Token باستخدام بيانات الاعتماد الخاصة بشركته. الـ Token صالح 24 ساعة و يُستخدم في الطلبات التالية.
العميل يُدخل Jedoom ID الخاص فيه، و النظام يتحقق من وجوده و يُرجع اسمه و رقم هاتفه (مُخفّى جزئياً) للعرض.
يُرسل رمز تأكيد لرقم هاتف العميل المسجل في جيدوم. صلاحية الرمز 5 دقائق — لتأكيد موافقة العميل على العملية.
التاجر يُرسل OTP الذي أدخله العميل + بيانات الطلب. جيدوم تتحقق من صحة OTP تلقائياً، و إذا كان صحيح تُنشئ القسط مباشرة و تحسب القسط الشهري.
تُنشأ جلسة دفع و يُرجع رابط مباشر تُحوّل إليه العميل لإتمام الدفعة الأولى. بعد الإكمال يعود لمتجرك تلقائياً.
كل endpoint بطريقة الـ request، الـ response، و الأمثلة العملية.
احصل على JWT Token عبر بيانات اعتماد شركتك. الـ Token يُستخدم في كل الطلبات التالية و صلاحيته 24 ساعة.
| الحقل | النوع | إلزامي |
|---|---|---|
companyId | UUID | ✓ |
companyAccessToken | string | ✓ |
{
"companyId": "YOUR_COMPANY_ID",
"companyAccessToken": "YOUR_ACCESS_TOKEN"
}
{
"success": true,
"data": {
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"expires_in": 86400,
"company": "اسم الشركة"
}
}
تحقّق من وجود العميل في جيدوم بإدخال Jedoom ID الخاص فيه. يعود لك بالاسم و الهاتف المُخفّى جزئياً للعرض.
| الحقل | النوع | الوصف |
|---|---|---|
jedoom_id | string | معرّف العميل (UUID أو JDM-XXXX-XXXX) |
// Headers Authorization: Bearer <JWT_TOKEN> // Body { "jedoom_id": "JDM-XXXX-XXXX" }
{
"success": true,
"data": {
"name": "اسم العميل",
"phone_masked": "*******1234",
"email": "customer@example.com"
}
}
يُرسل رمز OTP لرقم هاتف العميل المسجل في جيدوم. صالح 5 دقائق — لتأكيد موافقة العميل على إنشاء القسط.
{
"jedoom_id": "JDM-XXXX-XXXX"
}
{
"success": true,
"data": {
"sent": true,
"phone_masked": "*******1234",
"expires_in": 300
}
}
أرسل بيانات الطلب مع رمز OTP الذي أدخله العميل — جيدوم تتحقق من صحته تلقائياً ثم تُنشئ القسط. القسط الشهري يُحسب تلقائياً.
| الحقل | النوع | الوصف |
|---|---|---|
userId | UUID أو JDM | معرّف العميل (UUID أو JDM-XXXX-XXXX) |
otp | string | رمز OTP الذي أدخله العميل (6 أرقام) |
amount | number | المبلغ الإجمالي بالدينار العراقي |
duration | number | عدد أشهر التقسيط (من 1 إلى 36) |
notes | string | ملاحظات اختيارية (رقم الطلب مثلاً) |
{
"userId": "customer-uuid",
"otp": "123456",
"amount": 150000,
"duration": 6,
"notes": "Order #12345"
}
{
"success": true,
"data": {
"id": "installment-uuid",
"customer": "اسم العميل",
"totalAmount": 150000,
"monthlyAmount": 25000,
"totalInstallments": 6,
"status": "active",
"startDate": "2026-06-05T00:00:00.000Z",
"endDate": "2026-12-05T00:00:00.000Z"
}
}
أنشئ جلسة دفع و احصل على رابط مباشر تُحوّل إليه العميل لإكمال الدفعة الأولى. بعد الإكمال يعود لمتجرك.
| الحقل | الوصف |
|---|---|
userId | معرّف العميل |
installmentId | معرّف القسط (من الـ endpoint السابق) |
successUrl | رابط التحويل عند نجاح الدفع |
failureUrl | رابط التحويل عند فشل الدفع |
{
"success": true,
"data": {
"sessionId": "session-uuid",
"paymentUrl": "https://jedoom.ai/payment?session=...",
"expiresAt": "2026-06-05T13:00:00.000Z"
}
}
paymentUrl و انتظر رجوعه عبر successUrl أو failureUrl.
كود جاهز للنسخ — يُظهر الـ flow الكامل من التحقق لإنشاء جلسة الدفع.
// 1. الحصول على Token const tokenRes = await fetch('https://jedoom.ai/api/jedoom/token', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ companyId: process.env.JEDOOM_COMPANY_ID, companyAccessToken: process.env.JEDOOM_ACCESS_TOKEN }) }); const { data: { token } } = await tokenRes.json(); // 2. التحقق من العميل const verifyRes = await fetch('https://jedoom.ai/api/jedoom/verify', { method: 'POST', headers: { 'Content-Type': 'application/json', 'Authorization': `Bearer ${token}` }, body: JSON.stringify({ jedoom_id: customerJedoomId }) }); // 3. إرسال OTP لهاتف العميل await fetch('https://jedoom.ai/api/jedoom/send-otp', { /* ... */ }); // 4. إنشاء القسط — جيدوم تتحقق من OTP تلقائياً const instRes = await fetch( 'https://jedoom.ai/api/merchant/create-installment', { method: 'POST', headers: { 'Content-Type': 'application/json', 'Authorization': `Bearer ${token}` }, body: JSON.stringify({ companyId, companyAccessToken, userId: customerUuid, otp: customerOtpInput, // الرمز اللي أدخله العميل amount: 150000, duration: 6, notes: 'Order #12345' }) } ); const { data: installment } = await instRes.json(); // 5. إنشاء جلسة الدفع و توجيه العميل const sessionRes = await fetch('https://jedoom.ai/api/payment/session', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ companyId, companyAccessToken, userId: customerUuid, installmentId: installment.id, successUrl: 'https://yourstore.com/success', failureUrl: 'https://yourstore.com/failure' }) }); const { data: { paymentUrl } } = await sessionRes.json(); // ✅ حوّل العميل لإكمال الدفع res.redirect(paymentUrl);
قواعد بسيطة تضمن لك ربط آمن و مستقر بالـ API.
إجابات سريعة على أكثر الأسئلة شيوعاً عن الربط.
successUrl الذي حدّدته عند إنشاء الجلسة. كذلك، تتوفر لوحة تحكم للتاجر تعرض حالة كل الطلبات و الأقساط.
انضم لـ مئات التجار اللي حسّنوا مبيعاتهم مع جيدوم. سجّل اليوم و استلم بيانات الاعتماد و دعم تقني مباشر.