Stripe

يقرأ RevGlance حسابك على Stripe عبر API الخاصة بـ Stripe بمفتاح تنشئه أنت. يقرأ الدفعات والمبالغ المستردة والرسوم والنزاعات والاشتراكات، ولا يفرض أي رسوم ولا يردّ أي مبالغ ولا يغيّر أي شيء أبدًا.

قبل أن تبدأ

• يجب أن تكون مالك النشاط التجاري أو مسؤولًا فيه على RevGlance. لا يمكن للمُشاهدين إضافة مصادر.
• استخدم restricted key بدلًا من مفتاحك السرّي. يقبل RevGlance كليهما (rk_… أو sk_…)، لكن المفتاح المقيّد لا يقرأ إلا ما تسمح به.
• تعمل مفاتيح وضع الاختبار أيضًا، وهي مفيدة لإلقاء نظرة أولى. اربط مصدرًا ثانيًا بمفتاحك الحي عندما تكون جاهزًا.

الربط

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

حقل الاسم اختياري. يميّز بين حسابَي Stripe في نشاط تجاري واحد.

إضافة Webhook

بدون Webhook، يُزامن RevGlance حساب Stripe كل ساعة. ومعه، تضع أي دفعة جديدة أو استرداد أو إلغاء مزامنةً في قائمة الانتظار خلال ثوانٍ.

ما يزامنه RevGlance

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

تقرأ المزامنة الأولى سجلك بالكامل. بعد ذلك تقرأ كل مزامنة بدءًا من ثلاثة أيام قبل آخر مزامنة، فتُلتقط التغييرات المتأخرة، وتُقرأ الاشتراكات كاملة في كل مرة.

كيف يُحسب Stripe

• تأتي الدفعات والمبالغ المستردة ورسوم Stripe من معاملات رصيدك، بالعملة التي سوّتها بها Stripe.
• تُحتسب استردادات البطاقات في اليوم الذي تسجّلها فيه Stripe. وتُحتسب المدفوعات المصرفية أيضًا (ACH وSEPA وطرق محلية أخرى)؛ والاسترداد الذي يعيده البنك يخفّض استرداداتك مجددًا.
• يُحتسب النزاع استردادًا حين تستعيد Stripe المال، ويُلغى الاسترداد إن ربحته. وتُحتسب رسوم النزاع لدى Stripe رسومًا.
• تُخصم القسائم على الاشتراك وعلى العناصر المفردة من MRR. ولا تُحتسب القسيمة ذات المبلغ الثابت إلا بعملتها.
• تُحتسب الاشتراكات الموقوفة مؤقتًا وغير المدفوعة تسرّبًا؛ ويبقى المتأخر السداد محتسبًا ما دامت Stripe تعيد محاولة الدفع بالبطاقة.
• تُحتسب الدفعات والمبالغ المستردة والنزاعات قبل الضريبة، بحصة الضريبة في فاتورتها أو Checkout Session الخاصة بها. ودون صلاحية القراءة على Checkout Sessions، تبقى الضريبة على المبيعات خارج الفواتير مشمولة.
• يُحتسب السعر الشامل للضريبة في MRR قبل الضريبة، بحصة الضريبة في آخر فاتورة.
• يُحتسب إيقاف تحصيل المدفوعات مؤقتًا تسرّبًا من اليوم الذي يرصده فيه RevGlance لأول مرة، لأن Stripe لا تحدد تاريخه.

راجع كيف نحسب للاطلاع على القواعد التي تسري على كل مزوّد.

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

تربط استعادة دفعة الاشتراك الفاشلة بصفحة فاتورتها المفتوحة في Stripe، حيث يمكن للعميل الدفع ببطاقة جديدة. وعندما لا توجد فاتورة مفتوحة، تفتح جلسة بوابة عملاء Stripe بدلًا من ذلك. يتطلب هذا البديل تفعيل البوابة في Stripe ومفتاحًا مسموحًا له بكتابة جلسات Customer portal؛ وبدون ذلك، يرتبط البريد الإلكتروني بصفحة تحديث البطاقة الخاصة بك.

حل المشكلات

• "الصق مفتاح Stripe سرّيًا أو مقيّدًا." يجب أن يبدأ المفتاح بـ rk_ أو sk_. المفتاح القابل للنشر (pk_) لا يمكنه قراءة أي شيء.
• "رفضت Stripe هذا المفتاح." أُلغي المفتاح، أو ينقصه صلاحية القراءة على Balance.
• "رفضت Stripe طلب الدفعات الفاشلة" أو "طلب الاشتراكات": لا يستطيع المفتاح قراءة Charges أو Subscriptions. تظل المدفوعات تُزامَن؛ أضف الصلاحية الناقصة وزامن مجددًا.