RevGlanceالمستندات

ربط المصادر

كيف تعمل المصادر والمفاتيح وWebhooks والمزامنة، أيًّا كان المزوّد الذي تستخدمه.

المصدر حساب واحد لدى مزوّد دفع، مربوط بنشاط تجاري واحد. يمكن أن يكون للنشاط التجاري عدة مصادر، حتى من المزوّد نفسه: حساب Stripe وتطبيق في App Store، أو حسابا Stripe. يربط المالكون والمسؤولون المصادر، ويطّلع عليها المُشاهدون.

المزوّدون المدعومون

المزوّدون الموسومون بـ beta بُنيت تكاملاتهم واختُبرت وفق وثائق المزوّد، لكنها لم تُشغَّل بعد على حساب حقيقي. أخبرنا إذا اختلف رقم عن تقارير المزوّد نفسه.

المفاتيح

يُربط كل مصدر بمفتاح تنشئه لدى المزوّد. يخزّن RevGlance بيانات الاعتماد مشفّرة، ولا يعرضها مرة أخرى أبدًا، ويقرأ فقط. فضّل المفتاح المقيّد أو المفتاح للقراءة فقط حيثما يوفّره المزوّد.

ثمة ميزتان يمكنهما الكتابة، وفقط عندما تسمح بذلك على المفتاح:

  • يمكن لـرسائل الاستعادة إنشاء رابط لتحديث البطاقة (جلسة بوابة في Stripe، أو جلسة عميل في Polar، أو معاملة تحديث الدفع في Paddle).
  • في وضع الخصوصية، يطلب إرسال رسائل الاستعادة أو الاستبيان عنوانَ العميل من المزوّد لحظة الإرسال.

المزامنة

  • المزامنة الأولى تقرأ كل ما يحتفظ به المزوّد، إلا حيث يقيّد المزوّد ذلك (يحتفظ App Store بتقارير يومية لمدة عام).
  • المزامنات اللاحقة تقرأ بدءًا من ثلاثة أيام قبل آخر مزامنة، فتُلتقط التغييرات المتأخرة. أما الحالة الحالية، مثل الاشتراكات، فتُقرأ كاملة.
  • تُزامَن المصادر كل ساعة ما دام أحد يستخدم النشاط التجاري. وعندما لا يسجّل أحد الدخول لمدة 30 يومًا، تُزامَن مرة يوميًا؛ والعودة تُزامن كل ما مضى عليه أكثر من ساعة.
  • مزامنة الآن في حالة المزامنة بالشريط العلوي تُزامن كل مصادر النشاط التجاري دفعة واحدة.

عندما يرفض مزوّد طلبًا، يعرض المصدر الخطأ تحت اسمه في الإعدادات › المصادر. تحتفظ المزامنة الجزئية بموضعها، فتقرأ المحاولة التالية النافذة نفسها مجددًا.

Webhooks

يتيح Webhook للمزوّد إبلاغ RevGlance بأن شيئًا ما تغيّر، فيضع RevGlance مزامنة لذلك المصدر في قائمة الانتظار فورًا. تجد عنوان Webhook الخاص بالمصدر في الإعدادات › المصادر ضمن قائمته، Webhook. يتحقق المزوّدون من Webhooks بإحدى ثلاث طرق:

الطريقةالمزوّدونما تفعله
سرّ التوقيعStripe, Polar, Lemon Squeezy, Paddle, Recurlyالصق سرّ التوقيع الخاص بالمزوّد في RevGlance
سرّ داخل العنوانGumroad, App Store, Google Play, Chargebeeاحفظ سرًّا عشوائيًا في RevGlance، ثم أضف ?token= والسرّ إلى العنوان الذي تعطيه للمزوّد
مفاتيح المصدر نفسهBraintree, Shopifyلا شيء: يوقّع المزوّد بالمفاتيح التي يملكها المصدر أصلًا

الحساب

يبلّغ كل مزوّد عن الأموال بطريقة مختلفة قليلًا: مبالغ مستردة مع الضريبة أو بدونها، ورسوم أو لا رسوم، وتواريخ إلغاء أو لا. يوحّد RevGlance هذه الفروق بالطريقة نفسها في كل مكان، ويذكر حيث لا يستطيع. يسرد كل دليل تكامل قواعد مزوّده، وتجمعها كلها صفحة كيف نحسب في مكان واحد.

إزالة مصدر

اختر إزالة المصدر من قائمته واضغط مطولًا على الزر. تُزال مدفوعاته واشتراكاته معه، وإعادة ربطه تعيدها.