الميزات الجديدة
1. الفوترة المبنية على الرصيد
تدعم Dodo Payments الآن الفوترة المبنية على الرصيد، وهو نظام مرن لإصدار وإدارة وتتبع استحقاقات الرصيد عبر الاشتراكات، والمنتجات ذات الدفع لمرة واحدة، والفوترة المبنية على الاستخدام. بدلاً من فرض رسوم لكل استخدام أو تحديد الوصول عبر أعلام الميزات، يمكنك تخصيص مجموعة من الأرصدة يسحب منها العملاء أثناء استهلاكهم لخدمتك.
ما يمكنك فعله
| القدرة | الوصف |
|---|
| وحدات مخصصة أو أرصدة بالعملة الرسمية | عرّف الأرصدة بوحدتك الخاصة (نداءات API، رموز، ساعات الحوسبة) أو بقيمة عملة فعلية (USD، EUR) |
| أرصدة الاشتراك | إصدار أرصدة لكل دورة فوترة مع إعادة الإصدار تلقائياً عند التجديد |
| أرصدة لمرة واحدة | منح رصيد ثابت عند الشراء، مثالية لحزم التعبئة أو باقات الترويج |
| الخصم المبني على الاستخدام | اربط الأرصدة بالعدادات للخصم التلقائي اعتماداً على أحداث الاستهلاك في الوقت الفعلي |
| التحويل | السماح بترحيل الأرصدة غير المستخدمة مع حد أقصى نسبي مخصص، والإطار الزمني، وعدد مرات التحويل |
| ضوابط الزيادة | اسمح للعملاء بمواصلة استخدام خدمتك بعد نفاد الرصيد، مع خيارات للغفران أو الفوترة أو ترحيل العجز |
| انتهاء الصلاحية | حدد صلاحية الرصيد من 7 أيام وحتى لا تنتهي، مع عدد أيام مخصص |
- إصدار الأرصدة - تُمنح عندما يشتري العميل منتجاً مرتبطاً باستحقاقات الرصيد. بالنسبة للاشتراكات، يُعاد إصدار الأرصدة كل دورة فوترة.
- استهلاك الأرصدة - تُخصم مع استخدام العملاء للخدمة. تخصم العدادات الأرصدة تلقائياً وفقاً للأحداث في الوقت الفعلي، أو يمكنك الخصم يدوياً عبر لوحة التحكم أو API.
- انتهاء صلاحية الأرصدة أو ترحيلها - في نهاية دورة الفوترة (أو بعد الفترة المحددة للانتهاء)، إما أن تنتهي صلاحية الأرصدة غير المستخدمة أو تُرحّل حسب إعداداتك.
- معالجة الزيادة - إذا نفدت الأرصدة منتصف الدورة، يمكنك السماح بالاستمرار في الاستخدام وتحديد كيفية التعامل مع الزيادة عند نهاية الدورة.
ربط الأرصدة بالمنتجات
تُرفق الأرصدة كـاستحقاقات في سير إنشاء المنتج. يمكنك إرفاق ما يصل إلى 3 أرصدة لكل منتج، وتعمل الأرصدة مع جميع أنواع التسعير الثلاثة: الاشتراكات، المدفوعات لمرة واحدة، والفوترة المبنية على الاستخدام.
// Create a checkout session for a product with attached credits
const session = await client.checkoutSessions.create({
product_cart: [
{
product_id: 'prod_ai_pro_plan',
quantity: 1,
}
],
customer: { email: 'customer@example.com' },
return_url: 'https://yourapp.com/success'
});
// Send usage events that deduct credits automatically
await fetch('https://api.dodopayments.com/events/ingest', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.DODO_API_KEY}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({
events: [{
event_id: `gen_${Date.now()}`,
customer_id: 'cus_abc123',
event_name: 'ai.generation',
timestamp: new Date().toISOString(),
metadata: { model: 'gpt-4', tokens: 1500 }
}]
})
});
| الحدث | الوصف |
|---|
credit.added | الأرصدة الممنوحة للعميل |
credit.deducted | الأرصدة المستهلكة عبر الاستخدام أو الخصم اليدوي |
credit.expired | انتهت صلاحية الأرصدة غير المستخدمة |
credit.rolled_over | تم ترحيل الأرصدة إلى منح جديدة |
credit.rollover_forfeited | فُقدت الأرصدة عند بلوغ الحد الأقصى لعدد الترحيلات |
credit.overage_charged | تم تطبيق رسوم الزيادة |
credit.manual_adjustment | تم إجراء تعديل يدوي في الرصيد/الخصم |
credit.balance_low | انخفض الرصيد عن الحد المكوّن |
ابدأ بإعدادات بسيطة، لا ترحيل، لا زيادة، وأضف التعقيد مع تعلمك كيفية استخدام العملاء للأرصدة. يمكن تحديث معظم الإعدادات في أي وقت دون التأثير على المنح الحالية.
2. التصميم وتخصيص السمة
نقدم الصفحة الجديدة التصميم، وهي محور موحد لتخصيص مظهر تجربة الخروج، والواجهة، وبوابة العملاء من مكان واحد. اختر السمات الجاهزة، اضبط الطباعة والألوان، وطبّق تفضيلات لكل قسم، مع معاينة مباشرة قبل الحفظ.
النقاط البارزة
| الميزة | الوصف |
|---|
| محور تصميم موحد | اضبط مظهر صفحة الدفع، والواجهة، وبوابة العملاء من صفحة واحدة |
| سمات جاهزة | ابدأ بسمة مختارة (Dodo Pulses، Terminal، Bumblebee، أو Bubblegum) وخصصها من هناك |
| وضع الضوء والظلام | حدد لوحات ألوان منفصلة لكل وضع |
| معاينة مباشرة | شاهد كيف تبدو التعديلات عبر الخروج، وبوابة العملاء، والواجهة قبل الحفظ |
| التجاوز لكل قسم | اضبط الأقسام الفردية بدقة دون التأثير على الآخرين |
| التحكم البرمجي | تجاوز السمات عند الخروج عبر API أو Checkout SDK |
| التبويب | الغرض |
|---|
| عام | اسم النشاط التجاري، الشعار، اختيار السمة، والإعدادات المتقدمة العامة |
| الدفع | تجاوز إعدادات السمة خصيصاً لصفحة الدفع |
| الواجهة | تجاوز إعدادات السمة وضبط تخطيط الواجهة |
| بوابة العملاء | تجاوز إعدادات السمة لبوابة العملاء |
- Dodo Pulses - السمة الافتراضية مع لمسات خضر الليمون وطباعة نظيفة بدون أطراف
- Terminal - موجهة للمطورين مع طباعة ثابتة العرض ولمسات زرقاء ملكية
- Bumblebee - لمسات كهرمانية وذهبية دافئة مع تصميم جريء وفاخر
- Bubblegum - لمسات وردية وماغنتا مرحة مع زوايا مدورة بالكامل
بعد اختيار سمة جاهزة، يمكنك تخصيص خصائص فردية أكثر في الإعدادات المتقدمة. أي خصائص غير محددة تعود إلى إعدادات السمة الافتراضية.
3. حالة الاسترداد وحالة النزاع في واجهة قائمة المدفوعات
يحتوي نقطة النهاية القائمة GET /payments الآن على الحقول refund_status و dispute_status في كل عنصر دفع، حتى تتمكن من رؤية حالة الاسترداد والنزاع مباشرة دون استرجاع تفاصيل الدفع الفردية.
| الحقل | النوع | الوصف |
|---|
refund_status | partial | full | null | ملخص حالة الاسترداد لهذا الدفع. null إذا لم تكن هناك استردادات ناجحة |
dispute_status | string | null | أحدث حالة نزاع لهذا الدفع. null إذا لم تكن هناك نزاعات |
dispute_status: dispute_opened، dispute_expired، dispute_accepted، dispute_cancelled، dispute_challenged، dispute_won، dispute_lost
يمكنك أيضاً تصفية المدفوعات حسب حالة النزاع باستخدام معامل الاستعلام dispute_status:
# List all payments with open disputes
curl -X GET 'https://api.dodopayments.com/payments?dispute_status=dispute_opened' \
-H 'Authorization: Bearer YOUR_API_KEY'
استخدم هذه الحقول لبناء لوحات تحكم للنزاعات والاستردادات، أو إطلاق تنبيهات عند تغيير حالة النزاع، أو تصفية قائمة المدفوعات لإظهار المدفوعات التي تحتاج انتباهاً.
4. جدول الاستردادات في بوابة العملاء
تتضمن بوابة العملاء الآن قسم الاستردادات المخصص حيث يمكن للعملاء عرض جميع الاستردادات المتعلقة بمدفوعاتهم. يُظهر كل إدخال مبلغ الاسترداد، والحالة، والتاريخ، والدفع الأصلي الذي صدر ضده، مما يمنح العملاء شفافية كاملة في سجل الاستردادات دون الحاجة للتواصل مع الدعم.
جدول الاستردادات متاح تلقائياً في بوابة العملاء لجميع الأعمال. لا حاجة لأي تكوين.
5. نسخ إلى الوضع الحي للعدادات
يمكنك الآن نسخ العدادات من وضع الاختبار إلى الوضع الحي مباشرة من لوحة التحكم. عند انتهائك من اختبار تكوين عداد في وضع الاختبار، استخدم إجراء النسخ لتكراره في الوضع الحي مع الحفاظ على جميع الإعدادات: نوع التجميع، واسم الحدث، والفلاتر، وربط الأرصدة. هذا يلغي الحاجة لإعادة إنشاء العدادات يدويًا عند الانتقال من التطوير إلى الإنتاج.
قم ببناء والتحقق من تكوينات العدادات في وضع الاختبار أولاً، ثم انسخها إلى الوضع الحي عندما تكون مستعداً للإنتاج. هذا يضمن أن إعدادات الفوترة مُختبرة قبل أن تتعامل مع استخدام العملاء الحقيقي.
