v1.75.0 (23 يناير 2026)

​

ميزات جديدة

​

1. مجموعات المنتجات

• دفع قائم على المجموعة: عرض جميع المنتجات في المجموعة في شاشة دفع واحدة، مما يتيح للعملاء المقارنة واختيار خطتهم المفضلة
• إدارة منتجات منظمة: تجميع المنتجات المرتبطة (مثل Starter وPro وEnterprise) ضمن مجموعة واحدة
• تكامل بوابة العملاء: تمكين العملاء من الترقية أو التراجع بين المنتجات ضمن نفس المجموعة
• تحكم التاجر: تمكين أو تعطيل المنتجات وإعادة ترتيبها داخل كل مجموعة

const session = await client.checkoutSessions.create({
  product_collection_id: 'pdc_abc123',
  product_cart: [], // Required: pass an empty array for collection checkout
  return_url: 'https://yoursite.com/return'
});

// Redirect customer to the checkout
window.location.href = session.url;

​

2. طرق الدفع RevolutPay وBillie بعملة GBP

• RevolutPay – مدفوعات سريعة وسلسة لمستخدمي Revolut حول العالم
• Billie – حل B2B للشراء الآن والدفع لاحقًا يمكّن الشركات من تقديم شروط دفع مرنة لعملائهم

​

3. معاينة جلسة الدفع

const preview = await client.checkoutSessions.preview({
  product_cart: [
    { product_id: 'prod_123', quantity: 1 }
  ],
  billing_address: {
    country: 'US',
    state: 'CA',
    zipcode: '94102'
  },
  discount_code: 'SAVE20'
});

console.log('Subtotal:', preview.subtotal);
console.log('Tax:', preview.tax);
console.log('Discount:', preview.discount);
console.log('Total:', preview.total);

• عرض تسعير مخصص: عرض الإجماليات الدقيقة بما في ذلك الضريبة قبل الدفع
• التحقق من الخصومات: التحقق من رموز الخصم وعرض التوفير للعملاء
• دعم عملات متعددة: معاينة التسعير بعملات مختلفة
• ملخصات السلة: بناء واجهات مستخدم مخصصة للسلة مع التسعير في الوقت الفعلي

​

4. دعم البيانات الوصفية في طلبات تغيير الخطة

// Adding metadata when changing a subscription plan
await client.subscriptions.changePlan('sub_123', {
  product_id: 'prod_premium',
  proration_billing_mode: 'prorated_immediately',
  quantity: 1,
  metadata: {
    upgrade_reason: 'feature_request',
    previous_plan: 'basic',
    sales_rep: 'john@company.com'
  }
});

• تتبع أسباب الترقية/التراجع: حفظ سبب تغيير العملاء للخطط
• الربط بسجلات إدارة علاقات العملاء: ربط تغييرات الخطط بالأنشطة البيعية
• التصنيف الداخلي: وسم تغييرات الخطط للتقارير والتحليلات
• سجلات التدقيق: الاحتفاظ بسجلات من الذي بدأ تغييرات الخطط

​

5. حقل invoice_url في استجابة الدفع واستجابة رابط الدفع

{
  "payment_id": "pay_2IjeQm4hqU6RA4Z4kwDee",
  "status": "succeeded",
  "invoice_url": "https://dodopayments.com/invoices/inv_2IsUnWGtRKFLxk7xAQeyt",
  "amount": 9900,
  "currency": "USD",
  // ... other fields
}

• التواصل مع العملاء: إرسال روابط الفاتورة مباشرةً إلى العملاء
• التكامل المحاسبي: ربط المدفوعات بالفواتير في برامج المحاسبة الخاصة بك
• بوابات الخدمة الذاتية: تمكين العملاء من الوصول إلى فواتيرهم بسهولة
• حفظ السجلات: الاحتفاظ بإشارات مباشرة إلى مستندات الفاتورة

​

6. نقطة نهاية التحقق من الخصم بواسطة اسم الكود

// Validate a discount code before checkout
const discount = await client.discounts.getByCode('SAVE20');

console.log('Discount type:', discount.type);
console.log('Discount value:', discount.amount);
console.log('Valid until:', discount.expires_at);

• التحقق قبل الدفع: تأكد من صلاحية رموز الخصم قبل إنشاء جلسات الدفع
• ردود فعل في الوقت الفعلي: أظهر للعملاء ما إذا كان رمزهم صالحًا
• معالجة الأخطاء: اكتشاف الرموز غير الصالحة أو المنتهية مبكرًا
• واجهات خصم مخصصة: بناء حقول إدخال رموز الخصم مع التحقق الفوري

​

7. قدرات تصفية محسّنة للعملاء والخصومات ومفاتيح الترخيص

// Find customers by name created in the last 30 days
const customers = await client.customers.list({
  name: 'John',
  created_at_gte: '2026-01-01T00:00:00Z'
});

// Find active percentage discounts for a specific product
const discounts = await client.discounts.list({
  active: true,
  discount_type: 'percentage',
  product_id: 'prod_123'
});

// Find active license keys for a specific product
const licenseKeys = await client.licenseKeys.list({
  status: 'active',
  product_id: 'prod_123'
});

​

8. تحسينات واجهة المستخدم/تجربة المستخدم في لوحة التحكم

• تحسين التنقل واتساق التخطيط
• تعزيز تفاعلات جداول البيانات
• حالات تحميل وردود فعل محسنة
• تعزيز عناصر التصميم البصري
• تحسين التوافق مع الأجهزة المحمولة