نظرة عامة
تضيف إضافة Dodo Payments لـ Framer أزرار شراء لمنتجات Dodo Payments إلى موقع Framer. يفتح كل زر صفحة الدفع كتراكب على صفحتك، أو يرسل العميل إلى صفحة الدفع المستضافة، سواء في وضع الاختبار أو الوضع المباشر.Official Plugin
ثبّت إضافة Dodo Payments من Framer Marketplace.
الميزات
Hosted or Overlay Checkout
افتح صفحة الدفع كتراكب على صفحتك، أو أرسل العملاء إلى صفحة الدفع المستضافة.
Drag-and-Drop Setup
الصق مفتاح API في الإضافة، وأضف زر شراء إلى اللوحة، ثم انشر.
Digital Delivery
أرسل روابط التنزيل أو مفاتيح الترخيص إلى العملاء عبر البريد الإلكتروني بعد الدفع.
Worldwide Coverage
بِع للعملاء في أكثر من 220 دولة باستخدام البطاقات والمحافظ وطرق الدفع المحلية.
Automatic Tax & Invoicing
بصفتها Merchant of Record، تحسب Dodo Payments ضريبة القيمة المضافة وGST وضريبة المبيعات وتحوّلها، وتصدر فاتورة لكل دفعة.
No-Code Subscriptions
تحصل المنتجات القائمة على الاشتراكات على زر الشراء نفسه المستخدم للمنتجات ذات الدفع لمرة واحدة، من دون كتابة أي كود.
دليل الإعداد
1
Generate API Key
في لوحة تحكم Dodo Payments، انتقل إلى Developer → API Keys وانقر على Add API Key. يمكنك أيضًا فتح صفحة API Keys مباشرةً.يعمل مفتاح API في وضع واحد فقط. قبل إنشاء المفتاح، استخدم مفتاح التبديل Live Mode في الشريط الجانبي لاختيار الوضع:
- Live Mode
- Test Mode
للبيئة الإنتاجية. يدفع العملاء باستخدام طرق دفع حقيقية.
انسخ مفتاح API وخزّنه بأمان. تعرضه لوحة التحكم مرة واحدة فقط، وستلصقه في الإضافة في الخطوة التالية.
2
Authenticate Plugin
- افتح إضافة Dodo Payments في Framer. ستفتح على صفحة Authenticate.
- ضمن API Mode، اختر Test Mode أو Live Mode بما يتوافق مع مفتاح API الخاص بك.
- الصق مفتاح API في API Key.
- انقر على Continue.
3
Manage Products
بعد المصادقة، تعرض الإضافة المنتجات من الوضع الذي اخترته ضمن Products:
- تظهر Existing products تلقائيًا، ويُشار إلى كل منها بأنها One-time أو Subscription.
- No products yet: انقر على زر Plus (+) بجانب Products.
يفتح زر Plus (+) لوحة تحكم Dodo Payments، حيث تنشئ منتجًا وتحدد سعره ووصفه وإعداداته الأخرى.
4
Add Buy Buttons
- اختر منتجًا من القائمة.
- انقر على Add Buy Button.
Buy {product_name} إلى لوحتك. في شاشة المنتج نفسها، يفتح Edit المنتج في لوحة تحكم Dodo Payments، بينما يفتح Show Preview معاينة صفحة الدفع الخاصة به.التخصيص
لتغيير طريقة عمل زر الشراء، حدده على اللوحة وعدّل خصائصه في Framer.1
Select Checkout Experience
عيّن Type لاختيار طريقة فتح صفحة الدفع:
- Overlay: تفتح صفحة الدفع كتراكب على صفحة Framer، بحيث يبقى العملاء على موقعك. تستخدم الإضافة هذا النوع للأزرار الجديدة.
- Hosted: يرتبط الزر بصفحة الدفع المستضافة من Dodo Payments. يحدد Link Target ما إذا كانت الصفحة ستفتح في علامة تبويب جديدة أو في علامة التبويب نفسها.
2
Customize Appearance Options
طابق الزر وصفحة الدفع مع موقعك باستخدام هذه الخصائص:
- Checkout Theme: صفحة دفع بمظهر فاتح أو داكن.
- Label: نص الزر، مثل “Buy Now” أو “Purchase” أو “Get Started”.
- تنسيق الزر: لون الخلفية، ولون النص، والخط، وحجم الخط، ونصف قطر الحدود، والحشو.
- Return URL: صفحة Framer أو عنوان URL الذي يعود إليه العملاء بعد إتمام الدفع.
- Environment: Live أو Test. تضبطه الإضافة على الوضع الذي صادقت باستخدامه.
استكشاف الأخطاء وإصلاحها
Authentication Issues
Authentication Issues
المشكلة: لا تتمكن الإضافة من المصادقة.الحلول:
- تحقق من لصق مفتاح API الكامل.
- تحقق من توافق API Mode مع الوضع الذي أُنشئ فيه المفتاح. لا يعمل مفتاح وضع الاختبار في الوضع المباشر، كما لا يعمل مفتاح الوضع المباشر في وضع الاختبار.
- تحقق من اتصالك بالإنترنت.
Product Display Issues
Product Display Issues
المشكلة: لا تظهر المنتجات في الإضافة.الحلول:
- تحقق من إنشاء المنتجات في لوحة تحكم Dodo Payments.
- تحقق من وجود المنتجات في الوضع نفسه الذي يوجد فيه مفتاح API. تعرض الإضافة المنتجات الموجودة في الوضع الذي صادقت باستخدامه فقط.
- صادق على الإضافة مرة أخرى.