Lemon Squeezy
اربط Lemon Squeezy بمفتاح API وWebhook موقّع.
يقرأ RevGlance منتجات متجرك على Lemon Squeezy وعملاءه وطلباته واشتراكاته وفواتير الاشتراكات بمفتاح API.
الربط
- في Lemon Squeezy، افتح Settings › API وأنشئ مفتاح API جديدًا. سمّه RevGlance.
- انسخ المفتاح فورًا: يعرضه Lemon Squeezy مرة واحدة فقط.
- الصقه في مفتاح API واختر ربط Lemon Squeezy. يقرأ RevGlance المنتجات والعملاء والطلبات والاشتراكات وفواتيرها.
ما يطلبه النموذج
| الحقل | يبدو مثل |
|---|---|
| مفتاح APIمخزّن بتشفير | eyJ0eXAiOiJKV1Qi… |
إضافة Webhook
- في RevGlance، افتح الإعدادات › المصادر، وافتح قائمة مصدر Lemon Squeezy واختر Webhook. انسخ العنوان.
- في Lemon Squeezy، افتح Settings › Webhooks وأضف Webhook بذلك العنوان. اختلق signing secret عشوائيًا طويلًا وحدّد أحداث الطلبات والاشتراكات ومدفوعات الاشتراكات.
- الصق السرّ نفسه في سرّ التوقيع في RevGlance واحفظ.
ما يزامنه RevGlance
- المتغيّرات، للتمييز بين الاشتراكات والمنتجات لمرة واحدة ولقراءة فترة كل خطة.
- الاشتراكات، تُقرأ كاملة في كل مرة، من أجل MRR والخطط والفترات التجريبية والإلغاءات.
- العملاء والطلبات وفواتير الاشتراكات. يسرد Lemon Squeezy هذه من الأحدث إلى الأقدم دون عامل تصفية بالتاريخ، لذا تقرأ المزامنات اللاحقة رجوعًا حتى 60 يومًا قبل آخر مزامنة، وتعيد قراءة كل شيء مرة في الأسبوع، لالتقاط استردادات الطلبات الأقدم.
كيف يُحسب Lemon Squeezy
- الدفعات هي إجمالي الطلب أو الفاتورة مطروحًا منه الضريبة.
- يُبلغ Lemon Squeezy عن المبالغ المستردة شاملةً الضريبة، لذا يطرح RevGlance الضريبة بالتناسب. توقّع فرق تقريب بسنت من حين لآخر.
- تؤرَّخ الاستردادات الكاملة بيوم إجرائها في Lemon Squeezy. أما الاستردادات الجزئية فبلا تاريخ، لذا تظهر بتاريخ الفاتورة.
- يبقى الاشتراك الملغى محتسبًا حتى تنتهي فترته المدفوعة. ويُحتسب غير المدفوع (أربع محاولات فاشلة) تسرّبًا، ويعود إذا استُعيد الدفع.
- لا يرسل Lemon Squeezy تاريخ الإلغاء ولا سببه: تاريخ الإلغاء هو آخر تغيير للاشتراك.
- لا يُبلغ Lemon Squeezy عن الرسوم، لذا تظهر الرسوم صفرًا.
- يُخصم الخصم من MRR متى أظهره تجديد. ولا يوضّح Lemon Squeezy إن كان الخصم يتكرر، لذا لا يُحتسب الخصم الوارد في الفاتورة الأولى وحدها.
- يُلتقط استرداد الطلب الأقدم بقراءة كاملة مرة في الأسبوع، لذا قد يظهر متأخرًا حتى أسبوع.
- لا تظهر الفترة التجريبية التي تحوّلت قبل الربط، لأن Lemon Squeezy لا يذكر الفترة التجريبية إلا أثناء سريانها.
- لا تُقرأ عمليات ردّ المبلغ، لذا يبقى الردّ الخاسر محتسبًا دفعةً ما لم يُبلغ عنه المزوّد أيضًا كاسترداد.

RevGlance