RevGlanceالمستندات

Paddle

اربط Paddle Billing بمفتاح API يمكنه قراءة المعاملات والتعديلات والاشتراكات والعملاء.

الربط

  1. في Paddle، افتح Developer tools › Authentication وأنشئ مفتاح API. Paddle Billing فقط: لا يُدعم Paddle Classic.
  2. اسمح له بقراءة transactions وadjustments وsubscriptions وcustomers. أضف transaction.write إذا كنت سترسل رسائل الاستعادة بالبريد الإلكتروني.
  3. انسخ المفتاح. يبدأ المفتاح الحي بـ pdl_live_apikey_؛ ويعمل مفتاح sandbox أيضًا ويُزامن من بيئة sandbox في Paddle.
  4. الصقه في مفتاح API واختر ربط Paddle.

ما يطلبه النموذج

الحقليبدو مثل
مفتاح APIمخزّن بتشفيرpdl_live_apikey_…

إضافة Webhook

  1. في RevGlance، افتح الإعدادات › المصادر، وافتح قائمة مصدر Paddle واختر Webhook. انسخ العنوان.
  2. في Paddle، افتح Developer tools › Notifications وأضف وجهة بذلك العنوان. حدّد أحداث المعاملات والتعديلات والاشتراكات.
  3. انسخ secret key الخاص بالوجهة، والصقه في سرّ التوقيع في RevGlance واحفظ.

ما يزامنه RevGlance

  • المعاملات المدفوعة أو المكتملة، مع عميلها وعنوانه.
  • التعديلات: تصبح المبالغ المستردة وعمليات ردّ المبلغ المعتمدة مبالغ مستردة، وتُلغى مجددًا عند عكسها.
  • الاشتراكات، من أجل MRR والخطط والفترات التجريبية والإلغاءات، مع طرح الخصومات المتكررة من MRR.
  • العملاء، النشطون والمؤرشفون.

لا يحتفظ Paddle بأسباب الإلغاء، لذا تصل الإلغاءات بدون سبب.

كيف يُحسب Paddle

  • تأتي المبالغ من إجماليات مدفوعات Paddle، قبل الضريبة، مع رسوم Paddle كرسوم.
  • تُحتسب المبالغ المستردة وعمليات ردّ المبلغ قبل الضريبة. وردّ المبلغ الذي تربحه Paddle، أو الاسترداد الذي تلغيه Paddle، لم يعد يُحتسب.
  • تُحتسب رسوم ردّ المبلغ التي تحتفظ بها Paddle ضمن الرسوم.
  • يُحتسب السعر الشامل للضريبة في MRR قبل الضريبة، بحصة الضريبة في الفاتورة التالية.
  • تُخصم الخصومات المتكررة من MRR، حتى إذا أُرشف الخصم لاحقًا.
  • يُحتسب الدفع الذي تعذّر تحصيله دفعةً فاشلة. ولا ينقل أي أموال.

رسائل الاستعادة

تربط استعادة كل دفعة فاشلة بصفحة الدفع الخاصة بتحديث طريقة الدفع في Paddle. يتطلب ذلك transaction.write على المفتاح؛ وبدونه، يرتبط البريد الإلكتروني بصفحة تحديث البطاقة الخاصة بك.