Braintree

לחבר את Braintree עם זוג מפתחות API כדי לקרוא עסקאות וחיוב חוזר.

RevGlance קוראת את ה-gateway API של Braintree, זה שה-SDK לשרת של Braintree משתמשים בו, כי החיוב החוזר נמצא רק שם.

חיבור

ב-Braintree Control Panel, לפתוח את Settings › API וליצור זוג מפתחות API חדש.
להעתיק את ה-Merchant ID, ה-Public key וה-Private key. משתמש ה-API שאליו הם שייכים צריך תפקיד שיכול לקרוא עסקאות ומנויים.
למלא אותם, להזין production (או sandbox לחשבון sandbox) תחת סביבה, ולבחור חיבור Braintree.

Braintree חותמת על ה-webhooks שלה עם אותם מפתחות API שכבר שמורים במקור, כך שאין סוד להדביק.

ב-RevGlance, לפתוח את הגדרות › מקורות, לפתוח את התפריט של מקור ה-Braintree ולבחור Webhook. להעתיק את ה-URL.
ב-Braintree Control Panel, לפתוח את Settings › Webhooks, ליצור webhook עם ה-URL הזה ולבחור את התראות המנויים והעסקאות.

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

הסנכרון הראשון קורא כל עסקה ש-Braintree שומרת. Braintree לא מדווחת דרך ה-API שלה על עמלות עיבוד ולא על סיבות ביטול.

מכירות שנסגרו ובתהליך סגירה נספרות, לפני מס כששולחים סכומי מס. הרשאות שמעולם לא נגבו לא נספרות.
החזרים הם עסקאות הזיכוי, מתוארכים למועד שבו Braintree ביצעה אותן.
Braintree לא מדווחת על עמלות עיבוד דרך ה-API שלה, ולכן העמלות מוצגות כאפס.
ה-MRR הוא מחיר המנוי עם התוספים שלו, פחות הנחות שעדיין נותרו להן מחזורי חיוב. מנוי לא מציין לקוח, ולכן הוא מקבל את הלקוח של החיובים שלו; מנוי שעדיין אין לו חיוב מוצג תחת הכרטיס שלו.
ביטול מתוארך לפי היסטוריית הסטטוסים. מנוי שפג תוקפו מסתיים בתאריך שעד אליו שולם.
תשלום שלא ניתן היה לגבות נספר כחיוב שנכשל. לא מועבר כסף.
ביטולי עסקה לא נקראים, ולכן ביטול עסקה שהפסדת נשאר ספור כחיוב, אלא אם הספק מדווח עליו גם כהחזר.