Paddle

לחבר את Paddle Billing עם מפתח API שיכול לקרוא עסקאות, התאמות, מנויים ולקוחות.

חיבור

ב-Paddle, לפתוח את Developer tools › Authentication וליצור מפתח API. Paddle Billing בלבד: אין תמיכה ב-Paddle Classic.
לאפשר לו לקרוא transactions, adjustments, subscriptions ו-customers. להוסיף transaction.write אם מתכננים לשלוח אימיילים לשחזור תשלומים.
להעתיק את המפתח. מפתח live מתחיל ב-pdl_live_apikey_; גם מפתח sandbox עובד, והוא מסנכרן מה-sandbox של Paddle.
להדביק אותו תחת מפתח API ולבחור חיבור Paddle.

מה הטופס מבקש

שדה	נראה כך
מפתח APIנשמר מוצפן	`pdl_live_apikey_…`

הוספת ה-webhook

ב-RevGlance, לפתוח את הגדרות › מקורות, לפתוח את התפריט של מקור ה-Paddle ולבחור Webhook. להעתיק את ה-URL.
ב-Paddle, לפתוח את Developer tools › Notifications ולהוסיף destination עם ה-URL הזה. לבחור את האירועים של עסקאות, התאמות ומנויים.
להעתיק את ה-secret key של ה-destination, להדביק אותו תחת סוד חתימה ב-RevGlance ולשמור.

מה RevGlance מסנכרנת

עסקאות ששולמו או הושלמו, עם הלקוח והכתובת שלהן.
התאמות: החזרים וביטולי עסקה שאושרו הופכים להחזרים, ויורדים שוב כשהם מבוטלים.
מנויים, עבור MRR, תוכניות, תקופות ניסיון וביטולים, כשהנחות חוזרות מנוכות מה-MRR.
לקוחות, פעילים ומאורכבים.

Paddle לא שומרת סיבות ביטול, ולכן ביטולים מגיעים בלי סיבה.

איך Paddle נספרת

הסכומים מגיעים מסכומי התשלום של Paddle, לפני מס, עם העמלה של Paddle כעמלה.
החזרים וביטולי עסקה נספרים לפני מס. ביטול עסקה ש-Paddle זוכה בו, או החזר ש-Paddle מבטלת, כבר לא נספר.
עמלה על ביטול עסקה ש-Paddle גובה נספרת כעמלה.
מחיר שכולל מס נספר ב-MRR לפני מס, לפי חלק המס בחשבונית הבאה.
הנחות חוזרות מופחתות מה-MRR, גם כשההנחה הועברה לארכיון מאוחר יותר.
תשלום שלא ניתן היה לגבות נספר כחיוב שנכשל. לא מועבר כסף.

אימיילים לשחזור

שחזור מקשר כל תשלום שנכשל לדף התשלום של Paddle לעדכון אמצעי התשלום. לשם כך המפתח צריך transaction.write; בלעדיו, האימייל מקשר לעמוד עדכון הכרטיס שלך.